Saltar para o conteúdo principal
Conecte o Feishu (飞书) ou o Lark à sua instância Claw. Utiliza o modo WebSocket — não é necessária uma URL de retorno pública.

​
Pré-requisitos

​
Guia de Configuração

1

Criar um Aplicativo Feishu

  1. Acesse a Plataforma Aberta do Feishu (ou Lark Developer)
  2. Clique em Create Custom App
  3. Insira um nome e descrição para o aplicativo
  4. Clique em Create
2

Adicionar Capacidade de Bot

  1. Nas configurações do seu aplicativo, vá em Features → Bot
  2. Habilite a capacidade de bot
  3. Isso permite que seu aplicativo receba e envie mensagens
3

Obter Credenciais

  1. Vá em Credentials & Basic Info
  2. Copie o App ID (começa com cli_)
  3. Copie o App Secret
4

Configurar Assinatura de Eventos

  1. Vá em Event Subscriptions
  2. Selecione o modo WebSocket (recomendado — nenhuma URL pública é necessária)
  3. Se solicitado, defina a Encrypt Key e o Verification Token
Ao configurar o Feishu no painel da LemonData, a Encrypt Key e o Verification Token são gerados automaticamente para você. Copie esses valores no console de desenvolvedor do Feishu.
5

Adicionar Permissões de Evento

  1. Em Event Subscriptions, adicione estes eventos:
    • im.message.receive_v1 — Receber mensagens
  2. Vá em Permissions & Scopes e adicione:
    • im:message — Enviar e receber mensagens
    • im:message.group_at_msg — Receber @menções em grupos
  3. Clique em Save
6

Publicar o Aplicativo

  1. Vá em App Release → Version Management
  2. Crie uma nova versão
  3. Envie para revisão (para aplicativos internos, isso costuma ser instantâneo)
  4. Uma vez aprovado, o aplicativo estará ativo
7

Configurar no Painel da LemonData

  1. Acesse o seu Painel Claw
  2. Clique no ícone de configurações na sua instância
  3. Abra a aba IM Integrations
  4. Expanda a seção Feishu
  5. Cole seu App ID e App Secret
  6. Copie a Encrypt Key e o Verification Token gerados automaticamente de volta para o console de desenvolvedor do Feishu
  7. Clique em Salvar
8

Começar a Conversar

  1. No Feishu, pesquise pelo seu bot pelo nome
  2. Envie uma mensagem para ele
  3. O primeiro usuário é pareado automaticamente como o proprietário — sem necessidade de código!
  4. Comece a conversar com a IA!

​
Configurações de Grupo

Configure o comportamento do chat em grupo na aba IM Integrations do seu Painel:
ConfiguraçãoOpçõesDescrição
Política de GrupoAberto (padrão) / Lista de permissões / DesativadoControla quem pode acionar o bot em grupos
Exigir @mençãoAtivado / DesativadoO bot só responde quando é @mencionado
IDs de GrupoLista de IDs de chatRestringir a grupos específicos (vazio = todos os grupos)
Usuários Permitidos no GrupoLista de Open IDsApenas estes usuários podem acionar o bot (modo de lista de permissões)

​
Solução de Problemas

  • Verifique se o aplicativo foi publicado e aprovado
  • Verifique se o evento im.message.receive_v1 está assinado
  • Certifique-se de que o modo WebSocket está selecionado (não HTTP)
  • Verifique se a Encrypt Key e o Verification Token coincidem entre o console do Feishu e a configuração do Claw
  • Isso geralmente significa que o App ID ou o App Secret está incorreto
  • Verifique novamente as credenciais no seu painel