​

Feishu-Bot

​

Gebündeltes Plugin

openclaw plugins install @openclaw/feishu

​

Schnellstart

​

Methode 1: Onboarding (empfohlen)

openclaw onboard

1. Eine Feishu-App erstellen und Zugangsdaten erfassen
2. App-Zugangsdaten in OpenClaw konfigurieren
3. Das Gateway starten

• openclaw gateway status
• openclaw logs --follow

​

Methode 2: Einrichtung per CLI

openclaw channels add

• openclaw gateway status
• openclaw gateway restart
• openclaw logs --follow

​

Schritt 1: Eine Feishu-App erstellen

​

1. Feishu Open Platform öffnen

​

2. Eine App erstellen

1. Klicken Sie auf Create enterprise app
2. Geben Sie den App-Namen und die Beschreibung ein
3. Wählen Sie ein App-Symbol

​

3. Zugangsdaten kopieren

• App ID (Format: cli_xxx)
• App Secret

​

4. Berechtigungen konfigurieren

{
  "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:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

​

5. Bot-Funktion aktivieren

1. Aktivieren Sie die Bot-Funktion
2. Legen Sie den Bot-Namen fest

​

6. Ereignisabonnement konfigurieren

1. Sie haben openclaw channels add für Feishu bereits ausgeführt
2. Das Gateway läuft (openclaw gateway status)

1. Wählen Sie Use long connection to receive events (WebSocket)
2. Fügen Sie das Ereignis im.message.receive_v1 hinzu
3. (Optional) Für Drive-Kommentar-Workflows fügen Sie außerdem drive.notice.comment_add_v1 hinzu

​

7. Die App veröffentlichen

1. Erstellen Sie eine Version unter Version Management & Release
2. Reichen Sie sie zur Prüfung ein und veröffentlichen Sie sie
3. Warten Sie auf die Admin-Genehmigung (Enterprise-Apps werden normalerweise automatisch genehmigt)

​

Schritt 2: OpenClaw konfigurieren

​

Mit dem Assistenten konfigurieren (empfohlen)

openclaw channels add

​

Über die Konfigurationsdatei konfigurieren

{
  channels: {
    feishu: {
      enabled: true,
      dmPolicy: "pairing",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "My AI assistant",
        },
      },
    },
  },
}

​

Verification Token und Encrypt Key (Webhook-Modus)

1. Öffnen Sie in der Feishu Open Platform Ihre App
2. Gehen Sie zu Development → Events & Callbacks (开发配置 → 事件与回调)
3. Öffnen Sie den Tab Encryption (加密策略)
4. Kopieren Sie Verification Token und Encrypt Key

​

Über Umgebungsvariablen konfigurieren

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

​

Lark-Domain (global)

{
  channels: {
    feishu: {
      domain: "lark",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
        },
      },
    },
  },
}

​

Flags zur Quotenoptimierung

• typingIndicator (Standard true): Wenn false, werden Aufrufe für Schreibreaktionen übersprungen.
• resolveSenderNames (Standard true): Wenn false, werden Aufrufe zur Abfrage von Senderprofilen übersprungen.

{
  channels: {
    feishu: {
      typingIndicator: false,
      resolveSenderNames: false,
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          typingIndicator: true,
          resolveSenderNames: false,
        },
      },
    },
  },
}

​

Schritt 3: Starten und testen

​

1. Das Gateway starten

openclaw gateway

​

2. Eine Testnachricht senden

​

3. Pairing genehmigen

openclaw pairing approve feishu <CODE>

​

Überblick

• Feishu-Bot-Kanal: Vom Gateway verwalteter Feishu-Bot
• Deterministisches Routing: Antworten gehen immer an Feishu zurück
• Sitzungsisolierung: DMs teilen sich eine Hauptsitzung; Gruppen sind isoliert
• WebSocket-Verbindung: Long Connection über das Feishu SDK, keine öffentliche URL erforderlich

​

Zugriffskontrolle

​

Direktnachrichten

• Standard: dmPolicy: "pairing" (unbekannte Benutzer erhalten einen Pairing-Code)
• Pairing genehmigen:
  openclaw pairing list feishu
  openclaw pairing approve feishu <CODE>
  
