Feishu

​

Schnellstart

openclaw channels login --channel feishu

openclaw gateway restart

​

Dauerhafte Verarbeitung eingehender Ereignisse

​

Zugriffskontrolle

​

Direktnachrichten

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Gruppenchats

• Standard: Eine @Erwähnung ist erforderlich, außer wenn die effektive Gruppenrichtlinie "open" lautet; dort ist der Standardwert false, damit Nachrichten ohne mögliche Erwähnungen (beispielsweise Bilder) den Agent weiterhin erreichen.
• Legen Sie true oder false explizit fest, um dies zu überschreiben; Außerkraftsetzung pro Gruppe: channels.feishu.groups.<chat_id>.requireMention.
• Die reinen Rundfunk-Erwähnungen @all und @_all werden nicht als Bot-Erwähnungen behandelt. Eine Nachricht, die sowohl @all als auch den Bot direkt erwähnt, gilt weiterhin als Bot-Erwähnung.

​

Beispiele für die Gruppenkonfiguration

​

Alle Gruppen zulassen, keine @Erwähnung erforderlich

{
  channels: {
    feishu: {
      groupPolicy: "open", // requireMention ist unter "open" standardmäßig false
    },
  },
}

​

Alle Gruppen zulassen, weiterhin @Erwähnung verlangen

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

​

