Feishu

Feishu/Lark est une plateforme de collaboration tout-en-un où les équipes discutent, partagent des documents, gèrent des calendriers et travaillent ensemble.

Statut : prêt pour la production pour les messages directs du bot et les discussions de groupe. WebSocket est le mode par défaut ; le mode webhook est facultatif.

Démarrage rapide

openclaw channels login --channel feishu

openclaw gateway restart

Contrôle d’accès

Messages directs

Configurez dmPolicy pour contrôler qui peut envoyer un message direct au bot :

• "pairing" - les utilisateurs inconnus reçoivent un code d’appairage ; approuvez via la CLI
• "allowlist" - seuls les utilisateurs listés dans allowFrom peuvent discuter (par défaut : propriétaire du bot uniquement)
• "open" - autorise les messages directs publics uniquement lorsque allowFrom inclut "*" ; avec des entrées restrictives, seuls les utilisateurs correspondants peuvent discuter
• "disabled" - désactive tous les messages directs

Approuver une demande d’appairage :

openclaw pairing list feishuopenclaw pairing approve feishu <CODE>

Discussions de groupe

Politique de groupe (channels.feishu.groupPolicy) :

Par défaut : allowlist

Mention requise (channels.feishu.requireMention) :

• true - exiger une @mention (par défaut)
• false - répondre sans @mention
• Remplacement par groupe : channels.feishu.groups.<chat_id>.requireMention
• Les @all et @_all de diffusion uniquement ne sont pas traités comme des mentions du bot. Un message qui mentionne à la fois @all et directement le bot compte toujours comme une mention du bot.

Exemples de configuration de groupe

Autoriser tous les groupes, sans @mention requise

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

Autoriser tous les groupes, en exigeant toujours une @mention

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

Autoriser uniquement des groupes précis

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

En mode allowlist, vous pouvez aussi admettre un groupe en ajoutant une entrée explicite groups.<chat_id>. Les entrées explicites ne remplacent pas groupPolicy: "disabled". Les valeurs par défaut génériques sous groups.* configurent les groupes correspondants, mais ne les admettent pas à elles seules.

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

Restreindre les expéditeurs au sein d’un groupe

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

Obtenir les ID de groupe/utilisateur

ID de groupe (chat_id, format : oc_xxx)

Ouvrez le groupe dans Feishu/Lark, cliquez sur l’icône de menu dans l’angle supérieur droit, puis allez dans Settings. L’ID du groupe (chat_id) est listé sur la page des paramètres.

ID utilisateur (open_id, format : ou_xxx)

Démarrez le Gateway, envoyez un message direct au bot, puis consultez les journaux :

openclaw logs --follow

Recherchez open_id dans la sortie du journal. Vous pouvez aussi consulter les demandes d’appairage en attente :

openclaw pairing list feishu

Commandes courantes

Dépannage

Le bot ne répond pas dans les discussions de groupe

1. Assurez-vous que le bot est ajouté au groupe
2. Assurez-vous de @mentionner le bot (requis par défaut)
3. Vérifiez que groupPolicy n’est pas "disabled"
4. Consultez les journaux : openclaw logs --follow

Le bot ne reçoit pas les messages

1. Assurez-vous que le bot est publié et approuvé dans Feishu Open Platform / Lark Developer
2. Assurez-vous que l’abonnement aux événements inclut im.message.receive_v1
3. Assurez-vous que la connexion persistante (WebSocket) est sélectionnée
4. Assurez-vous que toutes les portées d’autorisation requises sont accordées
5. Assurez-vous que le Gateway est en cours d’exécution : openclaw gateway status
6. Consultez les journaux : openclaw logs --follow

La configuration par QR ne réagit pas dans l’application mobile Feishu

1. Relancez la configuration : openclaw channels login --channel feishu
2. Choisissez la configuration manuelle
3. Dans Feishu Open Platform, créez une application auto-construite et copiez son App ID et son App Secret
4. Collez ces identifiants dans l’assistant de configuration

App Secret divulgué

1. Réinitialisez l’App Secret dans Feishu Open Platform / Lark Developer
2. Mettez à jour la valeur dans votre configuration
3. Redémarrez le Gateway : openclaw gateway restart

Configuration avancée

Plusieurs comptes

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

defaultAccount contrôle quel compte est utilisé lorsque les API sortantes ne spécifient pas d’accountId. accounts.<id>.tts utilise la même forme que messages.tts et fusionne en profondeur par-dessus la configuration TTS globale, afin que les configurations Feishu à plusieurs bots puissent conserver les identifiants de fournisseur partagés globalement tout en remplaçant uniquement la voix, le modèle, la persona ou le mode automatique par compte.

Limites de message

• textChunkLimit - taille des blocs de texte sortants (par défaut : 2000 caractères)
• mediaMaxMb - limite de téléversement/téléchargement de médias (par défaut : 30 Mo)

