Feishu

​

Snelstart

openclaw channels login --channel feishu

openclaw gateway restart

​

Toegangsbeheer

​

Directe berichten

• "pairing" - onbekende gebruikers ontvangen een koppelingscode; keur goed via de CLI
• "allowlist" - alleen gebruikers die in allowFrom staan kunnen chatten
• "open" - sta openbare DM’s alleen toe wanneer allowFrom "*" bevat; met beperkende vermeldingen kunnen alleen overeenkomende gebruikers chatten

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Groepschats

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

​

Voorbeelden van groepsconfiguratie

​

Alle groepen toestaan, geen @mention vereist

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

​

Alle groepen toestaan, nog steeds @mention 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

​

Veelgebruikte opdrachten

​

Probleemoplossing

​

Bot reageert niet in groepschats

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

​

Bot ontvangt geen berichten

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

​

QR-configuratie reageert niet in de mobiele Feishu-app

1. Voer de configuratie opnieuw uit: openclaw channels login --channel feishu
2. Kies handmatige configuratie
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. Herstart de Gateway: 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 aanroepen voor typreacties over te slaan
• resolveSenderNames (standaard true): stel in op false om het opzoeken van afzenderprofielen 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 vanuit chat starten

/acp spawn codex --thread here

​

Multi-agentroutering

{
  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: gebruikers-Open ID (ou_xxx) of groeps-ID (oc_xxx)

​

Agentisolatie per gebruiker (Dynamic Agent Creation)

• Onafhankelijke werkruimtemap
• Afzonderlijke USER.md / SOUL.md / MEMORY.md
• Privégespreksgeschiedenis
• Geïsoleerde skills en status

​

Snelle configuratie

{
  channels: {
    feishu: {
      dmPolicy: "open",
      allowFrom: ["*"],
      dynamicAgentCreation: {
        enabled: true,
        workspaceTemplate: "~/.openclaw/workspace-{agentId}",
        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",
      },
    },
  },
  session: {
    // Critical: makes each user's DM their "main session"
    // Automatically loads USER.md / SOUL.md / MEMORY.md
    // For stronger isolation, use "per-channel-peer" instead
    dmScope: "main",
  },
}

​

Hoe het werkt

1. Het kanaal genereert een unieke agentId: feishu-{user_open_id} voor het standaardaccount, of een begrensde identiteitsdigest met accountprefix voor een benoemd account
2. Maakt een nieuwe werkruimte aan op het workspaceTemplate-pad
3. Registreert de agent en maakt een binding voor deze gebruiker
4. De werkruimtehelper zorgt bij eerste toegang voor bootstrapbestanden (AGENTS.md, SOUL.md, USER.md, enz.)
5. Routeert alle toekomstige berichten van deze gebruiker naar hun toegewezen agent

​

Configuratieopties

• {agentId} - de gegenereerde agent-ID (bijv. feishu-ou_xxxxxx of feishu-support-<identity_digest>)
• {userId} - de Feishu open_id van de afzender (bijv. ou_xxxxxx)

​

Sessiebereik

{
  session: {
    // Voor persoonlijke bots voor één gebruiker: schakelt automatisch laden bij bootstrap in
    dmScope: "main",

    // Voor publieke multi-user bots: sterkere isolatie
    // dmScope: "per-channel-peer",
  },
}

​

Typische multi-user implementatie

{
  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: {
    // Kies dmScope op basis van je isolatiebehoeften:
    // "main" voor automatisch laden bij bootstrap, "per-channel-peer" voor sterkere isolatie
    dmScope: "main",
  },
  bindings: [], // Leeg - dynamische agents koppelen automatisch
}

​

Verificatie

feishu: creating dynamic agent "feishu-ou_xxxxxx" for user ou_xxxxxx
workspace: /Users/you/.openclaw/workspace-feishu-ou_xxxxxx
feishu: dynamic agent created, new route: agent:feishu-ou_xxxxxx:main

ls -la ~/.openclaw/workspace-*

​

Opmerkingen

• Werkruimte-isolatie: Elke gebruiker krijgt een eigen werkruimtedirectory en agentinstantie. Gebruikers kunnen elkaars gespreksgeschiedenis of bestanden binnen de normale berichtstroom niet zien.
• Beveiligingsgrens: Dit is een isolatiemechanisme voor berichtcontexten, geen beveiligingsgrens voor vijandige co-tenants. Het agentproces en de hostomgeving worden gedeeld.
• bindings moet leeg zijn: Dynamische agents registreren automatisch hun eigen koppelingen
• Upgradepad: Bestaande handmatige koppelingen blijven naast dynamische agents werken
• session.dmScope is globaal: Dit beïnvloedt alle kanalen, niet alleen Feishu

​

Configuratiereferentie

​

Ondersteunde berichttypen

​

Ontvangen

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

​

Verzenden

• ✅ Tekst
• ✅ Afbeeldingen
• ✅ Bestanden
• ✅ Audio
• ✅ Video/media
• ✅ Interactieve kaarten (inclusief streaming-updates)
• ⚠️ Rich text (opmaak in berichtstijl; ondersteunt niet de volledige Feishu/Lark-authoringmogelijkheden)

​

Threads en antwoorden

• ✅ Inline antwoorden
• ✅ Thread-antwoorden
• ✅ Media-antwoorden blijven thread-bewust bij het antwoorden op een thread-bericht

​

Gerelateerd

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