Feishu / Lark

Feishu/Lark es una plataforma integral de colaboración donde los equipos chatean, comparten documentos, administran calendarios y trabajan juntos. Estado: listo para producción para mensajes directos del bot y chats grupales. WebSocket es el modo predeterminado; el modo webhook es opcional.

Inicio rápido

Requiere OpenClaw 2026.4.10 o superior. Ejecuta openclaw --version para comprobarlo. Actualiza con openclaw update.

Ejecuta el asistente de configuración del canal

openclaw channels login --channel feishu

Escanea el código QR con tu aplicación móvil de Feishu/Lark para crear automáticamente un bot de Feishu/Lark.

Después de completar la configuración, reinicia el Gateway para aplicar los cambios

openclaw gateway restart

Control de acceso

Mensajes directos

Configura dmPolicy para controlar quién puede enviar mensajes directos al bot:

"pairing" — los usuarios desconocidos reciben un código de emparejamiento; apruébalo mediante la CLI
"allowlist" — solo los usuarios listados en allowFrom pueden chatear (predeterminado: solo el propietario del bot)
"open" — permite a todos los usuarios
"disabled" — desactiva todos los mensajes directos

Aprobar una solicitud de emparejamiento:

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

Chats grupales

Política de grupo (channels.feishu.groupPolicy):

Valor	Comportamiento
`"open"`	Responde a todos los mensajes en grupos
`"allowlist"`	Solo responde a grupos en `groupAllowFrom`
`"disabled"`	Desactiva todos los mensajes grupales

Predeterminado: allowlist Requisito de mención (channels.feishu.requireMention):

true — requiere @mención (predeterminado)
false — responde sin @mención
Anulación por grupo: channels.feishu.groups.<chat_id>.requireMention

Ejemplos de configuración de grupos

Permitir todos los grupos, sin requerir @mención

{
  channels: {
    feishu: {
      groupPolicy: "open",
    },
  },
}

Permitir todos los grupos, pero seguir requiriendo @mención

{
  channels: {
    feishu: {
      groupPolicy: "open",
      requireMention: true,
    },
  },
}

Permitir solo grupos específicos

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Los ID de grupo tienen este aspecto: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

Restringir remitentes dentro de un grupo

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // Los open_id de usuario tienen este aspecto: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

Obtener ID de grupo/usuario

ID de grupo (`chat_id`, formato: `oc_xxx`)

Abre el grupo en Feishu/Lark, haz clic en el icono de menú en la esquina superior derecha y ve a Configuración. El ID de grupo (chat_id) aparece en la página de configuración.

ID de usuario (`open_id`, formato: `ou_xxx`)

Inicia el Gateway, envía un mensaje directo al bot y luego revisa los registros:

openclaw logs --follow

Busca open_id en la salida del registro. También puedes revisar las solicitudes de emparejamiento pendientes:

openclaw pairing list feishu

Comandos comunes

Comando	Descripción
`/status`	Muestra el estado del bot
`/reset`	Restablece la sesión actual
`/model`	Muestra o cambia el modelo de IA

Feishu/Lark no admite menús nativos de comandos con barra, así que envíalos como mensajes de texto sin formato.

Solución de problemas

El bot no responde en chats grupales

Asegúrate de que el bot esté agregado al grupo
Asegúrate de mencionar al bot con @ (requerido de forma predeterminada)
Verifica que groupPolicy no sea "disabled"
Revisa los registros: openclaw logs --follow

El bot no recibe mensajes

Asegúrate de que el bot esté publicado y aprobado en Feishu Open Platform / Lark Developer
Asegúrate de que la suscripción a eventos incluya im.message.receive_v1
Asegúrate de que esté seleccionada la conexión persistente (WebSocket)
Asegúrate de que se hayan concedido todos los permisos requeridos
Asegúrate de que el Gateway esté en ejecución: openclaw gateway status
Revisa los registros: openclaw logs --follow

Se filtró el App Secret

Restablece el App Secret en Feishu Open Platform / Lark Developer
Actualiza el valor en tu configuración
Reinicia el Gateway: openclaw gateway restart

Configuración avanzada

Varias cuentas

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "Bot principal",
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          name: "Bot de respaldo",
          enabled: false,
        },
      },
    },
  },
}

defaultAccount controla qué cuenta se usa cuando las API salientes no especifican un accountId.

Límites de mensajes

textChunkLimit — tamaño de fragmento de texto saliente (predeterminado: 2000 caracteres)
mediaMaxMb — límite de carga/descarga de medios (predeterminado: 30 MB)

Streaming

Feishu/Lark admite respuestas en streaming mediante tarjetas interactivas. Cuando está habilitado, el bot actualiza la tarjeta en tiempo real mientras genera texto.