• Allowlist-Modus: Setzen Sie channels.feishu.allowFrom mit erlaubten Open IDs

​

Gruppenchats

• "open" = alle in Gruppen zulassen
• "allowlist" = nur groupAllowFrom zulassen
• "disabled" = Gruppennachrichten deaktivieren

• explizit true = @mention erforderlich
• explizit false = ohne Mentions antworten
• wenn nicht gesetzt und groupPolicy: "open" = Standard ist false
• wenn nicht gesetzt und groupPolicy nicht "open" ist = Standard ist true

​

Beispiele für Gruppenkonfigurationen

​

Alle Gruppen zulassen, keine @mention erforderlich (Standard für offene Gruppen)

{
  channels: {
    feishu: {
      groupPolicy: "open",
    },
  },
}

​

Alle Gruppen zulassen, aber weiterhin @mention verlangen

{
  channels: {
    feishu: {
      groupPolicy: "open",
      requireMention: true,
    },
  },
}

​

Nur bestimmte Gruppen zulassen

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Feishu-Gruppen-IDs (chat_id) sehen so aus: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

​

Einschränken, welche Absender in einer Gruppe Nachrichten senden dürfen (Absender-Allowlist)

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // Feishu-Benutzer-IDs (open_id) sehen so aus: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

​

Gruppen-/Benutzer-IDs abrufen

​

Gruppen-IDs (chat_id)

1. Starten Sie das Gateway und @mentionen Sie den Bot in der Gruppe
2. Führen Sie openclaw logs --follow aus und suchen Sie nach chat_id

​

Benutzer-IDs (open_id)

1. Starten Sie das Gateway und senden Sie dem Bot eine DM
2. Führen Sie openclaw logs --follow aus und suchen Sie nach open_id

openclaw pairing list feishu

​

Häufige Befehle

Hinweis: Feishu unterstützt derzeit keine nativen Befehlsmenüs, daher müssen Befehle als Text gesendet werden.

​

Gateway-Verwaltungsbefehle

​

Fehlerbehebung

​

Bot antwortet nicht in Gruppenchats

1. Stellen Sie sicher, dass der Bot zur Gruppe hinzugefügt wurde
2. Stellen Sie sicher, dass Sie den Bot @mentionen (Standardverhalten)
3. Prüfen Sie, ob groupPolicy nicht auf "disabled" gesetzt ist
4. Prüfen Sie die Protokolle: openclaw logs --follow

​

Bot empfängt keine Nachrichten

1. Stellen Sie sicher, dass die App veröffentlicht und genehmigt ist
2. Stellen Sie sicher, dass das Ereignisabonnement im.message.receive_v1 enthält
3. Stellen Sie sicher, dass long connection aktiviert ist
4. Stellen Sie sicher, dass die App-Berechtigungen vollständig sind
5. Stellen Sie sicher, dass das Gateway läuft: openclaw gateway status
6. Prüfen Sie die Protokolle: openclaw logs --follow

​

App-Secret offengelegt

1. Setzen Sie das App Secret in der Feishu Open Platform zurück
2. Aktualisieren Sie das App Secret in Ihrer Konfiguration
3. Starten Sie das Gateway neu

​

Fehler beim Senden von Nachrichten

1. Stellen Sie sicher, dass die App die Berechtigung im:message:send_as_bot hat
2. Stellen Sie sicher, dass die App veröffentlicht ist
3. Prüfen Sie die Protokolle auf detaillierte Fehler

​

Erweiterte Konfiguration

​

Mehrere Konten

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "Primary bot",
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          name: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

​

Nachrichtenlimits

• textChunkLimit: Größe von Textabschnitten für ausgehende Nachrichten (Standard: 2000 Zeichen)
• mediaMaxMb: Limit für Upload/Download von Medien (Standard: 30MB)

​

Streaming

{
  channels: {
    feishu: {
      streaming: true, // Streaming-Kartenausgabe aktivieren (Standard true)
      blockStreaming: true, // Streaming auf Blockebene aktivieren (Standard true)
    },
  },
}

​

ACP-Sitzungen

