Canal Feishu / Lark do OpenClaw
Conecte o OpenClaw ao Feishu (飞书) ou Lark via assinatura de eventos baseada em WebSocket. Esta integração empresarial permite que seu assistente de IA gerencie mensagens diretas e chats em grupo no Feishu/Lark — a plataforma líder de colaboração empresarial da ByteDance. O OpenClaw se conecta pelo modo de conexão longa (WebSocket) da plataforma aberta do Feishu, sem necessidade de URL pública ou endpoint Webhook.
Feishu / Lark Recursos suportados
Mensagens de texto
Suportado
Mídia e arquivos
Suportado
Reações
Não suportado
Threads
Não suportado
Mensagens de voz
Não suportado
Chat em grupo
Suportado
Feishu / Lark Pré-requisitos
- Uma conta de tenant Feishu (feishu.cn) ou Lark (larksuite.com) com permissões de criação de apps
- O plugin Feishu instalado: openclaw plugins install @openclaw/feishu
- OpenClaw Gateway em execução e configurado
- Node.js 18+ instalado no seu servidor
Feishu / Lark Configuração rápida
Criar um app Feishu/Lark
Acesse a plataforma aberta do Feishu (open.feishu.cn/app) ou o console de desenvolvedor Lark (open.larksuite.com/app). Crie um novo app empresarial, defina nome, descrição e ícone. Copie o App ID (formato: cli_xxx) e App Secret da página de credenciais.
Configurar permissões e capacidade de bot
Na gestão de permissões do app, importe em lote as permissões necessárias. Ative a capacidade de bot em Capacidades do App > Bot. Na assinatura de eventos, selecione 'Usar conexão longa' (modo WebSocket) e adicione o evento im.message.receive_v1. Publique o app via Gestão de Versões e Publicação.
Adicionar configuração do canal Feishu ao OpenClaw
Execute 'openclaw channels add' e selecione Feishu, ou adicione manualmente a configuração do canal em ~/.openclaw/openclaw.json com appId e appSecret. Você também pode usar as variáveis de ambiente FEISHU_APP_ID e FEISHU_APP_SECRET.
Iniciar o Gateway e testar
Execute 'openclaw gateway' para iniciar o serviço. Envie uma mensagem direta ao bot no Feishu. Se estiver usando a política de pareamento padrão, aprove o remetente com 'openclaw pairing approve feishu <code>' no terminal.
Feishu / Lark Exemplo de configuração
{
"channels": {
"feishu": {
"enabled": true,
"dmPolicy": "pairing",
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "YOUR_APP_SECRET",
"botName": "My AI Assistant"
}
}
}
}
}Feishu / Lark Documentação Detalhada
Visão geral da arquitetura
Criação do app Feishu e obtenção de credenciais
# Via variáveis de ambiente
export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="your_app_secret"
# Ou via assistente CLI
openclaw channels addConfiguração Feishu vs Lark
{
"channels": {
"feishu": {
"domain": "lark",
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "YOUR_APP_SECRET"
}
}
}
}
}Políticas de DM
{
"channels": {
"feishu": {
"dmPolicy": "allowlist",
"allowFrom": ["ou_xxx", "ou_yyy"]
}
}
}Gerenciamento de chats em grupo
{
"channels": {
"feishu": {
"groupPolicy": "open",
"requireMention": true
}
}
}Respostas em streaming (cartões interativos)
{
"channels": {
"feishu": {
"streaming": true
}
}
}Tipos de mensagem e suporte a mídia
{
"channels": {
"feishu": {
"mediaMaxMb": 30,
"textChunkLimit": 2000
}
}
}Multi-conta e roteamento multi-agente
{
"channels": {
"feishu": {
"accounts": {
"support": {
"appId": "cli_aaa",
"appSecret": "secret_a",
"botName": "Support Bot"
},
"hr": {
"appId": "cli_bbb",
"appSecret": "secret_b",
"botName": "HR Bot"
}
}
}
}
}Comandos úteis
Feishu / Lark Referência de Configuração
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | Ativar ou desativar o canal Feishu |
| domain | string | "feishu" | Domínio API: 'feishu' para doméstico (feishu.cn) ou 'lark' para internacional (larksuite.com) |
| dmPolicy | string | "pairing" | Controla quem pode enviar DMs ao bot. Opções: pairing, allowlist, open, disabled |
| allowFrom | string[] | [] | Open IDs (ou_xxx) permitidos quando dmPolicy é 'allowlist' |
| groupPolicy | string | "open" | Política de chat em grupo. Opções: open, allowlist, disabled |
| requireMention | boolean | true | Se o bot requer @menção para responder em grupos |
| streaming | boolean | true | Ativar respostas IA em streaming via cartões interativos |
| textChunkLimit | number | 2000 | Máximo de caracteres por mensagem de texto |
| mediaMaxMb | number | 30 | Tamanho máximo de arquivo de mídia em megabytes |
| accounts.<id>.appId | string | "" | App ID do Feishu (formato: cli_xxx) |
| accounts.<id>.appSecret | string | "" | App Secret do Feishu |
| accounts.<id>.botName | string | "" | Nome de exibição do bot nos chats do Feishu |
| historyLimit | number | 50 | Número de mensagens recentes incluídas como contexto IA |
Ativar ou desativar o canal Feishu
Domínio API: 'feishu' para doméstico (feishu.cn) ou 'lark' para internacional (larksuite.com)
Controla quem pode enviar DMs ao bot. Opções: pairing, allowlist, open, disabled
Open IDs (ou_xxx) permitidos quando dmPolicy é 'allowlist'
Política de chat em grupo. Opções: open, allowlist, disabled
Se o bot requer @menção para responder em grupos
Ativar respostas IA em streaming via cartões interativos
Máximo de caracteres por mensagem de texto
Tamanho máximo de arquivo de mídia em megabytes
App ID do Feishu (formato: cli_xxx)
App Secret do Feishu
Nome de exibição do bot nos chats do Feishu
Número de mensagens recentes incluídas como contexto IA
Feishu / Lark Perguntas Frequentes
Feishu / Lark Solução de Problemas
O bot pode não ter sido adicionado ao grupo, a @menção não está funcionando, ou groupPolicy está em 'disabled'.
O app pode não estar publicado, a assinatura de eventos não está configurada, ou faltam permissões.
A permissão im:message:send_as_bot pode não ter sido concedida.
O App Secret foi acidentalmente commitado no controle de versão.
Instabilidade de rede ou firewall interferindo nas conexões WebSocket.