Nur bestimmte Gruppen zulassen

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Gruppen-IDs sehen folgendermaßen aus: 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: {
          // open_ids von Benutzern sehen folgendermaßen aus: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

​

Von Bots verfasste Nachrichten

{
  channels: {
    feishu: {
      allowBots: true,
    },
  },
}

​

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äufig verwendete 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 mit @ erwähnen (standardmäßig erforderlich)
3. Überprüfen Sie, dass groupPolicy nicht "disabled" lautet
4. Prüfen Sie die Protokolle: openclaw logs --follow

​

Bot empfängt keine Nachrichten

1. Stellen Sie sicher, dass der Bot in der Feishu Open Platform bzw. bei Lark Developer veröffentlicht und genehmigt wurde
2. Stellen Sie sicher, dass das Ereignisabonnement im.message.receive_v1 enthält
3. Abonnieren Sie für den automatischen Beitritt zu Besprechungseinladungen zusätzlich vc.bot.meeting_invited_v1
4. Stellen Sie sicher, dass persistent connection (WebSocket) ausgewählt ist
5. Stellen Sie sicher, dass alle erforderlichen Berechtigungsumfänge gewährt wurden
6. Stellen Sie sicher, dass der Gateway ausgeführt wird: openclaw gateway status
7. Prüfen Sie die Protokolle: openclaw logs --follow

{
  channels: {
    feishu: {
      vcAutoJoin: true,
    },
  },
}

{
  channels: {
    feishu: {
      accounts: {
        meetings: { vcAutoJoin: true },
      },
    },
  },
}

​

QR-Einrichtung reagiert in der mobilen Feishu-App nicht

1. Führen Sie die Einrichtung erneut aus: openclaw channels login --channel feishu
2. Wählen Sie die manuelle Einrichtung
3. Erstellen Sie in der Feishu Open Platform eine selbst entwickelte App und kopieren Sie deren App ID und App Secret
4. Fügen Sie diese Anmeldedaten in den Einrichtungsassistenten ein

​

App Secret wurde offengelegt

1. Setzen Sie das App Secret in der Feishu Open Platform bzw. bei Lark Developer zurück
2. Aktualisieren Sie den Wert in Ihrer Konfiguration
3. Starten Sie den Gateway neu: 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 – Segmentgröße für ausgehenden Text (Standard: 4000 Zeichen)
• streaming.chunkMode – "length" (Standard) teilt am Limit; "newline" bevorzugt Zeilenumbrüche
• mediaMaxMb – Limit für das Hoch-/Herunterladen von Medien (Standard: 30 MB)

​

Streaming

{
  channels: {
    feishu: {
      streaming: {
        mode: "partial", // Streaming-Kartenausgabe (Standard: "partial")
        block: { enabled: true }, // Streaming abgeschlossener Blöcke aktivieren
      },
    },
  },
}

​

Kontingentoptimierung

• typingIndicator (Standardwert true): Setzen Sie false, um Aufrufe für Tippreaktionen zu überspringen
• resolveSenderNames (Standardwert true): Setzen Sie false, um Abfragen von Absenderprofilen zu überspringen

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

​

Gruppensitzungsbereich und Themen-Threads

​

Feishu-Arbeitsbereichswerkzeuge

​

ACP-Sitzungen

​

Dauerhafte 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 dem Chat starten

/acp spawn codex --thread here

​

Multi-Agenten-Routing

{
  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)

​

Agentenisolation pro Benutzer (dynamische Agentenerstellung)

• Unabhängiges Arbeitsbereichsverzeichnis
• Separate USER.md / SOUL.md / MEMORY.md
• Private Unterhaltungshistorie
• Isolierte Skills und isolierter Zustand

​

Schnelle Einrichtung

{
  channels: {
    feishu: {
      dmPolicy: "open",
      allowFrom: ["*"],
      dynamicAgentCreation: {
        enabled: true,
        workspaceTemplate: "~/.openclaw/workspace-{agentId}",
        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",
      },
    },
  },
  session: {
    // Entscheidend: Macht die Direktnachricht jedes Benutzers zu seiner „Hauptsitzung“
    // Lädt automatisch USER.md / SOUL.md / MEMORY.md
    // Verwenden Sie für eine stärkere Isolation stattdessen "per-channel-peer"
    dmScope: "main",
  },
}

​

Funktionsweise

1. Der Kanal erzeugt eine eindeutige agentId: feishu-{user_open_id} für das Standardkonto oder einen begrenzten Identitäts-Digest mit Kontopräfix für ein benanntes Konto
2. Erstellt einen neuen Arbeitsbereich unter dem Pfad workspaceTemplate
3. Registriert den Agenten und erstellt eine Bindung für diesen Benutzer
4. Das Arbeitsbereichs-Hilfsprogramm stellt beim ersten Zugriff Bootstrap-Dateien (AGENTS.md, SOUL.md, USER.md usw.) bereit
5. Leitet alle zukünftigen Nachrichten dieses Benutzers an seinen dedizierten Agenten weiter

​

Konfigurationsoptionen

• {agentId} – die generierte Agenten-ID (z. B. feishu-ou_xxxxxx oder feishu-support-<identity_digest>)
• {userId} – die Feishu-open_id des Absenders (z. B. ou_xxxxxx)

​

Sitzungsbereich

​

Typische Mehrbenutzerbereitstellung

{
  channels: {
    feishu: {
      appId: "cli_xxx",
      appSecret: "xxx",
      dmPolicy: "open",
      allowFrom: ["*"],
      groupPolicy: "open",
      requireMention: true,
      dynamicAgentCreation: {
        enabled: true,
        workspaceTemplate: "~/.openclaw/workspace-{agentId}",
        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",
      },
    },
  },
  session: {
    // Wählen Sie dmScope entsprechend Ihren Isolationsanforderungen:
    // "main" für automatisches Bootstrap-Laden, "per-channel-peer" für stärkere Isolation
    dmScope: "main",
  },
  bindings: [], // Leer – dynamische Agenten werden automatisch gebunden
}

​

Überprüfung

feishu: dynamischer Agent "feishu-ou_xxxxxx" wird für Benutzer ou_xxxxxx erstellt
  Arbeitsbereich: /home/user/.openclaw/workspace-feishu-ou_xxxxxx
  Agentenverzeichnis: /home/user/.openclaw/agents/feishu-ou_xxxxxx/agent

ls -la ~/.openclaw/workspace-*

​

Hinweise

• Arbeitsbereichsisolation: Jeder Benutzer erhält ein eigenes Arbeitsbereichsverzeichnis und eine eigene Agent-Instanz. Benutzer können im normalen Nachrichtenablauf weder den Gesprächsverlauf noch die Dateien anderer Benutzer sehen.
• Sicherheitsgrenze: Dies ist ein Isolationsmechanismus für Nachrichtenkontexte, keine Sicherheitsgrenze gegenüber feindseligen Mandanten. Der Agent-Prozess und die Hostumgebung werden gemeinsam genutzt.
• Konfigurationsschreibvorgänge müssen aktiviert bleiben: Bei der dynamischen Agent-Erstellung werden Agents und Bindungen in die Konfiguration geschrieben; sie wird übersprungen, wenn channels.feishu.configWrites auf false gesetzt ist (Standard: aktiviert).
• bindings sollte leer sein: Dynamische Agents registrieren ihre eigenen Bindungen automatisch
• Upgrade-Pfad: Vorhandene manuelle Bindungen funktionieren weiterhin parallel zu dynamischen Agents
• session.dmScope gilt global: Dies betrifft alle Kanäle, nicht nur Feishu

​

Konfigurationsreferenz

​

Unterstützte Nachrichtentypen

​

Empfangen

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

​

Senden

• ✅ Text
• ✅ Bilder
• ✅ Dateien
• ✅ Audio
• ✅ Video/Medien
• ✅ Interaktive Karten (einschließlich Streaming-Aktualisierungen)
• ⚠️ Rich Text (Formatierung im Beitragsstil; unterstützt nicht alle Autorenfunktionen von Feishu/Lark)

​

Threads und Antworten

• ✅ Inline-Antworten
• ✅ Thread-Antworten
• ✅ Medienantworten berücksichtigen beim Antworten auf eine Thread-Nachricht weiterhin den Thread

​

Verwandte Themen

• Kanalübersicht - alle unterstützten Kanäle
• Kopplung - DM-Authentifizierung und Kopplungsablauf
• Gruppen - Verhalten von Gruppenchats und Erwähnungssteuerung
• Kanalrouting - Sitzungsrouting für Nachrichten
• Sicherheit - Zugriffsmodell und Absicherung