• DMs
• Gruppen-Topic-Konversationen

​

Persistente ACP-Bindings

{
  agents: {
    list: [
      {
        id: "codex",
        runtime: {
          type: "acp",
          acp: {
            agent: "codex",
            backend: "acpx",
            mode: "persistent",
            cwd: "/workspace/openclaw",
          },
        },
      },
    ],
  },
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "feishu",
        accountId: "default",
        peer: { kind: "direct", id: "ou_1234567890" },
      },
    },
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "feishu",
        accountId: "default",
        peer: { kind: "group", id: "oc_group_chat:topic:om_topic_root" },
      },
      acp: { label: "codex-feishu-topic" },
    },
  ],
}

​

Thread-gebundener ACP-Spawn aus dem Chat

/acp spawn codex --thread here

• --thread here funktioniert für DMs und Feishu-Topics.
• Nachfolgende Nachrichten in der gebundenen DM/im gebundenen Topic werden direkt an diese ACP-Sitzung weitergeleitet.
• v1 zielt nicht auf allgemeine Gruppenchats ohne Topic ab.

​

Multi-Agent-Routing

{
  agents: {
    list: [
      { id: "main" },
      {
        id: "clawd-fan",
        workspace: "/home/user/clawd-fan",
        agentDir: "/home/user/.openclaw/agents/clawd-fan/agent",
      },
      {
        id: "clawd-xi",
        workspace: "/home/user/clawd-xi",
        agentDir: "/home/user/.openclaw/agents/clawd-xi/agent",
      },
    ],
  },
  bindings: [
    {
      agentId: "main",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_xxx" },
      },
    },
    {
      agentId: "clawd-fan",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_yyy" },
      },
    },
    {
      agentId: "clawd-xi",
      match: {
        channel: "feishu",
        peer: { kind: "group", id: "oc_zzz" },
      },
    },
  ],
}

• match.channel: "feishu"
• match.peer.kind: "direct" oder "group"
• match.peer.id: Benutzer-Open-ID (ou_xxx) oder Gruppen-ID (oc_xxx)

​

Konfigurationsreferenz

​

dmPolicy-Referenz

​

Unterstützte Nachrichtentypen

​

Empfangen

• ✅ Text
• ✅ Rich Text (Post)
• ✅ Bilder
• ✅ Dateien
• ✅ Audio
• ✅ Video/Medien
• ✅ Sticker

​

Senden

• ✅ Text
• ✅ Bilder
• ✅ Dateien
• ✅ Audio
• ✅ Video/Medien
• ✅ Interaktive Karten
• ⚠️ Rich Text (Formatierung im Post-Stil und Karten, nicht beliebige Feishu-Autorenfunktionen)

​

Threads und Antworten

• ✅ Inline-Antworten
• ✅ Topic-Thread-Antworten, wenn Feishu reply_in_thread bereitstellt
• ✅ Medienantworten bleiben threadbewusst, wenn auf eine Thread-/Topic-Nachricht geantwortet wird

​

Drive-Kommentare

• Abonnieren Sie drive.notice.comment_add_v1 in den Ereignisabonnement-Einstellungen Ihrer Feishu-App (zusammen mit dem vorhandenen im.message.receive_v1)
• Das Drive-Tool ist standardmäßig aktiviert; deaktivieren Sie es mit channels.feishu.tools.drive: false

• den Kommentartext und den Absender
• Dokumentmetadaten (Titel, Typ, URL)
• den Kontext des Kommentar-Threads für Antworten im Thread

​

Runtime-Aktionsoberfläche

• send
• read
• edit
• thread-reply
• pin
• list-pins
• unpin
• member-info
• channel-info
• channel-list
• react und reactions, wenn Reaktionen in der Konfiguration aktiviert sind
• feishu_drive-Kommentaraktionen: list_comments, list_comment_replies, add_comment, reply_comment

​

Verwandt

• Channels Overview — alle unterstützten Kanäle
• Pairing — DM-Authentifizierung und Pairing-Ablauf
• Groups — Verhalten in Gruppenchats und Mention-Gating
• Channel Routing — Sitzungsrouting für Nachrichten
• Security — Zugriffsmodell und Härtung