Skip to content

Integración con Feishu: plugin oficial, chats grupales y herramientas de documentos ​

💡 Resumen en una frase: usa OpenClaw para crear un colega de IA que vive dentro de Feishu — integración mediante el asistente del plugin oficial, respuestas con tarjetas en streaming en chats grupales, y lectura/escritura directa de documentos y tablas multidimensionales de Feishu.

Segunda lección de la ruta de oficina. Elegiste este camino en Escenarios prácticos. La lección anterior sobre WeCom dependía de un plugin externo del equipo de Tencent WeCom; esta lección es más tranquila — la integración con Feishu de OpenClaw se basa en el plugin oficial @openclaw/feishu (incluido en el directorio oficial de canales), el bot en chat privado + grupal ya está listo para producción, las respuestas van en tarjetas en streaming, e incluye herramientas de documentos / wiki / Drive / Bitable de Feishu. Todos los ejemplos se basan en OpenClaw v2026.10.9.

Qué podrás hacer al terminar ​

  • Ejecutar el asistente openclaw channels login --channel feishu una vez, y en 15 minutos tener el bot en línea en Feishu (creado automáticamente con código QR, o pegando manualmente el App ID / App Secret)
  • @Mencionarlo en chats individuales y grupales de Feishu y recibir respuestas en tarjetas de streaming que se actualizan mientras se generan
  • Hacer que cree documentos de Feishu para escribir actas de reuniones y registre tareas pendientes en tablas multidimensionales de Bitable
  • Usar lista blanca de grupos + lista blanca de remitentes + umbral de @mención para controlar quién puede usarlo y a qué grupos puede entrar

Por qué usar OpenClaw y no una IA web ​

CapacidadIA webOpenClaw + plugin oficial de Feishu
Dónde aparece❌ En una página web aparte, no se puede usar en grupos✅ Justo en el chat/grupo de Feishu, basta con @mencionarlo
Experiencia de respuesta❌ Hay que esperar a que se genere todo el bloque✅ Tarjetas con actualización en streaming, se ve mientras se genera
Operaciones de negocio en Feishu❌ No toca documentos/tablas multidimensionales/base de conocimiento✅ Incluye la familia de herramientas doc / wiki / drive / Bitable
Costo de integración❌ No existe tal cosa como integración✅ Plugin oficial + asistente, WebSocket sin exponer la red pública por defecto
Datos y modelo❌ Todas las conversaciones quedan en manos del proveedor✅ El Gateway corre en tu propia máquina, cambia de modelo cuando quieras (incluidos modelos chinos)

Tu situación actual ​

  • Requisitos y conclusiones dispersos en decenas de grupos y cientos de documentos de Feishu; cuando alguien nuevo pregunta «¿cuál fue el criterio la última vez?», nadie sabe responder completo
  • Nadie quiere redactar las actas tras la reunión, las tareas se transmiten de palabra y en una semana nadie las recuerda
  • Quieres dar un asistente de IA a todo el equipo, pero no te atreves a pegar datos internos en una versión web pública

Cuándo usar esta jugada ​

Cuando necesitas:

  • Un asistente de IA que viva directamente dentro de Feishu, al que los colegas pueden @mencionar desde la ventana de chat, sin instalar herramientas nuevas
  • Que pueda crear documentos, redactar actas, registrar tablas multidimensionales y consultar la base de conocimiento con naturalidad
  • Integrarlo sin exponer el servidor a la red pública (la conexión persistente WebSocket es el modo por defecto)

Y no quieres:

  • Cambiar al navegador cada vez y copiar/pegar en la versión web
  • Escribir desde cero un servicio de callbacks de eventos de Feishu
  • Confiar las conversaciones internas a un servicio de terceros alojado