{
  channels: {
    feishu: {
      streaming: true, // habilita la salida en streaming con tarjetas (predeterminado: true)
      blockStreaming: true, // habilita el streaming a nivel de bloque (predeterminado: true)
    },
  },
}

Establece streaming: false para enviar la respuesta completa en un solo mensaje.

Optimización de cuota

Reduce el número de llamadas a la API de Feishu/Lark con dos indicadores opcionales:

typingIndicator (predeterminado true): establece false para omitir las llamadas de reacción de escritura
resolveSenderNames (predeterminado true): establece false para omitir las búsquedas del perfil del remitente

{
  channels: {
    feishu: {
      typingIndicator: false,
      resolveSenderNames: false,
    },
  },
}

Sesiones de ACP

Feishu/Lark admite ACP para mensajes directos y mensajes de hilo de grupo. El ACP de Feishu/Lark se controla mediante comandos de texto: no hay menús nativos de comandos con barra, así que usa mensajes /acp ... directamente en la conversación.

Vinculación persistente de ACP

{
  agents: {
    list: [
      {
        id: "codex",
        runtime: {
          type: "acp",
          acp: {
            agent: "codex",
            backend: "acpx",
            mode: "persistent",
            cwd: "/workspace/openclaw",
          },
        },
      },
    ],
  },
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "feishu",
        accountId: "default",
        peer: { kind: "direct", id: "ou_1234567890" },
      },
    },
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "feishu",
        accountId: "default",
        peer: { kind: "group", id: "oc_group_chat:topic:om_topic_root" },
      },
      acp: { label: "codex-feishu-topic" },
    },
  ],
}

Iniciar ACP desde el chat

En un mensaje directo o hilo de Feishu/Lark:

/acp spawn codex --thread here

--thread here funciona para mensajes directos y mensajes de hilo de Feishu/Lark. Los mensajes posteriores en la conversación vinculada se enrutan directamente a esa sesión de ACP.

Enrutamiento de múltiples agentes

Usa bindings para enrutar mensajes directos o grupos de Feishu/Lark a distintos agentes.

{
  agents: {
    list: [
      { id: "main" },
      { id: "agent-a", workspace: "/home/user/agent-a" },
      { id: "agent-b", workspace: "/home/user/agent-b" },
    ],
  },
  bindings: [
    {
      agentId: "agent-a",
      match: {
        channel: "feishu",
        peer: { kind: "direct", id: "ou_xxx" },
      },
    },
    {
      agentId: "agent-b",
      match: {
        channel: "feishu",
        peer: { kind: "group", id: "oc_zzz" },
      },
    },
  ],
}

Campos de enrutamiento:

match.channel: "feishu"
match.peer.kind: "direct" (mensaje directo) o "group" (chat grupal)
match.peer.id: Open ID del usuario (ou_xxx) o ID del grupo (oc_xxx)

Consulta Obtener ID de grupo/usuario para ver consejos de búsqueda.

Referencia de configuración

Configuración completa: Configuración de Gateway

Setting	Descripción	Predeterminado
`channels.feishu.enabled`	Habilita/deshabilita el canal	`true`
`channels.feishu.domain`	Dominio de API (`feishu` o `lark`)	`feishu`
`channels.feishu.connectionMode`	Transporte de eventos (`websocket` o `webhook`)	`websocket`
`channels.feishu.defaultAccount`	Cuenta predeterminada para el enrutamiento saliente	`default`
`channels.feishu.verificationToken`	Requerido para el modo webhook	—
`channels.feishu.encryptKey`	Requerido para el modo webhook	—
`channels.feishu.webhookPath`	Ruta del webhook	`/feishu/events`
`channels.feishu.webhookHost`	Host de enlace del webhook	`127.0.0.1`
`channels.feishu.webhookPort`	Puerto de enlace del webhook	`3000`
`channels.feishu.accounts.<id>.appId`	App ID	—
`channels.feishu.accounts.<id>.appSecret`	App Secret	—
`channels.feishu.accounts.<id>.domain`	Anulación de dominio por cuenta	`feishu`
`channels.feishu.dmPolicy`	Política de mensajes directos	`allowlist`
`channels.feishu.allowFrom`	Lista de permitidos para mensajes directos (lista de `open_id`)	[BotOwnerId]
`channels.feishu.groupPolicy`	Política de grupo	`allowlist`
`channels.feishu.groupAllowFrom`	Lista de permitidos de grupos	—
`channels.feishu.requireMention`	Requerir @mención en grupos	`true`
`channels.feishu.groups.<chat_id>.requireMention`	Anulación de @mención por grupo	heredado
`channels.feishu.groups.<chat_id>.enabled`	Habilita/deshabilita un grupo específico	`true`
`channels.feishu.textChunkLimit`	Tamaño de fragmento del mensaje	`2000`
`channels.feishu.mediaMaxMb`	Límite de tamaño de medios	`30`
`channels.feishu.streaming`	Salida en streaming con tarjetas	`true`
`channels.feishu.blockStreaming`	Streaming a nivel de bloque	`true`
`channels.feishu.typingIndicator`	Enviar reacciones de escritura	`true`
`channels.feishu.resolveSenderNames`	Resolver nombres para mostrar del remitente	`true`

