Feishu

Documentation Index

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

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

​

Snelstart

openclaw channels login --channel feishu

openclaw gateway restart

​

Toegangsbeheer

​

Directe berichten

• "pairing" - onbekende gebruikers ontvangen een koppelingscode; keur goed via CLI
• "allowlist" - alleen gebruikers die in allowFrom staan, kunnen chatten (standaard: alleen boteigenaar)
• "open" - sta openbare DM’s alleen toe wanneer allowFrom "*" bevat; met beperkende vermeldingen kunnen alleen overeenkomende gebruikers chatten
• "disabled" - schakel alle DM’s uit

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Groepschats

• true - vereis @vermelding (standaard)
• false - reageer zonder @vermelding
• Overschrijving per groep: channels.feishu.groups.<chat_id>.requireMention
• Alleen-uitzending @all en @_all worden niet behandeld als botvermeldingen. Een bericht dat zowel @all als de bot rechtstreeks vermeldt, telt nog steeds als botvermelding.

​

Voorbeelden van groepsconfiguratie

​

Alle groepen toestaan, geen @vermelding vereist

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

​

Alle groepen toestaan, nog steeds @vermelding vereisen

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

​

Alleen specifieke groepen toestaan

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

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

​

Afzenders binnen een groep beperken

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

​

Groeps-/gebruikers-ID’s ophalen

​

Groeps-ID’s (chat_id, indeling: oc_xxx)

​

Gebruikers-ID’s (open_id, indeling: ou_xxx)

openclaw logs --follow

openclaw pairing list feishu

​

Algemene opdrachten

​

Probleemoplossing

​

Bot reageert niet in groepschats

1. Zorg dat de bot aan de groep is toegevoegd
2. Zorg dat je de bot @vermeldt (standaard vereist)
3. Controleer of groupPolicy niet "disabled" is
4. Controleer logs: openclaw logs --follow

​

Bot ontvangt geen berichten

1. Zorg dat de bot is gepubliceerd en goedgekeurd in Feishu Open Platform / Lark Developer
2. Zorg dat gebeurtenisabonnement im.message.receive_v1 bevat
3. Zorg dat persistente verbinding (WebSocket) is geselecteerd
4. Zorg dat alle vereiste machtigingsscopes zijn verleend
5. Zorg dat de gateway actief is: openclaw gateway status
6. Controleer logs: openclaw logs --follow

​

QR-installatie reageert niet in de mobiele Feishu-app

1. Voer de installatie opnieuw uit: openclaw channels login --channel feishu
2. Kies handmatige installatie
3. Maak in Feishu Open Platform een zelfgebouwde app en kopieer de App ID en App Secret
4. Plak die referenties in de installatiewizard

​

App Secret gelekt

1. Reset de App Secret in Feishu Open Platform / Lark Developer
2. Werk de waarde in je configuratie bij
3. Start de gateway opnieuw op: openclaw gateway restart

​

Geavanceerde configuratie

​

Meerdere accounts

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

​

Berichtlimieten

• textChunkLimit - chunkgrootte voor uitgaande tekst (standaard: 2000 tekens)
• mediaMaxMb - limiet voor media-upload/-download (standaard: 30 MB)

​

Streaming

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

​

Quota-optimalisatie

• typingIndicator (standaard true): stel in op false om oproepen voor typreacties over te slaan
• resolveSenderNames (standaard true): stel in op false om profielopzoekingen van afzenders over te slaan

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

​

ACP-sessies

​

Persistente ACP-binding

{
  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 starten vanuit chat

/acp spawn codex --thread here

​

Routing met meerdere agents

{
  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" (DM) of "group" (groepschat)
• match.peer.id: Open ID van gebruiker (ou_xxx) of groeps-ID (oc_xxx)

​

Configuratiereferentie

​

Ondersteunde berichttypen

​

Ontvangen

• ✅ Tekst
• ✅ Rich text (post)
• ✅ Afbeeldingen
• ✅ Bestanden
• ✅ Audio
• ✅ Video/media
• ✅ Stickers

​

Verzenden

• ✅ Tekst
• ✅ Afbeeldingen
• ✅ Bestanden
• ✅ Audio
• ✅ Video/media
• ✅ Interactieve kaarten (inclusief streamingupdates)
• ⚠️ Rich text (post-stijlopmaak; ondersteunt niet de volledige Feishu/Lark-authoringmogelijkheden)

​

Threads en antwoorden

• ✅ Inline antwoorden
• ✅ Thread-antwoorden
• ✅ Media-antwoorden blijven thread-aware bij het antwoorden op een threadbericht

​

Gerelateerd

• Kanalenoverzicht - alle ondersteunde kanalen
• Koppelen - DM-authenticatie en koppelingsflow
• Groepen - groepschatgedrag en mention-gating
• Kanaalroutering - sessieroutering voor berichten
• Beveiliging - toegangsmodel en hardening