Pourquoi Feishu ?
Feishu (飞书), connu internationalement sous le nom de Lark, est la plateforme de collaboration d'entreprise de ByteDance — largement utilisée dans les entreprises tech chinoises, les startups et de plus en plus en Asie du Sud-Est. Avec OpenClaw v2026.2.2, Feishu est devenu le premier client de messagerie chinois officiellement pris en charge par la plateforme.
- •Aucune URL publique requise — pas de ngrok, pas de domaine, pas de serveur webhook
- •Fonctionne derrière les pare-feu — la connexion est sortante depuis votre machine
- •Faible latence — messagerie bidirectionnelle en temps réel
- •Support de contenu riche — texte, images, fichiers, audio, vidéo et autocollants
Prérequis
- •OpenClaw v2026.2.2 ou ultérieur
- •Un compte entreprise Feishu/Lark (le niveau gratuit fonctionne)
- •Un accès administrateur pour créer des applications sur la Feishu Open Platform
Étape 1 : Créer une application Feishu
- 1.Allez sur la Feishu Open Platform (ou la Lark Developer Console pour les tenants internationaux)
- 2.Cliquez sur Create Custom App
- 3.Définissez le nom de l'application (par exemple « OpenClaw Agent ») et la description
- 4.Téléchargez une icône (le logo homard d'OpenClaw convient bien)
- 5.Copiez l'App ID (format :
cli_xxx) et l'App Secret depuis la page des identifiants
Étape 2 : Configurer les permissions de l'application
Dans les paramètres de permissions de votre application, activez ces scopes :
| Permission | Objectif |
|---|---|
im:message | Envoyer et recevoir des messages |
im:message.group_at_msg | Recevoir les @mentions dans les discussions de groupe |
im:resource | Accéder aux images et fichiers |
contact:user.id:readonly | Identifier les utilisateurs |
Après avoir ajouté les permissions, cliquez sur Publish pour soumettre à l'examen. Dans la plupart des tenants d'entreprise, les applications auto-construites sont approuvées automatiquement.
Étape 3 : Activer l'abonnement aux événements
- 1.Dans les paramètres de l'application, allez dans Event Subscriptions
- 2.Sélectionnez WebSocket Mode (connexion longue) — c'est essentiel. N'utilisez PAS le mode webhook, car il nécessite une URL publique.
- 3.Abonnez-vous à ces événements :
Étape 4 : Configurer OpenClaw
Ajoutez les identifiants Feishu à votre configuration OpenClaw. Modifiez ~/.openclaw/.env :
FEISHU_APP_ID=cli_xxxxxxxxxxxxx
FEISHU_APP_SECRET=your_app_secret_here
Ou si vous utilisez le fichier de configuration OpenClaw (~/.openclaw/config.yaml) :
channels:
feishu:
enabled: true
appId: cli_xxxxxxxxxxxxx
appSecret: your_app_secret_here
Redémarrez OpenClaw :
openclaw restart
Vous devriez voir un message de journal confirmant que la connexion WebSocket Feishu est établie.
Étape 5 : Tester la connexion
Ouvrez Feishu et trouvez votre application dans la liste des conversations (recherchez le nom de l'application que vous avez défini à l'étape 1). Envoyez un message :
> Bonjour !
- •Des messages texte
- •Des images (l'agent peut les analyser si vous utilisez un modèle compatible avec la vision)
- •Des fichiers (l'agent peut lire les documents)
- •Des messages vocaux (transcrits et traités comme du texte)
Configuration des discussions de groupe
OpenClaw prend en charge les discussions de groupe Feishu avec trois modes d'accès :
| Mode | Comportement |
|---|---|
open (par défaut) | Tout membre du groupe peut déclencher le bot lorsqu'il est @mentionné |
allowlist | Seuls les utilisateurs approuvés peuvent interagir, même avec @mention |
disabled | Les messages de groupe sont complètement ignorés |
Configurez dans config.yaml :
channels:
feishu:
groupAccess: open # or "allowlist" or "disabled"
allowedUsers: # only used with "allowlist" mode
- user_id_1
- user_id_2
Dans les discussions de groupe, l'agent ne répond que lorsqu'il est @mentionné, évitant ainsi le bruit dans les canaux actifs.
Réponses en streaming
OpenClaw prend en charge le streaming des réponses IA dans Feishu à l'aide de cartes interactives. Au lieu d'attendre la réponse complète, l'agent envoie une carte initiale et la met à jour en temps réel au fur et à mesure que l'IA génère le texte. Cela offre une bien meilleure expérience utilisateur pour les longues réponses.
Le streaming est activé par défaut. Pour le désactiver :
channels:
feishu:
streaming: false
Types de messages pris en charge
| Direction | Types pris en charge |
|---|---|
| Entrant (utilisateur vers agent) | Texte, texte enrichi (post), images, fichiers, audio, vidéo, autocollants |
| Sortant (agent vers utilisateur) | Texte, images, fichiers, audio, cartes interactives |
Dépannage
Erreur « App not found » : Assurez-vous que l'application est publiée et approuvée dans votre tenant Feishu. Les applications auto-construites dans les tenants d'entreprise sont généralement approuvées automatiquement, mais certaines organisations exigent l'approbation d'un administrateur.
Pas de réponse de l'agent : Vérifiez les journaux d'OpenClaw (openclaw logs) pour les erreurs de connexion WebSocket. Vérifiez que l'App ID et l'App Secret sont corrects.
Les messages n'arrivent pas dans les discussions de groupe : Assurez-vous que le bot est ajouté au groupe et que l'utilisateur @mentionne correctement le bot. Vérifiez le paramètre groupAccess.
Coupures de connexion : La connexion WebSocket se reconnecte automatiquement. Si les coupures sont fréquentes, vérifiez la stabilité de votre réseau ou les paramètres de pare-feu.
Utiliser le bridge communautaire (alternative)
Si vous avez besoin de fonctionnalités au-delà de l'intégration native, le bridge feishu-openclaw maintenu par la communauté et développé par AlexAnys offre des capacités supplémentaires comme la mise en forme personnalisée des messages et la gestion avancée des groupes. Il faut environ 5 minutes pour le configurer et ne nécessite aucun serveur public.
Pour la documentation complète, consultez le guide officiel du canal Feishu.