🎒 Preparativos antes de empezar ​

  • Haber completado Escenarios prácticos: elige tu ruta: Gateway en ejecución, al menos un modelo conectado
  • openclaw --version muestra 2026.5.29 o superior (requisito mínimo de versión del canal de Feishu; la versión de referencia de este tutorial v2026.10.9 lo cumple)
  • Una cuenta con la que puedas iniciar sesión en la plataforma abierta de Feishu y crear una app propia (para la versión internacional Lark, el equivalente es Lark Developer)
  • Un vaso de agua ☕ — en 15 minutos tendrás un colega de IA más en tu Feishu

Hazlo conmigo ​

Paso 1: ejecuta el asistente del canal OpenClaw Feishu e instala el plugin oficial (@openclaw/feishu) ​

Por qué: el canal de Feishu lo proporciona el plugin oficial @openclaw/feishu, sin configurarlo a mano en la configuración base — el asistente instala el plugin y configura las credenciales automáticamente, todo de una vez.

shell
openclaw channels login --channel feishu

El asistente te ofrece dos caminos:

  • Opción A: crear el bot escaneando un código QR — escanea el código QR en la app de Feishu y el bot se crea automáticamente; este camino bloquea el chat privado para que solo tú puedas usarlo (dmPolicy: "allowlist" + tu open_id), el más cómodo
  • Método B: pegar credenciales manualmente——ve primero a la plataforma abierta de Feishu para crear una app propia y pega el App ID y el App Secret en el asistente

El asistente también pregunta dos cosas: el dominio de la API (Feishu nacional feishu / versión internacional Lark) y la política de grupos.

Deberías ver: el asistente termina, la configuración se escribe, sin errores.

💡 Escanear el código QR con la app de Feishu nacional a menudo no responde

La página oficial de resolución de problemas lo lista como un caso conocido: la versión móvil de Feishu nacional no siempre responde al escaneo de códigos para crear bots. Si te pasa, vuelve a ejecutar openclaw channels login --channel feishu eligiendo el modo manual; pegar App ID / App Secret funciona igual.

  • El asistente termina sin errores

Paso 2: verificar que el canal de Feishu está en línea ​

Por qué: los cambios de configuración se aplican por hot reload, pero conviene confirmar que el canal está realmente listo antes de ir a hablar con el bot.

shell
openclaw channels status --probe

Deberías ver: el canal feishu se muestra como listo. Si el Gateway está apagado, arráncalo primero y vuelve a hacer la sonda.

  • En openclaw channels status --probe feishu aparece como listo

Paso 3: enviar el primer mensaje por chat privado y aprobar el código de emparejamiento ​

Por qué: por defecto dmPolicy: "pairing"——un usuario desconocido que inicie un chat privado solo recibirá un código de emparejamiento, y se le dará paso después de que lo apruebes en la CLI. Es la primera puerta para evitar que gente fuera de la empresa use el bot de gratis.

Operación: busca el bot en Feishu y envíale por chat privado un «hola».

Si creaste el bot pegando credenciales manualmente, en la primera conversación recibirás un código de emparejamiento; vuelve a la terminal para aprobarlo:

shell
openclaw pairing list feishu
openclaw pairing approve feishu <配对码>

Deberías ver: el bot empieza a responder, y las respuestas van dentro de una tarjeta que se actualiza de forma streaming——se refresca mientras se genera; es la tarjeta en streaming de Feishu Card Kit (streaming.mode por defecto partial). Los bots creados por escaneo de código ya tienen el chat privado bloqueado solo para ti y no activan el emparejamiento.

💡 Feishu no tiene menú de comandos con barra diagonal

/status (ver estado), /reset (reiniciar sesión), /model (consultar/cambiar modelo) y /followup <消息> (encolar un mensaje adicional) hay que enviarlos como texto normal directamente. Los comandos de control no entran en la cola de mensajes normales; incluso cuando está ocupado trabajando puedes usar /status para ver el progreso.

Paso 4: añadirlo a un grupo y configurar la lista blanca de grupos y las menciones @ ​

