Feishu

​

Inicio rápido

openclaw channels login --channel feishu

openclaw gateway restart

​

Control de acceso

​

Mensajes directos

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

​

Chats grupales

• Predeterminado: se requiere @mención, excepto cuando la política de grupo efectiva es "open"; ahí el valor predeterminado es false para que los mensajes que no pueden llevar menciones (por ejemplo, imágenes) aun lleguen al agente.
• Establécelo explícitamente en true o false para anularlo; anulación por grupo: channels.feishu.groups.<chat_id>.requireMention.
• Los mensajes de difusión @all y @_all no se tratan como menciones al bot. Un mensaje que menciona tanto a @all como al bot directamente 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", // requireMention defaults to false under "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",
      // 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 IDs de grupo/usuario

​

IDs de grupo (chat_id, formato: oc_xxx)

​

IDs 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 esté agregado 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 a eventos incluya im.message.receive_v1
3. Asegúrate de que esté seleccionada la conexión persistente (WebSocket)
4. Asegúrate de que todos los ámbitos de permiso requeridos estén concedidos
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

​

Se filtró el App Secret

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: 4000 caracteres)
• chunkMode - "length" (predeterminado) divide en el límite; "newline" prefiere límites de salto de línea
• 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 búsquedas de perfiles de remitentes

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

​

Alcance de sesión de grupo e hilos de temas

​

Herramientas de espacio de trabajo de Feishu

​

Sesiones ACP

​

Vinculación ACP persistente

{
  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

/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" (DM) o "group" (chat de grupo)
• match.peer.id: Open ID del usuario (ou_xxx) o ID de grupo (oc_xxx)

​

Aislamiento de agente por usuario (Creación dinámica de agentes)

• Directorio de workspace independiente
• USER.md / SOUL.md / MEMORY.md separados
• Historial de conversación privado
• Skills y estado aislados

​

Configuración rápida

{
  channels: {
    feishu: {
      dmPolicy: "open",
      allowFrom: ["*"],
      dynamicAgentCreation: {
        enabled: true,
        workspaceTemplate: "~/.openclaw/workspace-{agentId}",
        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",
      },
    },
  },
  session: {
    // Critical: makes each user's DM their "main session"
    // Automatically loads USER.md / SOUL.md / MEMORY.md
    // For stronger isolation, use "per-channel-peer" instead
    dmScope: "main",
  },
}

​

Cómo funciona

1. El canal genera un agentId único: feishu-{user_open_id} para la cuenta predeterminada, o un resumen de identidad acotado con prefijo de cuenta para una cuenta con nombre
2. Crea un nuevo workspace en la ruta workspaceTemplate
3. Registra el agente y crea una vinculación para este usuario
4. El ayudante del workspace garantiza los archivos de arranque (AGENTS.md, SOUL.md, USER.md, etc.) en el primer acceso
5. Enruta todos los mensajes futuros de este usuario a su agente dedicado

​

Opciones de configuración

• {agentId} - el ID de agente generado (por ejemplo, feishu-ou_xxxxxx o feishu-support-<identity_digest>)
• {userId} - el open_id de Feishu del remitente (por ejemplo, ou_xxxxxx)

​

Ámbito de sesión

​

Despliegue multiusuario típico

{
  channels: {
    feishu: {
      appId: "cli_xxx",
      appSecret: "xxx",
      dmPolicy: "open",
      allowFrom: ["*"],
      groupPolicy: "open",
      requireMention: true,
      dynamicAgentCreation: {
        enabled: true,
        workspaceTemplate: "~/.openclaw/workspace-{agentId}",
        agentDirTemplate: "~/.openclaw/agents/{agentId}/agent",
      },
    },
  },
  session: {
    // Choose dmScope based on your isolation needs:
    // "main" for bootstrap auto-loading, "per-channel-peer" for stronger isolation
    dmScope: "main",
  },
  bindings: [], // Empty - dynamic agents auto-bind
}

​

Verificación

feishu: creating dynamic agent "feishu-ou_xxxxxx" for user ou_xxxxxx
  workspace: /home/user/.openclaw/workspace-feishu-ou_xxxxxx
  agentDir: /home/user/.openclaw/agents/feishu-ou_xxxxxx/agent

ls -la ~/.openclaw/workspace-*

​

Notas

• Aislamiento del workspace: Cada usuario obtiene su propio directorio de workspace e instancia de agente. Los usuarios no pueden ver el historial de conversación ni los archivos de otros usuarios dentro del flujo normal de mensajería.
• Límite de seguridad: Este es un mecanismo de aislamiento de contexto de mensajería, no un límite de seguridad frente a coarrendatarios hostiles. El proceso del agente y el entorno del host son compartidos.
• Las escrituras de configuración deben permanecer habilitadas: La creación dinámica de agentes escribe agentes y vinculaciones en la configuración; se omite cuando channels.feishu.configWrites es false (predeterminado: habilitado).
• bindings debe estar vacío: Los agentes dinámicos registran automáticamente sus propias vinculaciones
• Ruta de actualización: Las vinculaciones manuales existentes siguen funcionando junto con los agentes dinámicos
• session.dmScope es global: Esto afecta a todos los canales, no solo a Feishu

​

Referencia de configuración

​

Tipos de mensaje admitidos

​

Recibir

• ✅ Texto
• ✅ Texto enriquecido (post)
• ✅ Imágenes
• ✅ Archivos
• ✅ Audio
• ✅ Vídeo/medios
• ✅ Stickers

​

Enviar

• ✅ Texto
• ✅ Imágenes
• ✅ Archivos
• ✅ Audio
• ✅ Vídeo/medios
• ✅ Tarjetas interactivas (incluidas actualizaciones en streaming)
• ⚠️ Texto enriquecido (formato de 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 con medios siguen teniendo en cuenta el hilo al responder a un mensaje de hilo

​

Relacionado

• Resumen de canales - todos los canales admitidos
• Emparejamiento - autenticación de DM y flujo de emparejamiento
• Grupos - comportamiento de chats grupales y control de menciones
• Enrutamiento de canales - enrutamiento de sesión para mensajes
• Seguridad - modelo de acceso y refuerzo de seguridad