¿Por que Feishu?
Feishu (飞书), conocido internacionalmente como Lark, es la plataforma de colaboracion empresarial de ByteDance — ampliamente utilizada en empresas tecnologicas chinas, startups y cada vez mas en el sudeste asiatico. Con OpenClaw v2026.2.2, Feishu se convirtio en el primer cliente de chat chino oficialmente soportado por la plataforma.
- •No se requiere URL publica — sin ngrok, sin dominio, sin servidor webhook
- •Funciona detras de firewalls — la conexion es saliente desde tu maquina
- •Baja latencia — mensajeria bidireccional en tiempo real
- •Soporte de contenido enriquecido — texto, imagenes, archivos, audio, video y stickers
Prerequisitos
- •OpenClaw v2026.2.2 o posterior
- •Una cuenta empresarial de Feishu/Lark (el nivel gratuito funciona)
- •Acceso de administrador para crear aplicaciones en la Plataforma Abierta de Feishu
Paso 1: Crear una aplicacion de Feishu
- 1.Ve a la Plataforma Abierta de Feishu (o la Consola de Desarrolladores de Lark para inquilinos internacionales)
- 2.Haz clic en Crear aplicacion personalizada
- 3.Establece el nombre de la aplicacion (por ejemplo, "OpenClaw Agent") y la descripcion
- 4.Sube un icono (el logo de la langosta de OpenClaw funciona bien)
- 5.Copia el App ID (formato:
cli_xxx) y el App Secret de la pagina de Credenciales
Paso 2: Configurar permisos de la aplicacion
En la configuracion de permisos de tu aplicacion, habilita estos alcances:
| Permiso | Proposito |
|---|---|
im:message | Enviar y recibir mensajes |
im:message.group_at_msg | Recibir @menciones en chats grupales |
im:resource | Acceder a imagenes y archivos |
contact:user.id:readonly | Identificar usuarios |
Despues de agregar los permisos, haz clic en Publicar para enviar a revision. En la mayoria de los inquilinos empresariales, las aplicaciones autoconstruidas se aprueban automaticamente.
Paso 3: Habilitar suscripcion de eventos
- 1.En la configuracion de la aplicacion, ve a Suscripciones de eventos
- 2.Selecciona Modo WebSocket (conexion larga) — esto es critico. NO uses el modo webhook, ya que requiere una URL publica.
- 3.Suscribete a estos eventos:
Paso 4: Configurar OpenClaw
Agrega las credenciales de Feishu a tu configuracion de OpenClaw. Edita ~/.openclaw/.env:
FEISHU_APP_ID=cli_xxxxxxxxxxxxx
FEISHU_APP_SECRET=your_app_secret_here
O si usas el archivo de configuracion de OpenClaw (~/.openclaw/config.yaml):
channels:
feishu:
enabled: true
appId: cli_xxxxxxxxxxxxx
appSecret: your_app_secret_here
Reinicia OpenClaw:
openclaw restart
Deberias ver un mensaje de log confirmando que la conexion WebSocket de Feishu se ha establecido.
Paso 5: Probar la conexion
Abre Feishu y busca tu aplicacion en la lista de chats (busca el nombre de la aplicacion que estableciste en el Paso 1). Envia un mensaje:
> ¡Hola!
- •Mensajes de texto
- •Imagenes (el agente puede analizarlas si usa un modelo con capacidad de vision)
- •Archivos (el agente puede leer documentos)
- •Mensajes de voz (transcritos y procesados como texto)
Configuracion de chat grupal
OpenClaw soporta chats grupales de Feishu con tres modos de acceso:
| Modo | Comportamiento |
|---|---|
open (por defecto) | Cualquier miembro del grupo puede activar el bot cuando lo @menciona |
allowlist | Solo usuarios aprobados pueden interactuar, incluso con @mencion |
disabled | Los mensajes grupales se ignoran completamente |
Configura en config.yaml:
channels:
feishu:
groupAccess: open # or "allowlist" or "disabled"
allowedUsers: # only used with "allowlist" mode
- user_id_1
- user_id_2
En chats grupales, el agente solo responde cuando lo @mencionan, previniendo ruido en canales ocupados.
Respuestas en streaming
OpenClaw soporta respuestas de IA en streaming en Feishu usando tarjetas interactivas. En lugar de esperar la respuesta completa, el agente envia una tarjeta inicial y la actualiza en tiempo real a medida que la IA genera texto. Esto proporciona una experiencia de usuario mucho mejor para respuestas largas.
El streaming esta habilitado por defecto. Para deshabilitarlo:
channels:
feishu:
streaming: false
Tipos de mensajes soportados
| Direccion | Tipos soportados |
|---|---|
| Entrante (usuario -> agente) | Texto, texto enriquecido (post), imagenes, archivos, audio, video, stickers |
| Saliente (agente -> usuario) | Texto, imagenes, archivos, audio, tarjetas interactivas |
Solucion de problemas
Error "App not found": Asegurate de que la aplicacion este publicada y aprobada en tu inquilino de Feishu. Las aplicaciones autoconstruidas en inquilinos empresariales normalmente se aprueban automaticamente, pero algunas organizaciones requieren aprobacion del administrador.
Sin respuesta del agente: Verifica los logs de OpenClaw (openclaw logs) en busca de errores de conexion WebSocket. Verifica que el App ID y App Secret sean correctos.
Los mensajes no llegan en chats grupales: Asegurate de que el bot este agregado al grupo y que el usuario este @mencionando al bot correctamente. Verifica la configuracion de groupAccess.
Caidas de conexion: La conexion WebSocket se reconecta automaticamente. Si las caidas son frecuentes, verifica la estabilidad de tu red o la configuracion del firewall.
Usando el puente comunitario (alternativa)
Si necesitas funcionalidades mas alla de la integracion nativa, el puente feishu-openclaw mantenido por la comunidad, creado por AlexAnys, ofrece capacidades adicionales como formato de mensajes personalizado y gestion avanzada de grupos. Toma aproximadamente 5 minutos configurarlo y no requiere servidor publico.
Para la documentacion completa, consulta la guia oficial del canal Feishu.