​

Bot Feishu

​

Plugin intégré

openclaw plugins install @openclaw/feishu

​

Démarrage rapide

​

Méthode 1 : onboarding (recommandé)

openclaw onboard

1. La création d’une application Feishu et la collecte des identifiants
2. La configuration des identifiants d’application dans OpenClaw
3. Le démarrage de la gateway

• openclaw gateway status
• openclaw logs --follow

​

Méthode 2 : configuration via CLI

openclaw channels add

• openclaw gateway status
• openclaw gateway restart
• openclaw logs --follow

​

Étape 1 : Créer une application Feishu

​

1. Ouvrir Feishu Open Platform

​

2. Créer une application

1. Cliquez sur Create enterprise app
2. Renseignez le nom et la description de l’application
3. Choisissez une icône d’application

​

3. Copier les identifiants

• App ID (format : cli_xxx)
• App Secret

​

4. Configurer les autorisations

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

​

5. Activer la capacité bot

1. Activez la capacité bot
2. Définissez le nom du bot

​

6. Configurer l’abonnement aux événements

1. Vous avez déjà exécuté openclaw channels add pour Feishu
2. La gateway est en cours d’exécution (openclaw gateway status)

1. Choisissez Use long connection to receive events (WebSocket)
2. Ajoutez l’événement : im.message.receive_v1
3. (Facultatif) Pour les workflows de commentaires Drive, ajoutez aussi : drive.notice.comment_add_v1

​

7. Publier l’application

1. Créez une version dans Version Management & Release
2. Soumettez-la pour révision et publiez-la
3. Attendez l’approbation de l’administrateur (les applications d’entreprise sont généralement approuvées automatiquement)

​

Étape 2 : Configurer OpenClaw

​

Configurer avec l’assistant (recommandé)

openclaw channels add

​

Configurer via le fichier de configuration

{
  channels: {
    feishu: {
      enabled: true,
      dmPolicy: "pairing",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "My AI assistant",
        },
      },
    },
  },
}

​

Verification Token et Encrypt Key (mode webhook)

1. Dans Feishu Open Platform, ouvrez votre application
2. Accédez à Development → Events & Callbacks (开发配置 → 事件与回调)
3. Ouvrez l’onglet Encryption (加密策略)
4. Copiez Verification Token et Encrypt Key

​

Configurer via des variables d’environnement

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

​

Domaine Lark (global)

{
  channels: {
    feishu: {
      domain: "lark",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
        },
      },
    },
  },
}

​

Indicateurs d’optimisation de quota

• typingIndicator (par défaut true) : lorsque false, ignore les appels de réaction de saisie.
• resolveSenderNames (par défaut true) : lorsque false, ignore les appels de recherche de profil de l’expéditeur.

{
  channels: {
    feishu: {
      typingIndicator: false,
      resolveSenderNames: false,
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          typingIndicator: true,
          resolveSenderNames: false,
        },
      },
    },
  },
}

​

Étape 3 : Démarrer + tester

​

1. Démarrer la gateway

openclaw gateway

​

2. Envoyer un message de test

​

3. Approuver l’appairage

openclaw pairing approve feishu <CODE>

​

Vue d’ensemble

• Canal bot Feishu : bot Feishu géré par la gateway
• Routage déterministe : les réponses reviennent toujours à Feishu
• Isolation des sessions : les messages directs partagent une session principale ; les groupes sont isolés
• Connexion WebSocket : connexion longue via le SDK Feishu, sans URL publique nécessaire

​

Contrôle d’accès

​

Messages directs

• Par défaut : dmPolicy: "pairing" (les utilisateurs inconnus reçoivent un code d’appairage)
• Approuver l’appairage :
  openclaw pairing list feishu
  openclaw pairing approve feishu <CODE>
  
• Mode liste d’autorisation : définissez channels.feishu.allowFrom avec les Open IDs autorisés

​

Discussions de groupe

• "open" = autoriser tout le monde dans les groupes
• "allowlist" = autoriser uniquement groupAllowFrom
• "disabled" = désactiver les messages de groupe

• true explicite = exiger une @mention
• false explicite = répondre sans mention
• non défini et groupPolicy: "open" = par défaut false
• non défini et groupPolicy n’est pas "open" = par défaut true

​

Exemples de configuration de groupe

​

Autoriser tous les groupes, sans @mention requise (par défaut pour les groupes ouverts)

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

​

Autoriser tous les groupes, mais exiger quand même une @mention

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

​

Autoriser uniquement certains groupes

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Feishu group IDs (chat_id) look like: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

​

Restreindre quels expéditeurs peuvent envoyer des messages dans un groupe (liste d’autorisation des expéditeurs)

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // Feishu user IDs (open_id) look like: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

​

Obtenir les IDs de groupe/utilisateur

​

IDs de groupe (chat_id)

1. Démarrez la gateway et faites une @mention du bot dans le groupe
2. Exécutez openclaw logs --follow et recherchez chat_id

​

IDs utilisateur (open_id)

