Canal Feishu / Lark de OpenClaw
Conecta OpenClaw a Feishu (飞书) o Lark mediante suscripción de eventos basada en WebSocket. Esta integración empresarial permite que tu asistente de IA maneje mensajes directos y chats grupales en Feishu/Lark — la plataforma líder de colaboración empresarial de ByteDance. OpenClaw se conecta a través del modo de conexión larga (WebSocket) de la plataforma abierta de Feishu, por lo que no se necesita URL pública ni endpoint Webhook.
Feishu / Lark Funciones compatibles
Mensajes de texto
Compatible
Medios y archivos
Compatible
Reacciones
No compatible
Hilos
No compatible
Mensajes de voz
No compatible
Chat grupal
Compatible
Feishu / Lark Requisitos previos
- Una cuenta de tenant Feishu (feishu.cn) o Lark (larksuite.com) con permisos de creación de apps
- El plugin de Feishu instalado: openclaw plugins install @openclaw/feishu
- OpenClaw Gateway ejecutándose y configurado
- Node.js 18+ instalado en tu servidor
Feishu / Lark Configuración rápida
Crear una app Feishu/Lark
Visita la plataforma abierta de Feishu (open.feishu.cn/app) o la consola de desarrollador Lark (open.larksuite.com/app). Crea una nueva app empresarial, establece nombre, descripción e icono. Copia el App ID (formato: cli_xxx) y App Secret de la página de credenciales.
Configurar permisos y capacidad de bot
En la gestión de permisos de la app, importa en lote los permisos requeridos. Habilita la capacidad de bot en Capacidades de la app > Bot. En la suscripción de eventos, selecciona 'Usar conexión larga' (modo WebSocket) y añade el evento im.message.receive_v1. Publica la app a través de Gestión de versiones y Publicación.
Añadir configuración del canal Feishu a OpenClaw
Ejecuta 'openclaw channels add' y selecciona Feishu, o añade manualmente la configuración del canal en ~/.openclaw/openclaw.json con appId y appSecret. También puedes usar las variables de entorno FEISHU_APP_ID y FEISHU_APP_SECRET.
Iniciar Gateway y probar
Ejecuta 'openclaw gateway' para iniciar el servicio. Envía un mensaje directo al bot en Feishu. Si usas la política de emparejamiento predeterminada, aprueba al remitente con 'openclaw pairing approve feishu <code>' en tu terminal.
Feishu / Lark Ejemplo de configuración
{
"channels": {
"feishu": {
"enabled": true,
"dmPolicy": "pairing",
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "YOUR_APP_SECRET",
"botName": "My AI Assistant"
}
}
}
}
}Feishu / Lark Documentación Detallada
Descripción de la arquitectura
Creación de app Feishu y obtención de credenciales
# Vía variables de entorno
export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="your_app_secret"
# O vía asistente CLI
openclaw channels addConfiguración Feishu vs Lark
{
"channels": {
"feishu": {
"domain": "lark",
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "YOUR_APP_SECRET"
}
}
}
}
}Políticas de DM
{
"channels": {
"feishu": {
"dmPolicy": "allowlist",
"allowFrom": ["ou_xxx", "ou_yyy"]
}
}
}Gestión de chats grupales
{
"channels": {
"feishu": {
"groupPolicy": "open",
"requireMention": true
}
}
}Respuestas en streaming (tarjetas interactivas)
{
"channels": {
"feishu": {
"streaming": true
}
}
}Tipos de mensaje y soporte de medios
{
"channels": {
"feishu": {
"mediaMaxMb": 30,
"textChunkLimit": 2000
}
}
}Multi-cuenta y enrutamiento multi-agente
{
"channels": {
"feishu": {
"accounts": {
"support": {
"appId": "cli_aaa",
"appSecret": "secret_a",
"botName": "Support Bot"
},
"hr": {
"appId": "cli_bbb",
"appSecret": "secret_b",
"botName": "HR Bot"
}
}
}
}
}Comandos útiles
Feishu / Lark Referencia de Configuración
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | Activar o desactivar el canal Feishu |
| domain | string | "feishu" | Dominio API: 'feishu' para doméstico (feishu.cn) o 'lark' para internacional (larksuite.com) |
| dmPolicy | string | "pairing" | Controla quién puede enviar DMs al bot. Opciones: pairing, allowlist, open, disabled |
| allowFrom | string[] | [] | Open IDs (ou_xxx) permitidos cuando dmPolicy es 'allowlist' |
| groupPolicy | string | "open" | Política de chat grupal. Opciones: open, allowlist, disabled |
| requireMention | boolean | true | Si el bot requiere @mención para responder en grupos |
| streaming | boolean | true | Activar respuestas IA en streaming vía tarjetas interactivas |
| textChunkLimit | number | 2000 | Máximo de caracteres por mensaje de texto |
| mediaMaxMb | number | 30 | Tamaño máximo de archivo multimedia en megabytes |
| accounts.<id>.appId | string | "" | App ID de Feishu (formato: cli_xxx) |
| accounts.<id>.appSecret | string | "" | App Secret de Feishu |
| accounts.<id>.botName | string | "" | Nombre del bot en chats de Feishu |
| historyLimit | number | 50 | Número de mensajes recientes incluidos como contexto IA |
Activar o desactivar el canal Feishu
Dominio API: 'feishu' para doméstico (feishu.cn) o 'lark' para internacional (larksuite.com)
Controla quién puede enviar DMs al bot. Opciones: pairing, allowlist, open, disabled
Open IDs (ou_xxx) permitidos cuando dmPolicy es 'allowlist'
Política de chat grupal. Opciones: open, allowlist, disabled
Si el bot requiere @mención para responder en grupos
Activar respuestas IA en streaming vía tarjetas interactivas
Máximo de caracteres por mensaje de texto
Tamaño máximo de archivo multimedia en megabytes
App ID de Feishu (formato: cli_xxx)
App Secret de Feishu
Nombre del bot en chats de Feishu
Número de mensajes recientes incluidos como contexto IA
Feishu / Lark Preguntas Frecuentes
Feishu / Lark Solución de Problemas
El bot puede no estar añadido al grupo, la @mención no funciona, o groupPolicy está en 'disabled'.
La app puede no estar publicada, la suscripción de eventos no está configurada, o faltan permisos.
El permiso im:message:send_as_bot puede no estar concedido.
El App Secret fue accidentalmente subido al control de versiones.
Inestabilidad de red o firewall interfiriendo con las conexiones WebSocket.