Lucas

Posted on Mar 25 • Originally published at apidog.com

Como Usar OpenClaw com WeChat Grátis?

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.

Experimente o Apidog hoje

Introdução

Rodar um assistente de IA no WeChat ficou simples com o OpenClaw. Diferente das soluções que exigem contas empresariais, configurações complexas ou assinaturas caras, o OpenClaw permite conectar sua conta pessoal do WeChat em minutos, sem custos mensais.

O plugin @tencent-weixin/openclaw-weixin integra o WeChat ao gateway de IA do OpenClaw. Basta instalar, escanear um QR Code e pronto. Este guia mostra todo o processo, incluindo como gerenciar múltiplas contas e isolar contextos de conversa.

💡Se o seu bot do WeChat precisar chamar APIs externas (clima, pagamentos, CRM), utilize o Apidog para projetar, testar e documentar suas APIs antes de conectá-las ao bot.

Pré-requisitos

Antes de começar, confira se possui:

OpenClaw instalado (>=2026.3.22 para usar o plugin v2.0.x)
CLI openclaw disponível no terminal
Conta WeChat pessoal (não precisa ser empresarial)
Node.js instalado (para o instalador de um clique)

Verifique a versão do OpenClaw com:

openclaw --version

Para usar o plugin v2.0.x, atualize o OpenClaw se necessário (>=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 valida a versão do OpenClaw na inicialização e recusa carregar se estiver fora do intervalo suportado.

Passo 1: Instalar o Plugin

Opção A: Instalação com Um Clique (Recomendado)

npx -y @tencent-weixin/openclaw-weixin-cli install

Esse comando instala e configura automaticamente o plugin.

Opção B: Instalação Manual

Se necessário, siga esses passos:

1. Instale o plugin:

openclaw plugins install "@tencent-weixin/openclaw-weixin"

2. Ative o plugin:

openclaw config set plugins.entries.openclaw-weixin.enabled true

Passo 2: Escanear o Código QR para Autorizar o WeChat

Faça login na sua conta WeChat:

openclaw channels login --channel openclaw-weixin

Escaneie o QR code exibido no terminal usando o aplicativo WeChat. Confirme no telefone.

As credenciais são salvas localmente. Só será preciso escanear novamente se fizer logout.

Passo 3: Reiniciar o Gateway

Após autorizar, reinicie o gateway para ativar o plugin:

openclaw gateway restart

Pronto! Sua conta WeChat já está conectada ao OpenClaw. Todas as mensagens recebidas serão processadas pela IA.

Passo 4: Adicionar Múltiplas Contas WeChat (Opcional)

Para usar várias contas WeChat, repita o login:

openclaw channels login --channel openclaw-weixin

Cada QR code escaneado adiciona uma nova conta. Todas funcionam em paralelo e isoladas.

Passo 5: Isolar Contextos de Conversa (Opcional)

Por padrão, todos os canais compartilham o contexto da IA. Para isolar o contexto por conta e contato:

openclaw config set agents.mode per-channel-per-peer

Assim, cada conversa com cada usuário de cada conta terá sua própria memória de IA.

Como o Plugin Funciona por Trás dos Panos

Para desenvolvedores, veja como o plugin se comunica com o OpenClaw.

Cabeçalhos de Autenticação

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

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)

// Solicitação
{
  "get_updates_buf": ""
}

// Resposta
{
  "ret": 0,
  "msgs": [...],
  "get_updates_buf": "<novo_cursor>",
  "longpolling_timeout_ms": 35000
}

Passe o get_updates_buf recebido para a próxima chamada para obter apenas mensagens novas.

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)

Para enviar mídia:

Chame getUploadUrl com informações do arquivo (tamanho, MD5)
Receba os parâmetros de upload CDN
Criptografe o arquivo em AES-128-ECB
Faça o upload usando a URL pré-assinada
Referencie o arquivo no sendMessage

Problemas Comuns e Soluções

Plugin recusa-se a carregar

Erro: O plugin não inicia

Solução: Cheque a versão do OpenClaw:

openclaw --version
# Atualize caso necessário

Código QR expirado

Erro: QR code expira antes de escanear

Solução: Gere um novo QR code:

openclaw channels login --channel openclaw-weixin

Mensagens não recebidas

Erro: Mensagens não chegam ao OpenClaw

Solução: Reinicie o gateway:

openclaw gateway restart

Múltiplas contas misturando contextos

Erro: Respostas de IA aparecem na conta errada

Solução: Ative o isolamento de contexto:

openclaw config set agents.mode per-channel-per-peer

Casos de Uso no Mundo Real

Assistente pessoal de IA

Use seu WeChat pessoal com OpenClaw para automatizar respostas. Ative isolamento de contexto para personalização por contato.

Suporte ao cliente para pequenas empresas

Gerencie várias contas WeChat, cada uma com seu próprio contexto, para atender diferentes linhas de negócio sem mistura de informações.

Teste para desenvolvedores

Utilize a API HTTP JSON para criar integrações customizadas. O protocolo do plugin é totalmente documentado.

Conclusão

Conectar OpenClaw ao WeChat é rápido: instale o plugin, escaneie o QR code, reinicie o gateway e pronto. Suporte a múltiplas contas, contexto isolado e mídias integrado.

Para integrações personalizadas, utilize os endpoints HTTP JSON documentados.

Comece já com o instalador de um clique:

npx -y @tencent-weixin/openclaw-weixin-cli install

Próximo passo: Após seu bot WeChat estar online, conecte APIs externas (pagamentos, CRM, clima, etc). Teste suas APIs com o Apidog para garantir integrações corretas. Plano gratuito, sem cartão de crédito.

FAQ

P: Isso funciona com contas pessoais do WeChat?

R: Sim. O plugin funciona com contas pessoais, sem necessidade de conta empresarial ou oficial.

P: O plugin é gratuito?

R: Sim. O @tencent-weixin/openclaw-weixin é open source e gratuito. Só precisa do OpenClaw instalado.

P: Posso usar várias contas WeChat ao mesmo tempo?

R: Sim. Faça openclaw channels login --channel openclaw-weixin para cada conta. Todas funcionam em paralelo.

P: O que acontece se eu reiniciar meu computador?

R: As credenciais ficam salvas localmente. Basta reiniciar o gateway com openclaw gateway restart; não é preciso escanear o QR novamente.

P: Posso criar integrações personalizadas?

R: Sim. O plugin expõe uma API HTTP JSON com 5 endpoints: getUpdates, sendMessage, getUploadUrl, getConfig e sendTyping. Se precisar testar integrações externas, use o Apidog para validar suas APIs antes de ir para produção.

DEV Community