Como configurar 13 canais do OpenClaw para um assistente de IA multiplataforma

Você pede à IA que organize a agenda de reuniões pelo WhatsApp. Ao chegar à empresa e abrir o Slack, ela já não se lembra do que vocês discutiram pela manhã. À noite, a equipe se reúne no Discord e o problema se repete: é preciso explicar todo o contexto do projeto outra vez. Um assistente de IA multiplataforma deveria reconhecer o usuário em todos esses lugares.

A arquitetura da camada Channel do OpenClaw resolve isso normalizando as mensagens. Você faz uma única implantação e conecta o assistente a 13 plataformas, como Telegram, WhatsApp, Discord e Slack, com conversas sincronizadas entre elas. Stickers do Telegram, embeds do Discord e áudios do WhatsApp são convertidos para um formato comum.

Aqui mostro como configurei três plataformas: Telegram, com um Token obtido em 5 minutos; WhatsApp, com pareamento por QR code; e Discord, com as permissões necessárias para o Bot. Também explico a sincronização de sessões entre plataformas e as configurações de segurança que fizeram diferença no uso diário.

Guia econômico para criar seu “crustáceo”: ArkClaw torna os agentes de IA realmente acessíveis

O OpenClaw, também conhecido como “lagosta”, está em alta, mas a configuração afasta muita gente. O ArkClaw, da Volcano Engine da ByteDance, reduz bastante essa barreira. Sem precisar configurar servidor nem Token, você cria com um clique um assistente de IA disponível 24 horas por dia, capaz de controlar o navegador, executar scripts e gerenciar o calendário.

O principal atrativo é o preço: a mensalidade custa apenas 9,9 yuans e, com o meu código de convite ZLKUK54M (cadastre-se aqui), cai para 8,9 yuans. Para quem programa, o Coding Plan Pro ainda oferece acesso gratuito.

Como funciona a arquitetura da camada Channel do OpenClaw?

Quando comecei a estudar o OpenClaw, fiquei curioso: stickers do Telegram, embeds do Discord e mensagens de voz do WhatsApp usam formatos completamente diferentes. Como o OpenClaw faz todos eles “falarem a mesma língua”?

A resposta está na camada Channel Adapters.

Como a normalização de mensagens funciona

Imagine que você envie um sticker no Telegram, uma mensagem embed com imagem no Discord e um áudio no WhatsApp. Cada plataforma representa esses conteúdos com estruturas de dados diferentes, mas os Channel Adapters os convertem para um formato unificado que o OpenClaw consegue processar.

Na prática:

• Stickers do Telegram → anexos de imagem padronizados
• Embeds do Discord → combinação de texto e mídia após a análise
• Reactions do WhatsApp → texto com emoji
• Mensagens de voz → arquivo de áudio extraído e transcrito, se esse recurso estiver configurado

Todo esse processo é transparente. Você só precisa enviar a mensagem na plataforma que quiser, e o OpenClaw cuida da conversão do formato.

Gateway Server: o centro de distribuição

Depois de normalizada, a mensagem entra no Gateway Server. Esse é o núcleo do OpenClaw e tem três responsabilidades:

1. Session Router (roteador de sessões): decide para qual sessão a mensagem deve ir. É uma DM pessoal? Um grupo da equipe? Ou a mesma conversa iniciada em outra plataforma?
2. Lane Queue (fila por faixa): controla a concorrência. Se você enviar mensagens em três plataformas ao mesmo tempo, a Lane Queue evita conflitos e as processa na ordem.
3. Encaminhamento de mensagens: envia a resposta da IA de volta para a plataforma e para a pessoa corretas.

Sendo sincero, as opções do Session Router me confundiram no começo. O que significavam per-channel-peer e per-account-channel-peer? Mais adiante explico essas estratégias. Por enquanto, basta saber que o Gateway permite começar uma conversa no WhatsApp e continuar no Telegram sem interrupção.

Entre 13 plataformas, qual você quer usar?

