Saltar al contenido principal
Conecta Feishu (飞书) o Lark a tu instancia de Claw. Utiliza el modo WebSocket — no se requiere una URL de callback pública.

​
Requisitos previos

​
Guía de configuración

1

Crear una aplicación de Feishu

  1. Ve a Feishu Open Platform (o Lark Developer)
  2. Haz clic en Create Custom App
  3. Ingresa un nombre y descripción para la aplicación
  4. Haz clic en Create
2

Agregar capacidad de Bot

  1. En la configuración de tu aplicación, ve a Features → Bot
  2. Habilita la capacidad de bot
  3. Esto permite que tu aplicación reciba y envíe mensajes
3

Obtener credenciales

  1. Ve a Credentials & Basic Info
  2. Copia el App ID (comienza con cli_)
  3. Copia el App Secret
4

Configurar la suscripción de eventos

  1. Ve a Event Subscriptions
  2. Selecciona el modo WebSocket (recomendado — no se requiere una URL pública)
  3. Si se te solicita, establece el Encrypt Key y el Verification Token
Cuando configuras Feishu en el dashboard de LemonData, el Encrypt Key y el Verification Token se generan automáticamente para ti. Copia estos valores en la consola de desarrollador de Feishu.
5

Agregar permisos de eventos

  1. En Event Subscriptions, agrega estos eventos:
    • im.message.receive_v1 — Recibir mensajes
  2. Ve a Permissions & Scopes y agrega:
    • im:message — Enviar y recibir mensajes
    • im:message.group_at_msg — Recibir menciones @ en grupos
  3. Haz clic en Save
6

Publicar la aplicación

  1. Ve a App Release → Version Management
  2. Crea una nueva versión
  3. Envía para revisión (para aplicaciones internas, esto suele ser instantáneo)
  4. Una vez aprobada, la aplicación estará activa
7

Configurar en el Dashboard de LemonData

  1. Ve a tu Claw Dashboard
  2. Haz clic en el icono de configuración de tu instancia
  3. Abre la pestaña IM Integrations
  4. Expande la sección Feishu
  5. Pega tu App ID y App Secret
  6. Copia el Encrypt Key y el Verification Token generados automáticamente de vuelta a la consola de desarrollador de Feishu
  7. Haz clic en Save
8

Comenzar a chatear

  1. En Feishu, busca tu bot por su nombre
  2. Envíale un mensaje
  3. ¡El primer usuario se vincula automáticamente como propietario — no se requiere código!
  4. ¡Comienza a chatear con la IA!

​
Configuración de grupo

Configura el comportamiento del chat grupal en la pestaña IM Integrations de tu Dashboard:
ConfiguraciónOpcionesDescripción
Group PolicyOpen (predeterminado) / Allowlist / DisabledControla quién puede activar el bot en los grupos
Require @mentionActivado / DesactivadoEl bot solo responde cuando es mencionado con @
Group IDsLista de IDs de chatRestringir a grupos específicos (vacío = todos los grupos)
Group Allowed UsersLista de Open IDsSolo estos usuarios pueden activar el bot (modo allowlist)

​
Solución de problemas

  • Verifica que la aplicación esté publicada y aprobada
  • Comprueba que el evento im.message.receive_v1 esté suscrito
  • Asegúrate de que el modo WebSocket esté seleccionado (no HTTP)
  • Verifica que el Encrypt Key y el Verification Token coincidan entre la consola de Feishu y la configuración de Claw
  • Esto suele significar que el App ID o el App Secret son incorrectos
  • Verifica nuevamente las credenciales en tu dashboard