Feishu

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Schnellstart

openclaw channels login --channel feishu

openclaw gateway restart

​

Zugriffskontrolle

​

Direktnachrichten

• "pairing" - unbekannte Benutzer erhalten einen Kopplungscode; Genehmigung über die CLI
• "allowlist" - nur in allowFrom aufgeführte Benutzer können chatten (Standard: nur Bot-Besitzer)
• "open" - öffentliche Direktnachrichten nur zulassen, wenn allowFrom "*" enthält; bei restriktiven Einträgen können nur passende Benutzer chatten
• "disabled" - alle Direktnachrichten deaktivieren

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Gruppenchats

• true - @Erwähnung erforderlich (Standard)
• false - ohne @Erwähnung antworten
• Überschreibung pro Gruppe: channels.feishu.groups.<chat_id>.requireMention
• Reine Broadcast-Erwähnungen @all und @_all werden nicht als Bot-Erwähnungen behandelt. Eine Nachricht, die sowohl @all als auch den Bot direkt erwähnt, zählt weiterhin als Bot-Erwähnung.

​

Beispiele für Gruppenkonfiguration

​

Alle Gruppen zulassen, keine @Erwähnung erforderlich

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

​

Alle Gruppen zulassen, @Erwähnung weiterhin erforderlich

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

​

Nur bestimmte Gruppen zulassen

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Group IDs look like: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groups: {
        oc_xxx: {
          requireMention: false,
        },
      },
    },
  },
}

​

Absender innerhalb einer Gruppe einschränken

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // User open_ids look like: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

​

Gruppen-/Benutzer-IDs abrufen

​

Gruppen-IDs (chat_id, Format: oc_xxx)

​

Benutzer-IDs (open_id, Format: ou_xxx)

openclaw logs --follow

openclaw pairing list feishu

​

Häufige Befehle

​

Fehlerbehebung

​

Bot antwortet nicht in Gruppenchats

1. Stellen Sie sicher, dass der Bot der Gruppe hinzugefügt wurde
2. Stellen Sie sicher, dass Sie den Bot @erwähnen (standardmäßig erforderlich)
3. Prüfen Sie, dass groupPolicy nicht "disabled" ist
4. Logs prüfen: openclaw logs --follow

​

Bot empfängt keine Nachrichten

1. Stellen Sie sicher, dass der Bot in Feishu Open Platform / Lark Developer veröffentlicht und genehmigt ist
2. Stellen Sie sicher, dass das Ereignisabonnement im.message.receive_v1 enthält
3. Stellen Sie sicher, dass persistente Verbindung (WebSocket) ausgewählt ist
4. Stellen Sie sicher, dass alle erforderlichen Berechtigungsbereiche gewährt sind
5. Stellen Sie sicher, dass der Gateway läuft: openclaw gateway status
6. Logs prüfen: openclaw logs --follow

​

QR-Einrichtung reagiert in der Feishu-Mobile-App nicht

1. Einrichtung erneut ausführen: openclaw channels login --channel feishu
2. Manuelle Einrichtung wählen
3. Erstellen Sie in der Feishu Open Platform eine selbst erstellte App und kopieren Sie ihre App ID und ihr App Secret
4. Fügen Sie diese Zugangsdaten in den Einrichtungsassistenten ein

​

App Secret offengelegt

1. Setzen Sie das App Secret in Feishu Open Platform / Lark Developer zurück
2. Aktualisieren Sie den Wert in Ihrer Konfiguration
3. Gateway neu starten: openclaw gateway restart

​

Erweiterte Konfiguration

​

Mehrere Konten

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

​

Nachrichtenlimits

• textChunkLimit - Größe ausgehender Textblöcke (Standard: 2000 Zeichen)
• mediaMaxMb - Limit für Medien-Uploads/-Downloads (Standard: 30 MB)

​

Streaming

{
  channels: {
    feishu: {
      streaming: true, // enable streaming card output (default: true)
      blockStreaming: true, // opt into completed-block streaming
    },
  },
}

​

Quotenoptimierung

• typingIndicator (Standard true): auf false setzen, um Aufrufe für Tippreaktionen zu überspringen
• resolveSenderNames (Standard true): auf false setzen, um Abfragen von Absenderprofilen zu überspringen

{
  channels: {
    feishu: {
      typingIndicator: false,
      resolveSenderNames: false,
    },
  },
}

​

ACP-Sitzungen

​

Persistente ACP-Bindung

{
  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" },
    },
  ],
}

​

ACP aus Chat starten

/acp spawn codex --thread here

​

Routing für mehrere Agenten

{
  agents: {
    list: [
      { id: "main" },
      { id: "agent-a", workspace: "/home/user/agent-a" },
      { id: "agent-b", workspace: "/home/user/agent-b" },
    ],
  },
  bindings: [
    {
      agentId: "agent-a",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_xxx" },
      },
    },
    {
      agentId: "agent-b",
      match: {
        channel: "feishu",
        peer: { kind: "group", id: "oc_zzz" },
      },
    },
  ],
}

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

​

Konfigurationsreferenz

​

Unterstützte Nachrichtentypen

​

Empfangen

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

​

Senden

• ✅ Text
• ✅ Bilder
• ✅ Dateien
• ✅ Audio
• ✅ Video/Medien
• ✅ Interaktive Karten (einschließlich Streaming-Updates)
• ⚠️ Rich Text (Post-Formatierung; unterstützt nicht den vollständigen Funktionsumfang zur Feishu/Lark-Erstellung)

​

Threads und Antworten

• ✅ Inline-Antworten
• ✅ Thread-Antworten
• ✅ Medienantworten bleiben Thread-bewusst, wenn auf eine Thread-Nachricht geantwortet wird

​

Verwandte Themen

• Kanalübersicht - alle unterstützten Kanäle
• Kopplung - DM-Authentifizierung und Kopplungsablauf
• Gruppen - Gruppenchatverhalten und Mention-Gating
• Kanal-Routing - Sitzungsrouting für Nachrichten
• Sicherheit - Zugriffsmodell und Härtung