Atualmente, o OpenClaw é compatível com estas plataformas:

• Mensagens instantâneas: WhatsApp, Telegram, Signal e iMessage, por meio do BlueBubbles
• Colaboração em equipe: Slack, Microsoft Teams, Google Chat e Discord
• Outras: Matrix, Zalo, Twitch e WebChat

Eu uso Telegram para conversas pessoais, WhatsApp com familiares e amigos e Discord para comunidades técnicas. Você pode escolher de acordo com seu próprio cenário.

Configuração prática de três plataformas em 15 minutos

Chega de teoria. Vamos configurar.

Instalação e configuração inicial

Abra o terminal e execute estes dois comandos:

npm install -g openclaw@latest
openclaw onboard --install-daemon

O comando onboard fará algumas perguntas:

1. Qual provedor de IA você quer usar: Claude, GPT, Gemini ou um modelo local? Escolhi Claude porque já estava acostumado com ele.
2. Qual é a chave da API? Cole a chave e não inclua espaços nem aspas.
3. Qual porta o Gateway deve usar? Mantenha a padrão, 18789.

Após alguns minutos, você verá:

✓ Gateway WebSocket server started on ws://127.0.0.1:18789
✓ Control UI available at http://localhost:18789

Pronto: o OpenClaw já está funcionando no seu computador.

Nota de segurança: por padrão, a Control UI só pode ser acessada por localhost. Em um servidor remoto, use um túnel SSH:

Railway - Plataforma de deploy moderna, sem ops complexas, no ar em minutos

Começar agora →Anúncio

ssh -N -L 18789:127.0.0.1:18789 your-server

Telegram: a configuração mais simples para começar

Comecemos pelo Telegram, que é o mais rápido.

1. Crie o Bot:

   • Abra o Telegram e procure por @BotFather
   • Envie /newbot
   • Dê um nome ao Bot, como “Meu assistente OpenClaw”
   • Copie o Token, semelhante a 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

2. Configure o OpenClaw:

   openclaw config set telegram.token "YOUR_BOT_TOKEN"

   Substitua YOUR_BOT_TOKEN pelo Token que você acabou de obter.

3. Verifique a configuração:

   • Procure o nome do seu Bot no Telegram
   • Envie /start
   • Se o Bot responder, a configuração funcionou

Na primeira vez que fiz isso, o Bot não respondeu. Descobri que havia copiado uma quebra de linha junto com o Token. Por isso, verifique se há caracteres extras antes ou depois do Token.

WhatsApp: pareamento por QR code

O WhatsApp exige um pouco mais de trabalho porque usa o mecanismo de pareamento com o celular.

1. Inicie o pareamento:

   openclaw config set whatsapp.enabled true
   openclaw gateway restart

2. Leia o QR code:

   • Um QR code será exibido no terminal
   • Abra o WhatsApp → Configurações → Aparelhos conectados → Conectar um aparelho
   • Leia o QR code mostrado no terminal

3. Aguarde a conexão:
   Quando aparecer “WhatsApp connected”, o processo terminou.

Pontos de atenção:

• O celular e o computador precisam estar on-line para o OpenClaw enviar e receber mensagens, uma limitação do WhatsApp
• Se o QR code expirar, execute openclaw gateway restart novamente
• O OpenClaw usa a biblioteca Baileys e segue o protocolo WhatsApp Web. Até agora, a plataforma não bloqueou oficialmente esse uso, mas as políticas podem mudar; avalie o risco antes de adotar a solução

No começo, fiquei preocupado com a possibilidade de o WhatsApp bloquear minha conta. Na prática, o uso normal, sem envio em massa de spam, não causou problemas. Afinal, o mecanismo é o mesmo do WhatsApp Web.

Discord: as permissões são essenciais

No Discord, é preciso criar uma aplicação no Developer Portal, então há mais etapas.