1. Démarrez la gateway et envoyez un message direct au bot
2. Exécutez openclaw logs --follow et recherchez open_id

openclaw pairing list feishu

​

Commandes courantes

Remarque : Feishu ne prend pas encore en charge les menus de commandes natifs, les commandes doivent donc être envoyées sous forme de texte.

​

Commandes de gestion de la gateway

​

Dépannage

​

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

1. Assurez-vous que le bot a été ajouté au groupe
2. Assurez-vous de faire une @mention du bot (comportement par défaut)
3. Vérifiez que groupPolicy n’est pas défini sur "disabled"
4. Vérifiez les journaux : openclaw logs --follow

​

Le bot ne reçoit pas les messages

1. Assurez-vous que l’application est publiée et approuvée
2. Assurez-vous que l’abonnement aux événements inclut im.message.receive_v1
3. Assurez-vous que la connexion longue est activée
4. Assurez-vous que les autorisations de l’application sont complètes
5. Assurez-vous que la gateway est en cours d’exécution : openclaw gateway status
6. Vérifiez les journaux : openclaw logs --follow

​

Fuite de l’App Secret

1. Réinitialisez l’App Secret dans Feishu Open Platform
2. Mettez à jour l’App Secret dans votre configuration
3. Redémarrez la gateway

​

Échecs d’envoi de message

1. Assurez-vous que l’application dispose de l’autorisation im:message:send_as_bot
2. Assurez-vous que l’application est publiée
3. Vérifiez les journaux pour les erreurs détaillées

​

Configuration avancée

​

Plusieurs comptes

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "Primary bot",
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          name: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

​

Limites de message

• textChunkLimit : taille des segments de texte sortants (par défaut : 2000 caractères)
• mediaMaxMb : limite d’envoi/téléchargement de médias (par défaut : 30MB)

​

Streaming

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

​

Sessions ACP

• les messages directs
• les conversations de sujet de groupe

​

Liaisons ACP persistantes

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

​

Démarrage d’ACP lié à un fil depuis le chat

/acp spawn codex --thread here

• --thread here fonctionne pour les messages directs et les sujets Feishu.
• Les messages de suivi dans le message direct/sujet lié sont routés directement vers cette session ACP.
• La v1 ne cible pas les discussions de groupe génériques sans sujet.

​

Routage multi-agent

{
  agents: {
    list: [
      { id: "main" },
      {
        id: "clawd-fan",
        workspace: "/home/user/clawd-fan",
        agentDir: "/home/user/.openclaw/agents/clawd-fan/agent",
      },
      {
        id: "clawd-xi",
        workspace: "/home/user/clawd-xi",
        agentDir: "/home/user/.openclaw/agents/clawd-xi/agent",
      },
    ],
  },
  bindings: [
    {
      agentId: "main",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_xxx" },
      },
    },
    {
      agentId: "clawd-fan",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_yyy" },
      },
    },
    {
      agentId: "clawd-xi",
      match: {
        channel: "feishu",
        peer: { kind: "group", id: "oc_zzz" },
      },
    },
  ],
}

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

​

Référence de configuration

​

Référence dmPolicy

​

Types de messages pris en charge

​

Réception

• ✅ Texte
• ✅ Texte enrichi (post)
• ✅ Images
• ✅ Fichiers
• ✅ Audio
• ✅ Vidéo/médias
• ✅ Stickers

​

Envoi

• ✅ Texte
• ✅ Images
• ✅ Fichiers
• ✅ Audio
• ✅ Vidéo/médias
• ✅ Cartes interactives
• ⚠️ Texte enrichi (formatage de type post et cartes, pas les fonctionnalités de rédaction Feishu arbitraires)

​

Fils et réponses

• ✅ Réponses en ligne
• ✅ Réponses dans les fils de sujet lorsque Feishu expose reply_in_thread
• ✅ Les réponses média restent conscientes du fil lors d’une réponse à un message de fil/sujet

​

Commentaires Drive

• Abonnez-vous à drive.notice.comment_add_v1 dans les paramètres d’abonnement aux événements de votre application Feishu (en plus de im.message.receive_v1 déjà existant)
• L’outil Drive est activé par défaut ; désactivez-le avec channels.feishu.tools.drive: false

• le texte du commentaire et son expéditeur
• les métadonnées du document (titre, type, URL)
• le contexte du fil de commentaires pour les réponses dans le fil

​

Surface d’actions d’exécution

• send
• read
• edit
• thread-reply
• pin
• list-pins
• unpin
• member-info
• channel-info
• channel-list
• react et reactions lorsque les réactions sont activées dans la configuration
• actions de commentaire feishu_drive : list_comments, list_comment_replies, add_comment, reply_comment

​

Voir aussi

• Channels Overview — tous les canaux pris en charge
• Pairing — authentification DM et flux d’appairage
• Groups — comportement des discussions de groupe et filtrage par mention
• Channel Routing — routage de session pour les messages
• Security — modèle d’accès et renforcement