TL;DR: Conecte o OpenClaw ao WeChat instalando o plugin @tencent-weixin/openclaw-weixin, escaneando um código QR para autorizar sua conta e reiniciando o gateway. A configuração completa leva menos de 5 minutos. O plugin é gratuito, de código aberto e suporta várias contas WeChat simultaneamente.
Introdução
Executar um assistente de IA no WeChat parece complicado. A maioria das soluções exige assinaturas de API caras, configurações de servidor complexas ou contas empresariais. O OpenClaw muda isso.
O plugin @tencent-weixin/openclaw-weixin conecta sua conta pessoal do WeChat ao gateway de IA do OpenClaw em minutos. Nenhuma conta empresarial é necessária. Sem taxas mensais. Basta escanear um código QR e você estará online.
Este guia detalha a configuração completa — desde a instalação do plugin até o gerenciamento de múltiplas contas e o isolamento de contextos de conversa. Ao final, seu WeChat terá um assistente de IA totalmente funcional rodando no OpenClaw.
Pré-requisitos
Antes de começar, você precisa:
- OpenClaw instalado (versão
>=2026.3.22para o plugin v2.0.x) openclawCLI disponível em seu terminal- Uma conta WeChat (conta pessoal funciona — nenhuma empresarial é necessária)
- Node.js instalado (para o instalador de um clique)
Verifique sua versão do OpenClaw:
openclaw --version
Se você estiver em uma versão mais antiga, atualize primeiro. O Plugin v2.0.x requer OpenClaw >=2026.3.22.
Compatibilidade do Plugin
| Versão do Plugin | Versão do OpenClaw | Status |
|---|---|---|
| 2.0.x | >=2026.3.22 |
Ativo |
| 1.0.x | >=2026.1.0 <2026.3.22 |
Manutenção |
O plugin verifica a versão do host na inicialização. Se sua versão do OpenClaw estiver fora do intervalo, o plugin se recusará a carregar.
Passo 1: Instalar o Plugin
Opção A: Instalação com Um Clique (Recomendado)
npx -y @tencent-weixin/openclaw-weixin-cli install
Isso cuida de tudo automaticamente — instalação do plugin, configuração e setup inicial.
Opção B: Instalação Manual
Se o instalador de um clique não funcionar em seu sistema, instale manualmente:
1. Instale o plugin:
openclaw plugins install "@tencent-weixin/openclaw-weixin"
2. Habilite o plugin:
openclaw config set plugins.entries.openclaw-weixin.enabled true
Passo 2: Escanear o Código QR para Autorizar o WeChat
Uma vez que o plugin esteja instalado, faça login com sua conta WeChat:
openclaw channels login --channel openclaw-weixin
Um código QR aparecerá em seu terminal. Abra o WeChat em seu telefone, toque no ícone de digitalização e escaneie o código. Confirme a autorização em seu telefone.
Suas credenciais de login são salvas localmente automaticamente. Não é necessário escanear novamente, a menos que você faça logout.
Passo 3: Reiniciar o Gateway
Após autorizar, reinicie o gateway do OpenClaw para ativar o plugin:
openclaw gateway restart
É isso. Sua conta WeChat agora está conectada ao OpenClaw. Mensagens enviadas para seu WeChat serão processadas pelo agente de IA.
Passo 4: Adicionar Múltiplas Contas WeChat (Opcional)
O OpenClaw suporta múltiplas contas WeChat simultaneamente. Para adicionar outra conta, basta executar o comando de login novamente:
openclaw channels login --channel openclaw-weixin
Cada escaneamento de código QR cria uma nova entrada de conta. Todas as contas rodam em paralelo sem interferir umas com as outras.
Passo 5: Isolar Contextos de Conversa (Opcional)
Por padrão, todos os canais compartilham o mesmo contexto de conversa de IA. Isso significa que suas conversas no WeChat e em outros canais (Telegram, Discord, etc.) compartilham a mesma memória de IA.
Se você quiser que cada conta WeChat tenha seu próprio contexto isolado:
openclaw config set agents.mode per-channel-per-peer
Com essa configuração, cada combinação de "conta WeChat + contato" obtém sua própria memória de IA independente. Conversas entre diferentes contas não se misturarão.
Como o Plugin Funciona por Trás dos Panos
Para desenvolvedores que desejam entender ou estender o plugin, aqui está como ele se comunica com o gateway do OpenClaw.
Cabeçalhos de Autenticação
Todas as solicitações de API usam esses cabeçalhos:
| Cabeçalho | Valor |
|---|---|
Content-Type |
application/json |
AuthorizationType |
ilink_bot_token |
Authorization |
Bearer <token> |
X-WECHAT-UIN |
uint32 aleatório codificado como base64 |
Endpoints Principais da API
O plugin usa 5 endpoints HTTP JSON:
| Endpoint | Caminho | Finalidade |
|---|---|---|
| getUpdates | getupdates |
Long-poll para novas mensagens |
| sendMessage | sendmessage |
Enviar texto/imagem/vídeo/arquivo |
| getUploadUrl | getuploadurl |
Obter URL de upload CDN para mídia |
| getConfig | getconfig |
Obter configuração da conta (typing ticket) |
| sendTyping | sendtyping |
Mostrar/ocultar indicador de digitação |
Recebendo Mensagens (Long Polling)
O plugin usa long polling para receber mensagens:
// Solicitação
{
"get_updates_buf": ""
}
// Resposta
{
"ret": 0,
"msgs": [...],
"get_updates_buf": "<novo_cursor>",
"longpolling_timeout_ms": 35000
}
Passe o cursor get_updates_buf de volta em cada solicitação subsequente para receber apenas novas mensagens.
Enviando Mensagens
{
"msg": {
"to_user_id": "<target_user_id>",
"context_token": "<session_context_token>",
"item_list": [
{
"type": 1,
"text_item": { "text": "Olá!" }
}
]
}
}
Tipos de Mensagem
| Tipo | Valor |
|---|---|
| TEXTO | 1 |
| IMAGEM | 2 |
| VOZ | 3 |
| ARQUIVO | 4 |
| VÍDEO | 5 |
Upload de Mídia (Imagens, Arquivos, Vídeos)
Arquivos de mídia são criptografados com AES-128-ECB antes do upload. O fluxo:
- Chame
getUploadUrlcom metadados do arquivo (tamanho, MD5) - Receba parâmetros de upload CDN pré-assinados
- Criptografe o arquivo com AES-128-ECB
- Faça o upload para o CDN usando a URL pré-assinada
- Referencie o arquivo CDN em
sendMessage
Problemas Comuns e Soluções
Plugin Recusa-se a Carregar
Erro: O plugin rejeita o carregamento na inicialização
Solução: Verifique sua versão do OpenClaw. O plugin v2.0.x requer >=2026.3.22.
openclaw --version
# Se estiver desatualizado, atualize o OpenClaw primeiro
Código QR Expirado
Erro: O código QR expira antes de ser escaneado
Solução: Execute o comando de login novamente. Os códigos QR expiram após ~30 segundos.
openclaw channels login --channel openclaw-weixin
Mensagens Não Recebidas
Erro: Mensagens do WeChat não chegam ao OpenClaw
Solução: Reinicie o gateway após o login.
openclaw gateway restart
Múltiplas Contas Misturando Contextos
Erro: Respostas de IA de uma conta aparecem em outra
Solução: Habilite o isolamento de contexto por canal.
openclaw config set agents.mode per-channel-per-peer
Casos de Uso no Mundo Real
Assistente Pessoal de IA
Conecte seu WeChat pessoal ao OpenClaw e tenha um assistente de IA respondendo às mensagens quando você estiver ocupado. Configure o isolamento de contexto para que cada contato receba respostas personalizadas com base em seu histórico de conversas.
Suporte ao Cliente para Pequenas Empresas
Execute múltiplas contas WeChat para diferentes linhas de negócios. Cada conta lida com suas próprias consultas de clientes com memória de IA isolada. Sem contaminação cruzada entre contas.
Teste de Desenvolvedores
Use a API HTTP JSON para construir integrações personalizadas. O protocolo de backend do plugin é totalmente documentado, tornando fácil estender ou substituir o comportamento padrão.
Conclusão
Configurar o OpenClaw com o WeChat leva menos de 5 minutos. Instale o plugin, escaneie um código QR, reinicie o gateway — pronto. A configuração gratuita suporta múltiplas contas, isolamento de contexto e suporte completo a mídia (imagens, voz, arquivos, vídeo).
Para desenvolvedores, a API HTTP JSON documentada torna as integrações personalizadas diretas.
Comece com o instalador de um clique:
npx -y @tencent-weixin/openclaw-weixin-cli install
Próximo passo: Uma vez que seu bot WeChat esteja funcionando, você provavelmente precisará conectá-lo a APIs externas — gateways de pagamento, CRMs, serviços de clima, etc. Teste suas APIs com o Apidog para garantir que seu bot envie os dados corretos sempre. Nível gratuito disponível, sem necessidade de cartão de crédito.
FAQ
P: Isso funciona com contas pessoais do WeChat?
R: Sim. Ao contrário da maioria das ferramentas de automação do WeChat, este plugin funciona com contas pessoais. Nenhuma conta empresarial ou oficial é necessária.
P: O plugin é gratuito?
R: Sim. O plugin @tencent-weixin/openclaw-weixin é gratuito e de código aberto. Você só precisa de uma instalação OpenClaw funcionando.
P: Posso usar várias contas WeChat ao mesmo tempo?
R: Sim. Execute openclaw channels login --channel openclaw-weixin para cada conta. Todas as contas funcionam simultaneamente.
P: O que acontece se eu reiniciar meu computador?
R: As credenciais de login são salvas localmente. Você não precisa escanear o código QR novamente após um reinício. Basta reiniciar o gateway com openclaw gateway restart.
P: Posso criar integrações personalizadas com base nisso?
R: Sim. O plugin expõe uma API HTTP JSON documentada com 5 endpoints: getUpdates, sendMessage, getUploadUrl, getConfig e sendTyping. Se o seu bot precisar chamar serviços externos, use o Apidog para testar e validar suas integrações de API antes de colocá-las em produção.