1. Crie a aplicação:

   • Acesse https://discord.com/developers/applications
   • Clique em “New Application” e dê um nome a ela
   • Abra a página “Bot” e clique em “Add Bot”
   • Copie o Token

2. Defina as permissões:
   Esta etapa é importante. Sem as permissões corretas, o Bot não recebe mensagens.

   • Abra “OAuth2 → URL Generator”
   • Em Scopes, marque bot
   • Em Bot Permissions, marque:
     • Read Messages/View Channels
     • Send Messages
     • Read Message History
     • Attach Files
   • Copie o URL gerado, abra-o no navegador e convide o Bot para o seu servidor

3. Configure o OpenClaw:

   openclaw config set discord.token "YOUR_DISCORD_BOT_TOKEN"
   openclaw config set discord.guildId "YOUR_SERVER_ID"

   Como obter o Guild ID?

   • Ative o modo de desenvolvedor no Discord em Configurações → Avançado → Modo de desenvolvedor
   • Clique com o botão direito no ícone do servidor → Copiar ID

4. Teste:

   • Mencione o Bot com @ em qualquer canal do Discord
   • Envie uma mensagem e veja se ele responde

Na minha primeira configuração do Discord, o Bot não respondia de jeito nenhum. Depois de verificar tudo, descobri que faltava a permissão Read Message History. Não pule a etapa das permissões.

Como fazer a IA lembrar de você em todas as plataformas

Depois de configurar as três plataformas, surge uma dúvida: ao terminar uma conversa com a IA no Telegram e mudar para o Discord, como ela saberá que você é a mesma pessoa?

Esse é o papel do Session Router.

Sessão main e sessões isoladas

A estratégia padrão do OpenClaw é simples: todas as DMs, ou conversas privadas, entram na mesma sessão main.

Isso significa que as conversas privadas com a IA no Telegram, WhatsApp e Discord compartilham o mesmo histórico. A IA se lembra do que você disse em qualquer uma dessas plataformas.

Mas essa configuração não funciona quando o OpenClaw é usado por várias pessoas de uma equipe: as mensagens de todo mundo acabam misturadas. Nesse caso, use uma estratégia de isolamento:

openclaw config set session.dmScope "per-channel-peer"

Essa configuração cria uma sessão independente para cada usuário de cada plataforma.

Há também uma opção ainda mais específica:

openclaw config set session.dmScope "per-account-channel-peer"

Ela é adequada para quem gerencia várias contas do OpenClaw.

No meu uso pessoal, mantenho a sessão main padrão, porque justamente quero que a IA se lembre de mim em todas as plataformas.

Vínculo de identidades entre plataformas

Às vezes, você quer informar explicitamente ao OpenClaw que “@username no Telegram e +86xxx no WhatsApp pertencem à mesma pessoa”.

Configure session.identityLinks:

session:
  identityLinks:
    - platforms:
        telegram: "@your_username"
        whatsapp: "+8613800138000"
        discord: "123456789012345678"  # Discord User ID

Assim, independentemente da plataforma usada para enviar uma mensagem, o OpenClaw reconhece você e continua a mesma conversa.

Comandos úteis para sessões

Quer recomeçar depois de uma conversa longa com a IA? Ou conferir qual modelo está ativo? Estes comandos ajudam:

• /status - mostra o modelo atual, o consumo de tokens e a duração da sessão
• /new - redefine a sessão e apaga o histórico
• /activation mention - faz a IA responder em grupos somente quando é mencionada com @
• /activation always - responde a todas as mensagens do grupo; use com cuidado, pois gera muito ruído

Há também comandos de ferramentas disponíveis na página Sessions da Control UI:

• sessions_list - lista todas as sessões ativas
• sessions_history - exporta o histórico das conversas
• sessions_send - envia manualmente uma mensagem para determinada sessão

Sendo sincero, /new é o que mais uso. Às vezes, quando a IA interpreta algo de forma errada, redefinir a sessão é mais rápido do que corrigir o contexto.

Configuração de segurança para evitar o uso indevido da sua IA