Por qué: por defecto groupPolicy: "allowlist" (los grupos no listados se ignoran) y en los grupos hay que @al bot para que responda——primero consigue el ID y luego añade tu grupo a la lista blanca.

Consigue primero dos ID:

  • ID del grupo (chat_id, empieza por oc_): abre el grupo → menú de la esquina superior derecha → Ajustes, aparece escrito en la página de ajustes
  • open_id del usuario (empieza por ou_): envía al bot un mensaje privado y busca open_id en openclaw logs --follow; o mira openclaw pairing list feishu

En openclaw.json permite tu grupo (ejemplo: permitir dos grupos, uno de ellos sin necesidad de @):

json
{
  "channels": {
    "feishu": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["oc_xxx", "oc_yyy"],
      "groups": {
        "oc_xxx": { "requireMention": false }
      }
    }
  }
}

Tras el cambio, espera a que el hot reload surta efecto (no hace falta reiniciar el Gateway), mete al bot en el grupo y dile algo.

Deberías ver: los mensajes en los grupos de la lista blanca reciben respuesta; en los grupos con requireMention: false responde sin necesidad de @; en los grupos no listados, lo que digas cae en el vacío.

Tres niveles de control, cada uno se encarga de un tramo:

NivelCampoQué gestiona
GrupogroupAllowFrom / groups.<群ID>Qué grupos pueden entrar
MenciónrequireMentionSi en el grupo hay que @ (por defecto sí; con groupPolicy: "open" por defecto no)
Personagroups.<群ID>.allowFromQué miembros del grupo cuentan (se puede fijar globalmente con groupSenderAllowFrom)

⚠️ @todos no cuenta como @al bot

Las menciones de difusión tipo @all / @_all no se consideran menciones al bot; para provocar una respuesta hay que @ directamente al propio bot.

Paso 5: hacer que opere documentos de Feishu y Bitable ​

Por qué: esta es la parte más valiosa del canal de Feishu——el plugin trae de serie todo un conjunto de herramientas de trabajo de Feishu, activadas por defecto; tú solo tienes que pedirlo.

Operación: dile «crea un documento de Feishu titulado 《Acta de la reunión semanal de 11 (noviembre)》».

Deberías ver: crea el documento y devuelve el enlace en la conversación.

Ten claro el comportamiento de dos herramientas:

  • feishu_doc crear documentos solo lleva el título——para el cuerpo tiene que escribir otra vez usando el document_id que devuelve. Así que di directamente «crea un documento y escribe dentro el siguiente contenido», y deja que él mismo lo divida en dos pasos; no digas solo «crea un documento»
  • Bitable reconoce el application token de los enlaces /base/ (o el app_token que devuelve), no reconoce el node token de los enlaces /wiki/——al pasarle una tabla multidimensional, lo más seguro es pegar el enlace /base/

Interruptores de las familias de herramientas (todos bajo channels.feishu.tools.*):

Familia de herramientasQué hacePor defecto
tools.docLectura/escritura de documentos de Feishu✅ activado
tools.wikiBase de conocimiento (depende de doc)✅ activado
tools.driveDisco en la nube✅ activado
tools.bitableTabla multidimensional✅ activado
tools.chatConsulta de información de grupos/miembros✅ activado
tools.scopesDiagnóstico de permisos scope de la app✅ activado
tools.permGestión de permisos⚠️ desactivado (sensible, activar según necesidad)

💡 Este es el valor exclusivo de OpenClaw

Una IA web ni siquiera puede entrar en tu Feishu; este Claw trae de forma nativa herramientas de documentos, base de conocimiento, disco en la nube y tablas multidimensionales——cosas como «escribe los pendientes que acabamos de discutir en la tabla multidimensional» son cuestión de una sola frase, sin que tengas que exportar e importar nada.

Paso 6: antes de salir a producción, ajusta también el chat privado ​

