Feishu

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Inicio rápido

openclaw channels login --channel feishu

openclaw gateway restart

​

Control de acceso

​

Mensajes directos

• "pairing" - los usuarios desconocidos reciben un código de emparejamiento; apruébalo mediante la CLI
• "allowlist" - solo los usuarios indicados en allowFrom pueden chatear (predeterminado: solo el propietario del bot)
• "open" - permite MD públicos solo cuando allowFrom incluye "*"; con entradas restrictivas, solo los usuarios coincidentes pueden chatear
• "disabled" - desactiva todos los MD

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Chats grupales

• true - requiere @mención (predeterminado)
• false - responde sin @mención
• Anulación por grupo: channels.feishu.groups.<chat_id>.requireMention
• @all y @_all de solo difusión no se tratan como menciones al bot. Un mensaje que menciona tanto a @all como directamente al bot sigue contando como mención al bot.

​

Ejemplos de configuración de grupos

​

Permitir todos los grupos, sin requerir @mención

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

​

Permitir todos los grupos, seguir requiriendo @mención

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

​

Permitir solo grupos específicos

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Group IDs look like: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groups: {
        oc_xxx: {
          requireMention: false,
        },
      },
    },
  },
}

​

Restringir remitentes dentro de un grupo

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // User open_ids look like: ou_xxx
          allowFrom: ["ou_user1", "ou_user2"],
        },
      },
    },
  },
}

​

Obtener ID de grupo/usuario

​

ID de grupo (chat_id, formato: oc_xxx)

​

ID de usuario (open_id, formato: ou_xxx)

openclaw logs --follow

openclaw pairing list feishu

​

Comandos comunes

​

Solución de problemas

​

El bot no responde en chats grupales

1. Asegúrate de que el bot se haya añadido al grupo
2. Asegúrate de @mencionar al bot (requerido de forma predeterminada)
3. Verifica que groupPolicy no sea "disabled"
4. Revisa los registros: openclaw logs --follow

​

El bot no recibe mensajes

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

​

La configuración por QR no reacciona en la aplicación móvil de Feishu

1. Vuelve a ejecutar la configuración: openclaw channels login --channel feishu
2. Elige la configuración manual
3. En Feishu Open Platform, crea una aplicación autoconstruida y copia su App ID y App Secret
4. Pega esas credenciales en el asistente de configuración

​

App Secret filtrado

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

​

Configuración avanzada

​

Varias cuentas

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "Primary bot",
          tts: {
            providers: {
              openai: { voice: "shimmer" },
            },
          },
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          name: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

​

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

{
  channels: {
    feishu: {
      streaming: true, // enable streaming card output (default: true)
      blockStreaming: true, // opt into completed-block streaming
    },
  },
}

​

Optimización de cuota

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

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

​

Sesiones ACP

​

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" },
    },
  ],
}

​

Generar ACP desde el chat

/acp spawn codex --thread here

​

Enrutamiento multiagente

{
  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" },
      },
    },
  ],
}

• match.channel: "feishu"
• match.peer.kind: "direct" (MD) o "group" (chat grupal)
• match.peer.id: Open ID de usuario (ou_xxx) o ID de grupo (oc_xxx)

​

Referencia de configuración

​

Tipos de mensajes compatibles

​

Recibir

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

​

Enviar

• ✅ Texto
• ✅ Imágenes
• ✅ Archivos
• ✅ Audio
• ✅ Video/multimedia
• ✅ Tarjetas interactivas (incluidas actualizaciones de streaming)
• ⚠️ Texto enriquecido (formato estilo post; no admite todas las capacidades de autoría de Feishu/Lark)

​

Hilos y respuestas

• ✅ Respuestas en línea
• ✅ Respuestas en hilos
• ✅ Las respuestas multimedia permanecen conscientes del hilo al responder a un mensaje de hilo

​

Relacionado

• Resumen de canales - todos los canales compatibles
• Emparejamiento - autenticación de DM y flujo de emparejamiento
• Grupos - comportamiento del chat grupal y control de menciones
• Enrutamiento de canales - enrutamiento de sesión para mensajes
• Seguridad - modelo de acceso y endurecimiento