Depois de alguns dias usando tudo sem problemas, notei que a cobrança da API tinha disparado. Ao verificar os logs, descobri que um desconhecido estava fazendo chamadas sem parar pelo meu Bot.

Foi isso que me levou a estudar as políticas de segurança do OpenClaw com mais atenção.

Pareamento de DMs: a proteção padrão

O valor padrão de dmPolicy no OpenClaw é pairing, ou modo de pareamento.

O que isso significa? Quando um desconhecido envia uma DM ao seu Bot pela primeira vez, o Bot não responde. Em vez disso, gera um código de pareamento de seis caracteres e o registra no log. Você precisa aprová-lo manualmente:

openclaw pairing approve telegram ABC123

O código expira em uma hora para dificultar ataques de força bruta. Depois da aprovação, o usuário pode usar o Bot normalmente.

Alibaba Cloud - Escolha dos desenvolvedores, 15% de desconto exclusivo em Lighthouse

Ganhar 15% off →Anúncio

No começo, achei esse mecanismo um pouco trabalhoso. Depois entendi o motivo: sem essa proteção, qualquer pessoa que encontre o nome de usuário do Bot pode consumir sua API sem limite e gerar custos para você.

Como escolher entre as quatro políticas de DM

O OpenClaw oferece quatro políticas:

Se você quiser criar um Bot público para uma comunidade, pode usar o modo open, mas é altamente recomendável monitorar o consumo de tokens para evitar abuso.

Para configurar:

openclaw config set dmPolicy "allowlist"
openclaw config set dmAllowlist "telegram:@friend1,whatsapp:+8613800138000"

Isolamento de grupos em sandbox contra comandos maliciosos

O agente de IA do OpenClaw pode executar ferramentas, como comandos bash e operações em arquivos. Mas o que acontece se alguém em um grupo pedir à IA que execute rm -rf /?

A estratégia de sandbox para grupos existe justamente para impedir isso.

openclaw config set agents.defaults.sandbox.mode "non-main"

Essa configuração executa a IA das sessões que não sejam main, como grupos, em um sandbox do Docker sem acesso ao sistema de arquivos da máquina host.

Também é possível personalizar as ferramentas permitidas e proibidas:

agents:
  defaults:
    sandbox:
      mode: "non-main"
      allowedTools:
        - web_search
        - calculator
      deniedTools:
        - bash
        - file_write

Na minha configuração, grupos só podem usar pesquisa e calculadora; bash e operações em arquivos ficam bloqueados. Assim, preservo os recursos úteis e mantenho os riscos sob controle.

Controle por menção para evitar respostas em excesso

Depois de adicionar a IA a um servidor do Discord, permitir que ela responda a toda mensagem gera muito ruído.

A estratégia activation: mention faz a IA responder somente quando alguém a menciona com @:

openclaw config set agents.defaults.activation "mention"

Desse modo, a IA se comporta como um participante silencioso: basta mencioná-la quando precisar.

Lista de verificação de segurança:

openclaw doctor

Esse comando examina sua configuração e sinaliza possíveis riscos:

• ✗ dmPolicy: open without rate limiting
• ✗ sandbox.mode: disabled in group sessions
• ✓ API key properly configured
• ✓ DM pairing enabled

Executar doctor uma vez pode evitar muitos problemas de segurança.

Problemas comuns e como resolvê-los

É normal encontrar obstáculos durante a configuração. Estes foram os problemas que enfrentei.

Problema 1: chave da API

Sintoma: o Bot inicia, mas não responde às mensagens, e o log mostra Invalid API key.

Causas:

1. A chave da API foi copiada com espaços ou aspas
2. A variável de ambiente não entrou em vigor; tente reiniciar o terminal
3. A conta da API não tem uma forma de pagamento cadastrada, exigida tanto pelo Claude quanto pelo GPT

Solução:

# Defina novamente, sem caracteres extras
openclaw config set anthropic.apiKey "sk-ant-..."