Por qué: las apps creadas manualmente tienen por defecto dmPolicy: "pairing" (código de emparejamiento aprobado uno por uno); para uso dentro del equipo se puede cambiar a lista blanca y es más cómodo; los bots creados por escaneo ya están bloqueados automáticamente solo para ti, así que puedes saltarte este paso.

json
{
  "channels": {
    "feishu": {
      "dmPolicy": "allowlist",
      "allowFrom": ["ou_user1", "ou_user2"]
    }
  }
}

Deberías ver: los usuarios fuera de la lista blanca ya no obtienen respuesta en el chat privado. El sistema completo de control de acceso y endurecimiento de seguridad está en Endurecimiento de seguridad (1): control de acceso e identidad.

📋 Prompt mágico ​

Los siguientes Prompt se pegan directamente en la ventana de chat de Feishu y se envían al bot. Todos usan las familias de herramientas de Feishu desbloqueadas en el paso 5.

📝 Minutas de reunión a documento con un clic ​

Efecto esperado: el bot llama a la herramienta feishu_doc, primero crea un documento con título, luego escribe el cuerpo y envía el enlace del documento al grupo.

## Rol
Eres el secretario de reuniones, experto en convertir discusiones largas en minutas accionables.
## Tarea
Organiza el registro de la siguiente reunión en minutas: primero crea en Feishu un documento titulado 【Título del documento】, luego escribe el cuerpo de las minutas en ese documento y, por último, envía el enlace del documento a este grupo.
## Información de entrada
### Campos obligatorios
- Título del documento:【Nombre de la reunión + fecha】
- Registro de la reunión:【Pega la transcripción original o tus notas rápidas】
### Campos opcionales
- Temas clave:【¿Temas que requieren desarrollo detallado?】
## Especificaciones de salida
Las minutas se dividen en tres secciones: «Conclusiones / Pendientes / Puntos abiertos»; los pendientes en tabla: asunto | responsable | fecha límite. En el grupo solo responde con el enlace del documento y un resumen de una frase.
## Restricciones
- ✅ Cada pendiente asignado a una persona concreta
- ✅ Los pendientes sin responsable se listan aparte para su adopción
- ❌ No inundar el grupo con el texto completo de las minutas

📋 Registrar en Bitable los pendientes discutidos en el grupo ​

Efecto esperado: el bot llama a la herramienta feishu_bitable_* y escribe en la tabla multidimensional, uno por uno, los pendientes del chat grupal.

## Rol
Eres el asistente de proyecto, encargado de convertir las conclusiones del chat grupal en registros rastreables.
## Tarea
Escribe en la tabla multidimensional 【pega el enlace de la tabla que empieza por /base/】 todos los pendientes aparecidos hoy en la discusión de este grupo, uno por uno.
## Información de entrada
### Campos obligatorios
- Tabla de destino:【enlace de tabla multidimensional que empieza por /base/】
### Campos opcionales
- Valor por defecto de fecha límite:【¿Qué fecha rellenar para los pendientes sin fecha explícita?】
## Especificaciones de salida
Cada pendiente en una fila: asunto | responsable | fecha límite. Al terminar todo, responde en el grupo con un resumen: cuántos pendientes en total y a quién se asignaron.
## Restricciones
- ✅ Registrar solo pendientes realmente aparecidos en el grupo
- ❌ No inventar pendientes
- ❌ Si el enlace de la tabla no empieza por /base/, pregúntame primero; no lo fuerces

📚 Preguntas y respuestas sobre la base de conocimiento con fuentes ​

Efecto esperado: el bot responde tras consultar la base de conocimiento con la herramienta feishu_wiki, adjuntando los enlaces de los nodos de referencia.

