> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw + Feishu

> OpenClaw über Feishu (Lark) mit EvoLink.AI verbinden

## Überblick

OpenClaw ist ein Open-Source-AI-Agent-Gateway, das als Brücke zwischen Chat-Anwendungen und AI-Agenten fungiert. Über einen zentralisierten Gateway-Prozess verbindet es Chat-Plattformen wie Telegram, WhatsApp, Discord und Feishu (Lark) mit AI-Coding-Agenten und ermöglicht direkte AI-Programmierinteraktionen innerhalb von Chat-Fenstern.

Durch die Konfiguration der **EvoLink API** als benutzerdefiniertem Modellanbieter in OpenClaw und die Anbindung eines **Feishu Bot** können Sie die Claude-Modelle von EvoLink (wie **Claude 4.6 Opus**, **Claude 4.5 Sonnet**, **Claude 4.5 Haiku**) für KI-gestützte Coding-Gespräche direkt in Feishu nutzen.

Der Feishu-Kanal verwendet den **WebSocket-Langverbindungsmodus** zum Empfangen von Nachrichten — keine öffentliche URL erforderlich.

**Diese Anleitung behandelt:**

* Installation und Konfiguration des OpenClaw Gateway
* Erstellung einer Feishu-Unternehmensanwendung mit Bot-Funktionalität
* Einrichtung der EvoLink API als benutzerdefiniertem Modellanbieter
* Überprüfung der Verbindung und erste Schritte

## Systemumgebungsprüfung

Vor der Installation wird empfohlen, das Umgebungsprüfungstool auszuführen, um sicherzustellen, dass Ihr System die Anforderungen von OpenClaw erfüllt.

### Prüftool herunterladen

