Canal Feishu / Lark OpenClaw
Connectez OpenClaw à Feishu (飞书) ou Lark via un abonnement aux événements basé sur WebSocket. Cette intégration entreprise permet à votre assistant IA de gérer les messages directs et les discussions de groupe sur Feishu/Lark — la plateforme de collaboration d'entreprise leader de ByteDance. OpenClaw se connecte via le mode longue connexion (WebSocket) de la plateforme ouverte Feishu, aucune URL publique ni endpoint Webhook n'est nécessaire. Créez simplement une application Feishu, entrez votre App ID et App Secret, et votre assistant est opérationnel.
Feishu / Lark Fonctionnalités prises en charge
Messages texte
Pris en charge
Médias et fichiers
Pris en charge
Réactions
Non pris en charge
Fils de discussion
Non pris en charge
Messages vocaux
Non pris en charge
Discussion de groupe
Pris en charge
Feishu / Lark Prérequis
- Un compte tenant Feishu (feishu.cn) ou Lark (larksuite.com) avec droits de création d'applications
- Le plugin Feishu installé : openclaw plugins install @openclaw/feishu
- OpenClaw Gateway en cours d'exécution et configuré
- Node.js 18+ installé sur votre serveur
Feishu / Lark Configuration rapide
Créer une application Feishu/Lark
Rendez-vous sur la plateforme ouverte Feishu (open.feishu.cn/app) ou la console développeur Lark (open.larksuite.com/app). Créez une nouvelle application d'entreprise, définissez le nom, la description et l'icône. Copiez l'App ID (format : cli_xxx) et l'App Secret depuis la page des identifiants.
Configurer les permissions et la capacité bot
Dans la gestion des permissions de l'application, importez en lot les permissions requises. Activez la capacité bot sous Capacités de l'app > Bot. Dans l'abonnement aux événements, sélectionnez « Utiliser la longue connexion » (mode WebSocket) et ajoutez l'événement im.message.receive_v1. Publiez l'application via Gestion des versions et Publication.
Ajouter la configuration du canal Feishu à OpenClaw
Exécutez 'openclaw channels add' et sélectionnez Feishu, ou ajoutez manuellement la configuration du canal dans ~/.openclaw/openclaw.json avec appId et appSecret. Vous pouvez également utiliser les variables d'environnement FEISHU_APP_ID et FEISHU_APP_SECRET.
Démarrer le Gateway et tester
Exécutez 'openclaw gateway' pour démarrer le service. Envoyez un message direct au bot dans Feishu. Si vous utilisez la politique d'appairage par défaut, approuvez l'expéditeur via 'openclaw pairing approve feishu <code>' dans votre terminal.
Feishu / Lark Exemple de configuration
{
"channels": {
"feishu": {
"enabled": true,
"dmPolicy": "pairing",
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "YOUR_APP_SECRET",
"botName": "My AI Assistant"
}
}
}
}
}Feishu / Lark Documentation Détaillée
Vue d'ensemble de l'architecture
Création de l'application Feishu et obtention des identifiants
# Via variables d'environnement
export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="your_app_secret"
# Ou via l'assistant CLI
openclaw channels addConfiguration Feishu vs Lark
{
"channels": {
"feishu": {
"domain": "lark",
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "YOUR_APP_SECRET"
}
}
}
}
}Politiques de DM
{
"channels": {
"feishu": {
"dmPolicy": "allowlist",
"allowFrom": ["ou_xxx", "ou_yyy"]
}
}
}Gestion des discussions de groupe
{
"channels": {
"feishu": {
"groupPolicy": "open",
"requireMention": true
}
}
}Réponses en streaming (cartes interactives)
{
"channels": {
"feishu": {
"streaming": true
}
}
}Types de messages et support média
{
"channels": {
"feishu": {
"mediaMaxMb": 30,
"textChunkLimit": 2000
}
}
}Multi-comptes et routage multi-agents
{
"channels": {
"feishu": {
"accounts": {
"support": {
"appId": "cli_aaa",
"appSecret": "secret_a",
"botName": "Support Bot"
},
"hr": {
"appId": "cli_bbb",
"appSecret": "secret_b",
"botName": "HR Bot"
}
}
}
}
}Commandes utiles
Feishu / Lark Référence de Configuration
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | Activer ou désactiver le canal Feishu |
| domain | string | "feishu" | Domaine API : 'feishu' pour domestique (feishu.cn) ou 'lark' pour international (larksuite.com) |
| dmPolicy | string | "pairing" | Contrôle qui peut envoyer des DM au bot. Options : pairing, allowlist, open, disabled |
| allowFrom | string[] | [] | Open ID (ou_xxx) autorisés à contacter le bot quand dmPolicy est 'allowlist' |
| groupPolicy | string | "open" | Politique de discussion de groupe. Options : open, allowlist, disabled |
| requireMention | boolean | true | Si le bot nécessite une @mention pour répondre dans les groupes |
| streaming | boolean | true | Activer les réponses IA en streaming via les cartes interactives |
| textChunkLimit | number | 2000 | Nombre maximum de caractères par message texte |
| mediaMaxMb | number | 30 | Taille maximale des fichiers média en mégaoctets |
| accounts.<id>.appId | string | "" | App ID Feishu (format : cli_xxx) |
| accounts.<id>.appSecret | string | "" | App Secret Feishu |
| accounts.<id>.botName | string | "" | Nom d'affichage du bot dans les chats Feishu |
| historyLimit | number | 50 | Nombre de messages récents inclus comme contexte IA |
Activer ou désactiver le canal Feishu
Domaine API : 'feishu' pour domestique (feishu.cn) ou 'lark' pour international (larksuite.com)
Contrôle qui peut envoyer des DM au bot. Options : pairing, allowlist, open, disabled
Open ID (ou_xxx) autorisés à contacter le bot quand dmPolicy est 'allowlist'
Politique de discussion de groupe. Options : open, allowlist, disabled
Si le bot nécessite une @mention pour répondre dans les groupes
Activer les réponses IA en streaming via les cartes interactives
Nombre maximum de caractères par message texte
Taille maximale des fichiers média en mégaoctets
App ID Feishu (format : cli_xxx)
App Secret Feishu
Nom d'affichage du bot dans les chats Feishu
Nombre de messages récents inclus comme contexte IA
Feishu / Lark Questions Fréquentes
Feishu / Lark Dépannage
Le bot n'est peut-être pas ajouté au groupe, la @mention ne fonctionne pas, ou groupPolicy est sur 'disabled'.
L'application n'est peut-être pas publiée, l'abonnement aux événements n'est pas configuré, ou les permissions manquent.
La permission im:message:send_as_bot n'est peut-être pas accordée, ou l'application n'est pas publiée.
L'App Secret a été accidentellement commité dans le contrôle de version.
Instabilité réseau ou pare-feu interférant avec les connexions WebSocket.