## Rol
Eres el gestor de conocimiento del equipo; al responder preguntas siempre debes indicar la fuente.
## Tarea
Busca en la base de conocimiento de Feishu material relacionado con 【tema de la pregunta】, responde mi pregunta y adjunta los enlaces de los nodos de la base de conocimiento que consultaste.
## Información de entrada
### Campos obligatorios
- Pregunta:【tu pregunta】
### Campos opcionales
- Alcance limitado:【¿buscar solo en un espacio o nodo concreto?】
## Especificaciones de salida
Primero da una respuesta de una frase, luego hasta 3 fundamentos, cada uno con su enlace a la base de conocimiento.
## Restricciones
- ✅ Si no lo encuentras, dilo claramente y lista las ubicaciones que consultaste
- ❌ No inventar respuestas

Puntos de verificación ✅ ​

  • openclaw channels status --probe muestra el canal feishu listo
  • Envía un mensaje por chat privado; la respuesta llega en una tarjeta con actualización en streaming
  • En el grupo, @al bot responde; en los grupos con requireMention: false responde incluso sin @
  • Pídele crear un documento de Feishu; el enlace se abre y el título es correcto
  • dmPolicy y groupPolicy ajustados según tus necesidades (o decidiste explícitamente mantener los valores por defecto)

Avisos de errores comunes ​

❌ El bot entró al grupo pero ignora los mensajes ​

Causa: por defecto en los grupos hay que @al bot; o el grupo no está en la lista blanca (groupPolicy por defecto allowlist) o se configuró como disabled.

Solución correcta: según el paso 4, añade el ID del grupo (empieza por oc_) a groupAllowFrom y @al bot al hablar; si aún no funciona, usa openclaw logs --follow para ver los logs.

❌ El chat privado tampoco responde, no llega ningún mensaje ​

Causa: la plataforma abierta de Feishu no está bien configurada: la app no está publicada/aprobada, falta im.message.receive_v1 en la suscripción de eventos, la recepción de eventos no está en modo conexión larga (WebSocket), o faltan permisos scope.

Solución correcta: revisa punto por punto: app publicada y aprobada → la suscripción de eventos incluye im.message.receive_v1 → modo de recepción en conexión larga → completar los scope necesarios → openclaw gateway status para confirmar que el Gateway está corriendo.

❌ Escanear el código para crear el bot desde la app de Feishu de China no responde ​

Causa: la versión china de Feishu móvil no siempre responde al flujo de escaneo de código (situación conocida en la página oficial de resolución de problemas).

Solución correcta: vuelve a ejecutar openclaw channels login --channel feishu y elige el modo manual: crea una app propia en la plataforma abierta, copia el App ID / App Secret y pégalo en el asistente.

❌ Se filtró el App Secret ​

Solución correcta: restablece inmediatamente el Secret en la plataforma abierta de Feishu → actualiza el valor en la configuración → openclaw channels status --probe para confirmar que la recarga en caliente surtió efecto. La configuración usa recarga en caliente, no hace falta reiniciar el Gateway.

Técnicas avanzadas (opcional) ​

Multi-cuenta: un Gateway con varios bots de Feishu ​

Configura varios bots en accounts (por ejemplo main / backup) y usa defaultAccount para designar la cuenta saliente por defecto. Los campos a nivel de cuenta anulan los de nivel superior; el TTS además admite fusión profunda por cuenta: compartir un mismo conjunto de credenciales de voz con distinta voz por bot.

Granularidad de sesiones de grupo e hilos por tema ​

groupSessionScope controla cómo se mapean las sesiones de los mensajes de grupo: group (por defecto, un grupo una sesión), group_sender (separar por persona), group_topic (separar por tema), group_topic_sender (tema + persona). Para que las respuestas del bot abran automáticamente un hilo por tema, configura replyInThread: "enabled".

Agent dinámico: aislar por usuario un bot público ​

Para abrirlo al exterior (dmPolicy: "open" + allowFrom: ["*"]), activa dynamicAgentCreation.enabled: true: cada usuario de chat privado genera automáticamente un agente independiente (ID con la forma feishu-<open_id>), con espacio de trabajo, memoria e historial de sesiones totalmente aislados. Ten en cuenta dos cosas: es un aislamiento del contexto de mensajes, no un límite de seguridad contra coarriendo malicioso; y requiere que configWrites permanezca activado (por defecto lo está).

