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.

​

Démarrage rapide

openclaw channels login --channel feishu

openclaw gateway restart

​

Contrôle d’accès

​

Messages directs

• "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

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Discussions de groupe

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

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

​

ID utilisateur (open_id, format : ou_xxx)

openclaw logs --follow

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

​

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

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

​

Optimisation des quotas

• 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

​

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

/acp spawn codex --thread here

​

Routage multi-agent

{
  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" (message direct) ou "group" (discussion de groupe)
• match.peer.id : Open ID utilisateur (ou_xxx) ou ID de groupe (oc_xxx)

​

Référence de configuration

​

Types de messages pris en charge

​

Réception

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

​

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)

​

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

​

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