# Verifique se a configuração entrou em vigor
openclaw config get anthropic.apiKey

# Reinicie o Gateway
openclaw gateway restart

Problema 2: conflito de porta

Sintoma: openclaw gateway start retorna o erro Port 18789 already in use.

Causa: o processo anterior do Gateway ainda está em execução.

Solução:

# Encerre normalmente
openclaw gateway stop

# Se não funcionar, force o encerramento do processo
pkill -f openclaw-gateway

# Inicie novamente
openclaw gateway start

Problema 3: acesso à Control UI

Sintoma: ao abrir http://localhost:18789 no navegador, aparece control ui requires HTTPS or localhost.

Causa: em um servidor remoto, talvez você esteja usando o IP do servidor em vez de localhost.

KiloClaw - OpenClaw gerenciado para empresas: orquestração de agentes IA e roteamento inteligente

Começar →Anúncio

Solução 1: use o parâmetro token

http://your-server-ip:18789?token=YOUR_TOKEN

O Token fica no arquivo ~/.openclaw/gateway.env.

Solução 2: use um túnel SSH

ssh -N -L 18789:127.0.0.1:18789 user@your-server

Depois, acesse http://localhost:18789 localmente.

Problema 4: falha na conexão de um Channel

Telegram:

• Confira a validade do Token no BotFather
• Verifique a rede: em algumas regiões, é preciso usar proxy para acessar a API do Telegram

WhatsApp:

• QR code expirado: execute openclaw gateway restart novamente
• Celular off-line: o WhatsApp precisa que o celular esteja conectado para sincronizar mensagens
• Limite de aparelhos: o WhatsApp aceita no máximo quatro dispositivos conectados

Discord:

• Permissões insuficientes do Bot: verifique Read Message History
• Guild ID incorreto: confirme se você copiou o ID do servidor certo
• Bot fora do servidor: convide-o novamente pelo URL do OAuth2

Problema 5: perda de sessões

Sintoma: depois de reiniciar o Gateway, todo o histórico anterior desaparece.

Causa: atualmente, no início de 2026, o OpenClaw não tem persistência de sessões. Reiniciar o Gateway apaga as sessões mantidas em memória.

Como reduzir o impacto:

• Exporte e salve conversas importantes com sessions_history
• Aguarde uma versão futura com persistência de sessões, recurso já previsto no Roadmap oficial

Sendo sincero, esse é o ponto que mais gostaria de ver melhorado. Sempre que atualizo o OpenClaw, preciso me apresentar outra vez à IA, o que acaba sendo incômodo.

Conclusão

Depois de duas semanas configurando o OpenClaw, minha principal impressão é que ele realmente transforma a IA em um assistente unificado entre plataformas.

Pela manhã, você pode pedir à IA que organize sua agenda no WhatsApp; ao chegar à empresa, continuar a conversa no Slack; e, à noite, colaborar com a equipe no Discord. Todo o contexto acompanha você, algo que um Bot restrito a uma única plataforma não consegue oferecer.

O desenho da camada Channel é inteligente: mensagens de 13 plataformas são normalizadas, o Session Router gerencia as conversas e controles de segurança detalhados limitam o acesso. O resultado é um sistema flexível sem abrir mão da proteção.

O OpenClaw ainda evolui rapidamente. Persistência de sessões, um mercado de Skills e compatibilidade com mais plataformas já aparecem no Roadmap oficial, e quero ver como esses recursos vão amadurecer.

Se você quiser experimentar:

curl -fsSL https://openclaw.ai/install.sh | bash

Em 15 minutos, você pode configurar e testar um assistente de IA multiplataforma.

Se tiver problemas durante a configuração, consulte o GitHub Discussions. A comunidade costuma responder rápido: quando não consegui conectar o Telegram, publiquei uma pergunta e recebi ajuda em dez minutos.

Você usa o OpenClaw? Quais plataformas configurou? Que problemas encontrou? Conte nos comentários.