Tipos de mensajes compatibles

Recibir

✅ Texto
✅ Texto enriquecido (post)
✅ Imágenes
✅ Archivos
✅ Audio
✅ Video/medios
✅ Stickers

Enviar

✅ Texto
✅ Imágenes
✅ Archivos
✅ Audio
✅ Video/medios
✅ Tarjetas interactivas (incluidas actualizaciones en streaming)
⚠️ Texto enriquecido (formato tipo post; no admite todas las capacidades de creación de Feishu/Lark)

Hilos y respuestas

✅ Respuestas en línea
✅ Respuestas en hilos
✅ Las respuestas con medios conservan el contexto del hilo al responder a un mensaje de hilo

Relacionado

Descripción general de los canales — todos los canales compatibles
Emparejamiento — autenticación de mensajes directos y flujo de emparejamiento
Grupos — comportamiento del chat grupal y control por mención
Enrutamiento de canales — enrutamiento de sesiones para mensajes
Seguridad — modelo de acceso y refuerzo de seguridad

Overview

Messaging platforms

Configuration

Feishu

Feishu / Lark

Inicio rápido

Control de acceso

Mensajes directos

Chats grupales

Ejemplos de configuración de grupos

Permitir todos los grupos, sin requerir @mención

Permitir todos los grupos, pero seguir requiriendo @mención

Permitir solo grupos específicos

Restringir remitentes dentro de un grupo

Obtener ID de grupo/usuario

ID de grupo (`chat_id`, formato: `oc_xxx`)

ID de usuario (`open_id`, formato: `ou_xxx`)

Comandos comunes

Solución de problemas

El bot no responde en chats grupales

El bot no recibe mensajes

Se filtró el App Secret

Configuración avanzada

Varias cuentas

Límites de mensajes

Streaming

Optimización de cuota

Sesiones de ACP

Vinculación persistente de ACP

Iniciar ACP desde el chat

Enrutamiento de múltiples agentes

Referencia de configuración

Tipos de mensajes compatibles

Recibir

Enviar

Hilos y respuestas

Relacionado

Overview

Messaging platforms

Configuration

​Feishu / Lark

​Inicio rápido

​Control de acceso

​Mensajes directos

​Chats grupales

​Ejemplos de configuración de grupos

​Permitir todos los grupos, sin requerir @mención

​Permitir todos los grupos, pero seguir requiriendo @mención

​Permitir solo grupos específicos

​Restringir remitentes dentro de un grupo

​Obtener ID de grupo/usuario

​ID de grupo (chat_id, formato: oc_xxx)

​ID de usuario (open_id, formato: ou_xxx)

​Comandos comunes

​Solución de problemas

​El bot no responde en chats grupales

​El bot no recibe mensajes

​Se filtró el App Secret

​Configuración avanzada

​Varias cuentas

​Límites de mensajes

​Streaming

​Optimización de cuota

​Sesiones de ACP

​Vinculación persistente de ACP

​Iniciar ACP desde el chat

​Enrutamiento de múltiples agentes

​Referencia de configuración

​Tipos de mensajes compatibles

​Recibir

​Enviar

​Hilos y respuestas

​Relacionado

Feishu / Lark

Inicio rápido

Control de acceso

Mensajes directos

Chats grupales

Ejemplos de configuración de grupos

Permitir todos los grupos, sin requerir @mención

Permitir todos los grupos, pero seguir requiriendo @mención

Permitir solo grupos específicos

Restringir remitentes dentro de un grupo

Obtener ID de grupo/usuario

ID de grupo (`chat_id`, formato: `oc_xxx`)

ID de usuario (`open_id`, formato: `ou_xxx`)

Comandos comunes

Solución de problemas

El bot no responde en chats grupales

El bot no recibe mensajes

Se filtró el App Secret

Configuración avanzada

Varias cuentas

Límites de mensajes

Streaming

Optimización de cuota

Sesiones de ACP

Vinculación persistente de ACP

Iniciar ACP desde el chat

Enrutamiento de múltiples agentes

Referencia de configuración

Tipos de mensajes compatibles

Recibir

Enviar

Hilos y respuestas

Relacionado