Canal DingTalk do OpenClaw

O OpenClaw se conecta ao DingTalk pelo modo Stream (conexão longa WebSocket) da plataforma aberta. Diferente dos webhooks tradicionais, no modo Stream o Gateway inicia ativamente uma conexão WebSocket com os servidores do DingTalk, recebendo eventos em tempo real, sem necessidade de IP público ou domínio. Fluxo de mensagens: Usuário envia mensagem no DingTalk → Plataforma aberta DingTalk → Push Stream para o Gateway → OpenClaw processa com IA → Resposta via API Bot DingTalk → Mensagem entregue no DingTalk. Esta arquitetura é ideal para implantações auto-hospedadas atrás de NAT ou firewalls corporativos. O Gateway mantém automaticamente a conexão e gerencia reconexões (estratégia de recuo exponencial).

Existem dois plugins comunitários populares para integração com o DingTalk: • @soimy/dingtalk — O plugin mais popular, mantido ativamente pela comunidade. Suporta formatos de resposta Markdown e AI Card, com funcionalidades completas e estáveis. • @dingtalk-real-ai/dingtalk-connector — Projeto associado ao DingTalk oficial, focado em respostas em streaming via AI Card, com suporte a roteamento multi-agente e modo assíncrono. Requer OpenClaw v0.7.7+. Ambos os plugins usam o modo Stream para conexão, com experiência central idêntica. Recomendação: iniciantes devem usar a versão @soimy (mais documentação disponível); para multi-agente ou processamento assíncrono, use a versão @dingtalk-real-ai.

# Instalar versão @soimy (recomendada)
openclaw plugins install @soimy/dingtalk

# Ou instalar versão @dingtalk-real-ai
openclaw plugins install @dingtalk-real-ai/dingtalk-connector

A configuração requer a criação de um app na plataforma aberta do DingTalk: 1. Acesse a plataforma aberta do DingTalk em open-dev.dingtalk.com e entre no painel do desenvolvedor. 2. Clique em 'Criar app', selecione 'Desenvolvimento interno empresarial' → tipo 'Bot'. 3. Preencha o nome e descrição do app. Após a criação, copie o ClientID (AppKey, formato dingXXX) e o ClientSecret (AppSecret) na página 'Credenciais e informações básicas'. 4. Em 'Configuração do bot', selecione **modo Stream** para recebimento de mensagens (não modo HTTP). 5. Na gestão de permissões, adicione as permissões necessárias: - qyapi_robot_sendmsg (envio de mensagens pelo bot) - Card.Instance.Write (escrita de instância de cartão) - Card.Streaming.Write (escrita de cartão em streaming) - mediaId.download e mediaId.upload (upload e download de mídia) 6. Publique o app e aguarde a aprovação do administrador da organização.

# Via variáveis de ambiente
export DINGTALK_CLIENT_ID="dingXXXXXX"
export DINGTALK_CLIENT_SECRET="your_app_secret"

# Ou via CLI
openclaw channels add

O plugin DingTalk suporta configuração flexível de políticas de mensagens: **Política de DM (dmPolicy)**: • open — Qualquer pessoa que enviar DM ao bot recebe resposta • disabled — Funcionalidade de DM desativada **Política de grupo (groupPolicy)**: • open — Qualquer membro do grupo pode acionar o bot com @menção • disabled — Mensagens de grupo completamente ignoradas Por padrão, em chats de grupo é necessário @mencionar o bot para acionar uma resposta, evitando responder a cada mensagem em grupos ativos.

{
  "channels": {
    "dingtalk": {
      "dmPolicy": "open",
      "groupPolicy": "open"
    }
  }
}

O plugin DingTalk suporta vários formatos de resposta: • **Texto (text)** — Resposta em texto simples, o mais básico • **Markdown** — Suporta títulos, listas, links e conteúdo formatado, recomendado por padrão • **AI Card (streaming)** — Efeito de digitação similar ao ChatGPT, mensagem atualizada progressivamente no cartão O streaming via AI Card oferece a melhor experiência do usuário — a mensagem é atualizada no local, sem gerar múltiplas mensagens. Requer permissões Card na aplicação DingTalk.

{
  "channels": {
    "dingtalk": {
      "messageType": "markdown",
      "streaming": true
    }
  }
}

O plugin DingTalk do OpenClaw processa vários tipos de mensagem: **Recebimento**: Texto, imagens, áudio (reconhecimento automático de voz), vídeo, arquivos **Análise de arquivos**: Formatos .docx, .pdf, .txt, .md, .json, .xlsx, .pptx, .zip podem ser lidos e analisados pela IA **Envio**: Texto, Markdown, AI Card, imagens, arquivos Mensagens de áudio são automaticamente convertidas em texto antes de serem processadas pela IA, sem configuração adicional.

Com a versão @dingtalk-real-ai do plugin, você pode configurar roteamento multi-agente para que diferentes agentes IA processem diferentes tipos de conversa. Por exemplo, DMs podem usar um assistente geral enquanto grupos específicos usam um agente especializado. Através da configuração de bindings do OpenClaw, você tem controle granular sobre a atribuição de agentes para cada conversa.

{
  "bindings": [
    { "agentId": "main", "match": { "channel": "dingtalk", "peer": { "kind": "direct" } } },
    { "agentId": "tech-support", "match": { "channel": "dingtalk", "peer": { "kind": "group" } } }
  ]
}

O OpenClaw fornece vários comandos para gerenciar o bot DingTalk: • openclaw gateway status — Verificar status de conexão do Gateway • openclaw gateway restart — Reiniciar serviço Gateway • openclaw logs --follow — Ver logs em tempo real • openclaw channels add — Adicionar canal interativamente • openclaw plugins list — Ver plugins instalados • openclaw plugins update @soimy/dingtalk — Atualizar plugin DingTalk • openclaw doctor — Diagnóstico completo