Respuestas con stickers ​

Con actions.sticker: true, el bot puede reenviar tal cual los stickers queha recibido; configurando además stickerSets puede buscar stickers por palabra clave (por ejemplo «me gusta» → 👍). Límites: 32 conjuntos por bot, 256 stickers por conjunto, 1–8 palabras clave por sticker. Ten en cuenta que solo puede enviar stickers que haya recibido; subir stickers nuevos o buscar en la tienda de stickers no está soportado.

Modo webhook (normalmente innecesario) ​

WebSocket es el modo por defecto y funciona sin exponer una red pública. Cambia a connectionMode: "webhook" solo si realmente necesitas callbacks: comparte la ruta /feishu/events del puerto HTTP del Gateway (por defecto 18789), requiere verificationToken + encryptKey, y el reloj del host del Gateway debe diferir del de Feishu en menos de 1 hora (mantener sincronización NTP); de lo contrario la verificación de firma da 401.

Límites y dos interruptores para ahorrar cuota ​

Límite de envío de medios 30 MB (mediaMaxMb); el texto largo se divide en bloques de 4000 caracteres (textChunkLimit). Para ahorrar cuota de la API de Feishu: typingIndicator: false desactiva la reacción «escribiendo», resolveSenderNames: false desactiva la consulta de nombres de remitentes.

El enrutamiento multi-agente (distribuir mensajes a distintos agentes según usuario/grupo) se explica en C3 colaboración multi-agente.

Resumen de la lección ​

✅ Ahora puedes:

  • Completar la integración de OpenClaw con Feishu: un asistente de IA con respuestas en tarjeta en streaming en chats privados y grupales (instalar el plugin con el asistente → emparejar y entrar al grupo → desbloquear las herramientas de documentos)
  • Enviar /status, /model y otros comandos de control como texto normal, y consultar el progreso en cualquier momento mientras trabaja
  • Hacerle crear documentos de Feishu, escribir minutas, registrar en Bitable y consultar la base de conocimiento
  • Controlar el acceso con lista blanca (chat privado / grupo / remitente del grupo) + umbral de @mención

Repaso de los campos de configuración clave:

CampoValor recomendadoDescripción
channels.feishu.connectionModewebsocket (por defecto)Transporte de eventos, sin URL pública
channels.feishu.dmPolicypairing (predeterminado) / allowlistpolítica de mensajes privados; el bot creado escaneando el código se bloquea automáticamente al propio usuario
channels.feishu.groupPolicyallowlist (predeterminado)política de grupo, se usa junto con groupAllowFrom
channels.feishu.requireMentiontrue (predeterminado)en el grupo solo responde al ser mencionado con @; bajo la estrategia open está exento por defecto
channels.feishu.groups.<群ID>.allowFromse rellena por grupo con open_idlista blanca de remitentes dentro del grupo
channels.feishu.tools.permfalse (predeterminado)herramienta de gestión de permisos, activar según necesidad para operaciones sensibles

Vista previa de la próxima lección ​

Próxima lección A3 WeChat, QQ y Yuanbao: integración de los canales del ecosistema Tencent , aprenderás:

  • Los límites de capacidad de la integración con WeChat personal (solo chat privado, sin soporte de grupos)
  • Bot oficial de QQ: crear el bot en la plataforma abierta q.qq.com, integración con un solo comando
  • Canal Tencent Yuanbao: cómo configurar el modo WebSocket
  • Diferencias de configuración entre los canales de Tencent y Feishu/WeCom

¿Tu empresa todavía usa WeChat/QQ para comunicarse? En la próxima lección conéctalos también; los canales no interfieren entre sí, un solo Gateway se los lleva todos.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.