Laden Sie das Prüftool für Ihre Plattform von [GitHub Releases](https://github.com/suuuuuu-1/openclaw-env-checker/releases) herunter:

| Plattform             | Dateiname                      |
| --------------------- | ------------------------------ |
| Windows               | `openclaw-checker-win-x64.exe` |
| macOS (Intel)         | `openclaw-checker-macos-x64`   |
| macOS (Apple Silicon) | `openclaw-checker-macos-arm64` |
| Linux                 | `openclaw-checker-linux-x64`   |

### Prüfpunkte

Das Tool überprüft automatisch Folgendes:

* ✅ Node.js-Version (>= 22.12.0 erforderlich)
* ✅ npm verfügbar
* ✅ Git verfügbar
* ✅ Netzwerkkonnektivität (github.com, npmjs.org, evolink.ai)

<img src="https://mintcdn.com/muyutechnology/nIFIx0gxdF53THw8/images/OpenClaw-Checker/check-success.png?fit=max&auto=format&n=nIFIx0gxdF53THw8&q=85&s=46f1fdbec3263845e35158b104fa5091" alt="Erfolgreiche Prüfung" width="1778" height="1742" data-path="images/OpenClaw-Checker/check-success.png" />

Wenn die Prüfung fehlschlägt, gibt das Tool spezifische Lösungsvorschläge.

## Voraussetzungen

Stellen Sie vor der Konfiguration sicher, dass Sie Folgendes haben:

### 1. Node.js installieren

OpenClaw wird über npm installiert und erfordert Node.js 22 oder höher.

<Tabs>
  <Tab title="Windows">
    Besuchen Sie die [offizielle Node.js-Website](https://nodejs.org/de/download), laden Sie das Windows-Installationsprogramm (.msi-Datei) herunter und führen Sie es durch Doppelklick aus.

    Öffnen Sie nach der Installation PowerShell zur Überprüfung:

    ```bash theme={null}
    node --version
    npm --version
    ```

    <Note>
      Es wird empfohlen, PowerShell als Administrator auszuführen, um Berechtigungsprobleme bei der späteren Installation zu vermeiden.
    </Note>
  </Tab>

  <Tab title="macOS">
    **Methode 1: Installationsprogramm verwenden**

    Besuchen Sie die [offizielle Node.js-Website](https://nodejs.org/de/download), laden Sie das macOS-Installationsprogramm (.pkg-Datei) herunter und führen Sie es durch Doppelklick aus.

    **Methode 2: Homebrew verwenden**

    ```bash theme={null}
    brew install node
    ```

    Öffnen Sie nach der Installation das Terminal zur Überprüfung:

    ```bash theme={null}
    node --version
    npm --version
    ```

    <Note>
      Wenn Sie bei der späteren Installation auf Berechtigungsprobleme stoßen, müssen Sie möglicherweise `sudo` vor dem Befehl hinzufügen.
    </Note>
  </Tab>
</Tabs>

### 2. EvoLink API-Schlüssel erhalten

* Melden Sie sich im [EvoLink Dashboard](https://evolink.ai/dashboard) an
* Suchen Sie im Dashboard nach API Keys, klicken Sie auf die Schaltfläche 'Neuen Schlüssel erstellen' und kopieren Sie den generierten Schlüssel
* Der API-Schlüssel beginnt normalerweise mit `sk-`

### 3. Feishu-Konto vorbereiten

Sie benötigen ein Feishu-Unternehmenskonto, um Anwendungen auf der Feishu Open Platform zu erstellen.

## Schritt 1: OpenClaw installieren

Führen Sie den folgenden Befehl in Ihrem Terminal aus:

```bash theme={null}
npm install -g openclaw@latest
```

Installieren Sie das Feishu-Plugin:

```bash theme={null}
openclaw plugins install @openclaw/feishu
```

## Schritt 2: Ersteinrichtung

Führen Sie den Onboarding-Befehl aus. OpenClaw führt Sie durch die Ersteinrichtung und installiert den Hintergrunddienst:

```bash theme={null}
openclaw onboard --install-daemon
```

### 1. Installation bestätigen

Das System zeigt einen Risikohinweis an. Bestätigen Sie, um fortzufahren:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011629_241.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=fce0ba49fe04129dc943e6f63353595e" alt="Confirm Installation" width="1488" height="1420" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011629_241.png" />

### 2. Installationsmodus auswählen

Wenn Sie aufgefordert werden, einen Installationsmodus zu wählen, wählen Sie **Quickstart**:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011705_241.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=24fbf84b590649d1fc1d515d2ee50609" alt="Select Quickstart" width="1738" height="1540" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011705_241.png" />

### 3. Anbieter auswählen

Wenn Sie aufgefordert werden, einen Modellanbieter zu wählen, wählen Sie **Skip**. Wir werden EvoLink später manuell als benutzerdefinierten Anbieter konfigurieren:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011742_033.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=a4f74b3bb72312ba426ea37179232576" alt="Skip Provider Selection" width="1398" height="1272" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011742_033.png" />

### 4. Modelle auswählen

Wenn Sie aufgefordert werden, die zu aktivierenden Modelle auszuwählen, wählen Sie **All**:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011808_857.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=701f58ca7164b7830cef3bfb713d911b" alt="Select All Models" width="1380" height="1528" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011808_857.png" />

### 5. Standardmodell auswählen

Wenn Sie aufgefordert werden, ein Standardmodell zu wählen, wählen Sie **Keep current**:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011825_375.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=5ded0a9c44fd991865dbe84195862563" alt="Keep Current Model" width="1334" height="1792" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011825_375.png" />

## Schritt 3: Feishu-Anwendung erstellen

### 1. Bei der Feishu Open Platform anmelden

Besuchen Sie die [Feishu Open Platform](https://open.feishu.cn/app) und melden Sie sich mit Ihrem Feishu-Konto an.

<Note>
  Für Lark (internationale Version) verwenden Sie [https://open.larksuite.com/app](https://open.larksuite.com/app) und setzen Sie `domain: "lark"` in der Konfiguration.
</Note>

### 2. Anwendung erstellen

Klicken Sie auf **Unternehmenseigene Anwendung erstellen**, geben Sie den Anwendungsnamen und die Beschreibung ein und wählen Sie ein Symbol.

<img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/create-app.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=68f3383cc4e84f804832d50b0a619b26" alt="Create Application" width="1650" height="611" data-path="images/OpenClaw-Feishu/create-app.avif" />

### 3. Zugangsdaten abrufen

Auf der Seite **Zugangsdaten & Basisinformationen** kopieren Sie:

* **App ID** (Format: `cli_xxx`)
* **App Secret**

<Warning>
  Bewahren Sie Ihr App Secret sicher auf. Teilen Sie es nicht mit anderen.
</Warning>

<img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/get-credentials.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=8b1539f0f9fd1f382304c00aaafd4471" alt="Get Credentials" width="1650" height="728" data-path="images/OpenClaw-Feishu/get-credentials.avif" />

### 4. Berechtigungen konfigurieren

Klicken Sie auf der Seite **Berechtigungsverwaltung** auf **Stapelimport** und fügen Sie das folgende JSON ein, um alle erforderlichen Berechtigungen zu importieren:

```json theme={null}
{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}
```

<img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/configure-permissions.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=b586b4d4778a5af577cbc188cd0f196a" alt="Configure Permissions" width="1650" height="755" data-path="images/OpenClaw-Feishu/configure-permissions.avif" />

### 5. Bot-Funktionalität aktivieren

Klicken Sie in der linken Seitenleiste auf **App-Funktionen**, suchen Sie die **Bot**-Karte und schalten Sie den **Menüstatus** auf aktiviert. Nach der Aktivierung geben Sie den Bot-Namen und die Beschreibung ein — Benutzer sehen diese beim Suchen oder Chatten mit dem Bot in Feishu.

<img src="https://mintcdn.com/muyutechnology/RDciMG4Sfzhb_HtY/images/OpenClaw-Feishu/enable-bot.png?fit=max&auto=format&n=RDciMG4Sfzhb_HtY&q=85&s=4acd5043b50c2a799eff3516390e6e39" alt="Enable Bot Capability" width="2888" height="1386" data-path="images/OpenClaw-Feishu/enable-bot.png" />

### 6. Ereignisabonnements konfigurieren

<Warning>
  Stellen Sie vor der Konfiguration der Ereignisabonnements sicher, dass Sie:

  * Die Feishu-Kanalkonfiguration abgeschlossen haben (siehe Schritt 4)
  * Das Gateway läuft (prüfen Sie mit `openclaw gateway status`)
</Warning>

Auf der Seite **Ereignisabonnements**:

1. Wählen Sie **Langverbindung zum Empfangen von Ereignissen verwenden** (WebSocket-Modus)
2. Fügen Sie das Ereignis hinzu: `im.message.receive_v1` (Nachricht empfangen)

<Warning>
  Wenn das Gateway nicht läuft oder der Kanal nicht hinzugefügt wurde, kann die Langverbindungseinrichtung nicht gespeichert werden.
</Warning>

<img src="https://mintcdn.com/muyutechnology/PB79kA5Vjr8LP50j/images/OpenClaw-Feishu/event-subscription.avif?fit=max&auto=format&n=PB79kA5Vjr8LP50j&q=85&s=9cbb8f9f6d35b90981908f1bcd70b8ad" alt="Configure Event Subscriptions" width="1650" height="851" data-path="images/OpenClaw-Feishu/event-subscription.avif" />

### 7. Anwendung veröffentlichen

Gehen Sie zu **Versionsverwaltung & Veröffentlichung**, erstellen Sie eine Version, reichen Sie sie zur Überprüfung ein und veröffentlichen Sie sie. Unternehmenseigene Anwendungen werden in der Regel automatisch genehmigt.

## Schritt 4: OpenClaw konfigurieren

Die Konfiguration von OpenClaw ist zentralisiert in `~/.openclaw/openclaw.json`. Es gibt drei wichtige Konfigurationsbereiche:

* `plugins.entries.*` — Steuert, welche Plugins geladen werden
* `channels.*` — Steuert Kanalverbindungen und Kontozugangsdaten
* `models.providers.*` — Steuert Modellanbieter

### 1. Feishu-Kanal hinzufügen

<Tabs>
  <Tab title="Manuelle Konfiguration">
    Öffnen Sie `~/.openclaw/openclaw.json`:

    Aktivieren Sie das Feishu-Plugin (`plugins.entries`):

    ```json theme={null}
    "plugins": {
      "entries": {
        "feishu": {
          "enabled": true
        }
      }
    }
    ```

    Konfigurieren Sie die Feishu-Kanal-Zugangsdaten (`channels.feishu`):

    ```json theme={null}
    "channels": {
      "feishu": {
        "enabled": true,
        "dmPolicy": "pairing",
        "accounts": {
          "main": {
            "appId": "cli_xxx",
            "appSecret": "your-app-secret",
            "botName": "My AI Assistant"
          }
        }
      }
    }
    ```

    <Warning>
      Feishu-Zugangsdaten müssen unter `channels.feishu.accounts` platziert werden, NICHT unter `plugins.entries.feishu`. Eine falsche Platzierung führt zu einem `Unrecognized key`-Fehler.
    </Warning>

    Sie können auch über Umgebungsvariablen konfigurieren:

    ```bash theme={null}
    export FEISHU_APP_ID="cli_xxx"
    export FEISHU_APP_SECRET="xxx"
    ```
  </Tab>

  <Tab title="CLI-Befehl">
    Führen Sie den folgenden Befehl aus, wählen Sie Feishu und geben Sie Ihre App ID und Ihr App Secret ein, wenn Sie dazu aufgefordert werden:

    ```bash theme={null}
    openclaw channels add
    ```

    <Warning>
      Neuere Versionen von OpenClaw können Konfigurationskonflikte mit diesem Befehl haben. Eine manuelle Konfiguration wird empfohlen.
    </Warning>
  </Tab>
</Tabs>

### 2. EvoLink API konfigurieren

Suchen Sie in derselben `openclaw.json` das Feld `models` und fügen Sie EvoLink als benutzerdefinierten Modellanbieter hinzu:

```json theme={null}
"models": {
  "providers": {
    "evolink-anthropic": {
      "api": "anthropic-messages",
      "baseUrl": "https://direct.evolink.ai",
      "apiKey": "your-evolink-api-key",
      "models": [
        { "id": "claude-fable-5", "name": "Claude Fable 5" },
        { "id": "claude-opus-4-8", "name": "Claude Opus 4.8" },
        { "id": "claude-opus-4-7", "name": "Claude Opus 4.7" },
        { "id": "claude-opus-4-6", "name": "Claude Opus 4.6" },
        { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" },
        { "id": "claude-sonnet-5", "name": "Claude Sonnet 5" },
        { "id": "claude-opus-4-5-20251101", "name": "Claude Opus 4.5" },
        { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" },
        { "id": "claude-haiku-4-5-20251001", "name": "Claude Haiku 4.5" }
      ]
    },
    "evolink-google": {
      "api": "google-generative-ai",
      "baseUrl": "https://direct.evolink.ai/v1beta",
      "apiKey": "your-evolink-api-key",
      "models": [
        { "id": "gemini-3.1-flash-lite-preview", "name": "Gemini 3.1 Flash Lite" },
        { "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" },
        { "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro" },
        { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash" },
        { "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro" },
        { "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash" }
      ]
    },
    "evolink-openai": {
      "api": "openai-completions",
      "baseUrl": "https://direct.evolink.ai/v1",
      "apiKey": "your-evolink-api-key",
      "models": [
        { "id": "gpt-5.4", "name": "GPT-5.4" },
        { "id": "gpt-5.2", "name": "GPT-5.2" },
        { "id": "gpt-5.1", "name": "GPT-5.1" },
        { "id": "gpt-5.1-chat", "name": "GPT-5.1 Chat" },
        { "id": "gpt-5.1-thinking", "name": "GPT-5.1 Thinking" },
        { "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro (OpenAI SDK)" },
        { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash (OpenAI SDK)" },
        { "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro (OpenAI SDK)" },
        { "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash (OpenAI SDK)" },
        { "id": "doubao-seed-2.0-pro", "name": "Doubao Seed 2.0 Pro" },
        { "id": "doubao-seed-2.0-lite", "name": "Doubao Seed 2.0 Lite" },
        { "id": "doubao-seed-2.0-mini", "name": "Doubao Seed 2.0 Mini" },
        { "id": "doubao-seed-2.0-code", "name": "Doubao Seed 2.0 Code" },
        { "id": "kimi-k2-thinking", "name": "Kimi K2 Thinking" },
        { "id": "kimi-k2-thinking-turbo", "name": "Kimi K2 Thinking Turbo" }
      ]
    }
  }
}
```

<Warning>
  Ersetzen Sie `"your-evolink-api-key"` durch den tatsächlichen API-Schlüssel aus Ihrem [EvoLink Dashboard](https://evolink.ai/dashboard).
</Warning>

### 3. Standardmodell konfigurieren

Setzen Sie im Feld `agents` das Standardmodell:

```json theme={null}
"model": {
  "primary": "evolink-anthropic/claude-opus-4-6"
}
```

### 4. Gateway neu starten

Starten Sie das OpenClaw Gateway neu, um die Konfiguration zu übernehmen:

```bash theme={null}
openclaw gateway restart
```

<Warning>
  Verwenden Sie immer `openclaw gateway restart` anstatt manuell einen weiteren Prozess zu starten, da Sie sonst einen Portkonflikt-Fehler erhalten.
</Warning>

Überprüfen Sie, ob die Konfiguration korrekt geladen wurde:

```bash theme={null}
openclaw gateway status
```

## Schritt 5: Verbindung überprüfen

### 1. Bot in Feishu finden

Öffnen Sie Feishu, suchen Sie nach dem von Ihnen erstellten Bot-Namen und starten Sie eine Unterhaltung.

### 2. Pairing-Code erhalten

Senden Sie eine beliebige Nachricht an den Bot. Er wird einen Pairing-Code zurückgeben.

### 3. Pairing abschließen

Öffnen Sie ein neues Terminalfenster und führen Sie aus:

```bash theme={null}
openclaw pairing approve feishu <pairing-code>
```

<Warning>
  Ersetzen Sie `<pairing-code>` durch den tatsächlichen Code, den der Bot zurückgegeben hat. Achten Sie darauf, die spitzen Klammern `<>` zu entfernen.
</Warning>

### 4. Verbindung testen

Senden Sie nach Abschluss des Pairings eine Nachricht an den Bot in Feishu:

```
Hallo, bitte stell dich vor
```

Wenn Sie eine KI-Antwort erhalten, ist die Integration abgeschlossen.

## Zugriffskontrolle

### Direktnachrichten-Zugriff

Standard `dmPolicy: "pairing"` — unbekannte Benutzer erhalten einen Pairing-Code, der von einem Administrator genehmigt werden muss:

```bash theme={null}
openclaw pairing list feishu        # Ausstehende Genehmigungen anzeigen
openclaw pairing approve feishu <CODE>  # Genehmigen
```

Sie können auch eine Erlaubnisliste von Benutzer-Open-IDs über `channels.feishu.allowFrom` konfigurieren.

### Gruppenzugriff

Die Gruppenrichtlinie wird über `channels.feishu.groupPolicy` gesteuert:

* `"open"` — Alle Benutzer in der Gruppe zulassen (Standard)
* `"allowlist"` — Nur Benutzer in `groupAllowFrom` zulassen
* `"disabled"` — Gruppennachrichten deaktivieren

Standardmäßig antwortet der Bot nur, wenn er @erwähnt wird (`requireMention: true`).

## Häufige Befehle

| Befehl                         | Beschreibung                          |
| ------------------------------ | ------------------------------------- |
| `openclaw gateway status`      | Gateway-Status prüfen                 |
| `openclaw gateway restart`     | Gateway-Dienst neu starten            |
| `openclaw logs --follow`       | Echtzeit-Logs anzeigen                |
| `openclaw pairing list feishu` | Ausstehende Pairing-Anfragen anzeigen |
| `openclaw plugins list`        | Installierte Plugins anzeigen         |

## Fehlerbehebung

| Problem                                  | Lösung                                                                                                                                                                                                                    |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Bot antwortet nicht in Gruppen           | Prüfen Sie, ob Sie den Bot @erwähnt haben; prüfen Sie, ob `groupPolicy` auf `"disabled"` gesetzt ist                                                                                                                      |
| Bot empfängt keine Nachrichten           | Prüfen Sie, ob die App veröffentlicht und genehmigt ist; stellen Sie sicher, dass das Ereignisabonnement `im.message.receive_v1` konfiguriert ist; bestätigen Sie, dass der WebSocket-Langverbindungsmodus ausgewählt ist |
| App Secret kompromittiert                | Setzen Sie das App Secret auf der Feishu Open Platform zurück, aktualisieren Sie die Konfiguration, starten Sie das Gateway neu                                                                                           |
| Nachrichten können nicht gesendet werden | Prüfen Sie, ob die Berechtigung `im:message:send_as_bot` erteilt ist; prüfen Sie die Logs mit `openclaw logs --follow`                                                                                                    |