Streaming

Feishu/Lark prend en charge les réponses en streaming via des cartes interactives. Lorsqu’il est activé, le bot met à jour la carte en temps réel pendant qu’il génère le texte.

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

Définissez streaming: false pour envoyer la réponse complète dans un seul message. blockStreaming est désactivé par défaut ; activez-le uniquement lorsque vous voulez vider les blocs assistant terminés avant la réponse finale.

Optimisation des quotas

Réduisez le nombre d’appels à l’API Feishu/Lark avec deux indicateurs facultatifs :

• typingIndicator (true par défaut) : définissez false pour ignorer les appels de réaction de saisie
• resolveSenderNames (true par défaut) : définissez false pour ignorer les recherches de profil d’expéditeur

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

Sessions ACP

Feishu/Lark prend en charge ACP pour les messages directs et les messages de fil de groupe. ACP Feishu/Lark est piloté par commandes texte ; il n’y a pas de menus natifs de commandes slash, utilisez donc les messages /acp ... directement dans la conversation.

Liaison ACP persistante

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

Lancer ACP depuis une discussion

Dans un message direct ou un fil Feishu/Lark :

/acp spawn codex --thread here

--thread here fonctionne pour les messages directs et les messages de fil Feishu/Lark. Les messages de suivi dans la conversation liée sont acheminés directement vers cette session ACP.

Routage multi-agent

Utilisez bindings pour acheminer les messages directs ou les groupes Feishu/Lark vers différents 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" },      },    },  ],}

Champs de routage :

• match.channel : "feishu"
• match.peer.kind : "direct" (message direct) ou "group" (discussion de groupe)
• match.peer.id : Open ID utilisateur (ou_xxx) ou ID de groupe (oc_xxx)

Consultez Obtenir les ID de groupe/utilisateur pour des conseils de recherche.

Référence de configuration

Configuration complète : Configuration du Gateway

Types de messages pris en charge

Réception

• ✅ Texte
• ✅ Texte enrichi (post)
• ✅ Images
• ✅ Fichiers
• ✅ Audio
• ✅ Vidéo/média
• ✅ Autocollants

Les messages audio Feishu/Lark entrants sont normalisés sous forme de marqueurs d’emplacement média plutôt que de JSON file_key brut. Lorsque tools.media.audio est configuré, OpenClaw télécharge la ressource de note vocale et exécute la transcription audio partagée avant le tour de l’agent, de sorte que l’agent reçoit la transcription orale. Si Feishu inclut directement le texte de transcription dans la charge utile audio, ce texte est utilisé sans autre appel ASR. Sans fournisseur de transcription audio, l’agent reçoit quand même un marqueur d’emplacement <media:audio> ainsi que la pièce jointe enregistrée, et non la charge utile brute de la ressource Feishu.

Envoi

• ✅ Texte
• ✅ Images
• ✅ Fichiers
• ✅ Audio
• ✅ Vidéo/média
• ✅ Cartes interactives (y compris les mises à jour en streaming)
• ⚠️ Texte enrichi (mise en forme de style post ; ne prend pas en charge toutes les capacités de création Feishu/Lark)

Les bulles audio natives Feishu/Lark utilisent le type de message Feishu audio et nécessitent des médias téléversés Ogg/Opus (file_type: "opus"). Les médias .opus et .ogg existants sont envoyés directement comme audio natif. Les formats MP3/WAV/M4A et autres formats probablement audio sont transcodés en Ogg/Opus 48 kHz avec ffmpeg uniquement lorsque la réponse demande une livraison vocale (audioAsVoice / outil de message asVoice, y compris les réponses de notes vocales TTS). Les pièces jointes MP3 ordinaires restent des fichiers classiques. Si ffmpeg est absent ou si la conversion échoue, OpenClaw se rabat sur une pièce jointe de fichier et consigne la raison.

Fils et réponses

• ✅ Réponses intégrées
• ✅ Réponses dans les fils
• ✅ Les réponses média restent conscientes du fil lors de la réponse à un message de fil

Pour groupSessionScope: "group_topic" et "group_topic_sender", les groupes de sujets natifs Feishu/Lark utilisent l’événement thread_id (omt_*) comme clé de session de sujet canonique. Si un événement natif de démarrage de sujet omet thread_id, OpenClaw l’hydrate depuis Feishu avant de router le tour. Les réponses de groupe normales qu’OpenClaw transforme en fils continuent d’utiliser l’ID du message racine de réponse (om_*) afin que le premier tour et le tour de suivi restent dans la même session.

Connexe

• Vue d’ensemble des canaux - tous les canaux pris en charge
• Appairage - authentification par messages directs et flux d’appairage
• Groupes - comportement des discussions de groupe et filtrage par mention
• Routage des canaux - routage de session pour les messages
• Sécurité - modèle d’accès et renforcement