Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw se conecta ao WeChat por meio do plugin de canal externo @tencent-weixin/openclaw-weixin da Tencent. Status: plugin externo. Chats diretos e mídia são compatíveis. Chats em grupo não são anunciados pelos metadados de capacidade atuais do plugin.

​
Nomenclatura

  • WeChat é o nome voltado ao usuário nestes docs.
  • Weixin é o nome usado pelo pacote da Tencent e pelo id do plugin.
  • openclaw-weixin é o id do canal do OpenClaw.
  • @tencent-weixin/openclaw-weixin é o pacote npm.
Use openclaw-weixin em comandos de CLI e caminhos de configuração.

​
Como funciona

O código do WeChat não fica no repo principal do OpenClaw. O OpenClaw fornece o contrato genérico de plugin de canal, e o plugin externo fornece o runtime específico do WeChat:
  1. openclaw plugins install instala @tencent-weixin/openclaw-weixin.
  2. O Gateway descobre o manifesto do plugin e carrega o ponto de entrada do plugin.
  3. O plugin registra o id de canal openclaw-weixin.
  4. openclaw channels login --channel openclaw-weixin inicia o login por QR.
  5. O plugin armazena as credenciais da conta no diretório de estado do OpenClaw.
  6. Quando o Gateway inicia, o plugin inicia seu monitor do Weixin para cada conta configurada.
  7. Mensagens recebidas do WeChat são normalizadas pelo contrato de canal, roteadas para o agente OpenClaw selecionado e enviadas de volta pelo caminho de saída do plugin.
Essa separação é importante: o núcleo do OpenClaw deve permanecer agnóstico a canais. Login do WeChat, chamadas da API Tencent iLink, upload/download de mídia, tokens de contexto e monitoramento de contas pertencem ao plugin externo.

​
Instalação

Instalação rápida: 
npx -y @tencent-weixin/openclaw-weixin-cli install
Instalação manual: 
openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true
Reinicie o Gateway após a instalação: 
openclaw gateway restart

​
Login

Execute o login por QR na mesma máquina que executa o Gateway: 
openclaw channels login --channel openclaw-weixin
Escaneie o código QR com o WeChat no seu telefone e confirme o login. O plugin salva o token da conta localmente após uma leitura bem-sucedida. Para adicionar outra conta do WeChat, execute o mesmo comando de login novamente. Para múltiplas contas, isole sessões de mensagem direta por conta, canal e remetente: 
openclaw config set session.dmScope per-account-channel-peer

​
Controle de acesso

Mensagens diretas usam o modelo normal de pareamento e allowlist do OpenClaw para plugins de canal. Aprove novos remetentes: 
openclaw pairing list openclaw-weixin
openclaw pairing approve openclaw-weixin <CODE>
Para o modelo completo de controle de acesso, consulte Pareamento.

​
Compatibilidade

O plugin verifica a versão do host OpenClaw na inicialização.
Linha do pluginVersão do OpenClawtag npm
2.x>=2026.3.22latest
1.x>=2026.1.0 <2026.3.22legacy
Se o plugin informar que sua versão do OpenClaw é antiga demais, atualize o OpenClaw ou instale a linha legada do plugin: 
openclaw plugins install @tencent-weixin/openclaw-weixin@legacy

​
Processo sidecar

O plugin do WeChat pode executar trabalho auxiliar ao lado do Gateway enquanto monitora a API Tencent iLink. Na issue #68451, esse caminho auxiliar expôs um bug na limpeza genérica de Gateways obsoletos do OpenClaw: um processo filho podia tentar limpar o processo Gateway pai, causando loops de reinício sob gerenciadores de processo como systemd. A limpeza atual de inicialização do OpenClaw exclui o processo atual e seus ancestrais, portanto um auxiliar de canal não deve encerrar o Gateway que o iniciou. Essa correção é genérica; não é um caminho específico do WeChat no núcleo.

​
Solução de problemas

Verifique instalação e status: 
openclaw plugins list
openclaw channels status --probe
openclaw --version
Se o canal aparecer como instalado, mas não se conectar, confirme que o plugin está habilitado e reinicie: 
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw gateway restart
Se o Gateway reiniciar repetidamente após habilitar o WeChat, atualize tanto o OpenClaw quanto o plugin: 
npm view @tencent-weixin/openclaw-weixin version
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
openclaw gateway restart
Se a inicialização informar que o pacote de plugin instalado requires compiled runtime output for TypeScript entry, o pacote npm foi publicado sem os arquivos compilados de runtime JavaScript necessários para o OpenClaw. Atualize/reinstale depois que o publicador do plugin lançar um pacote corrigido, ou desabilite/desinstale o plugin temporariamente. Desabilitação temporária: 
openclaw config set plugins.entries.openclaw-weixin.enabled false
openclaw gateway restart

​
Docs relacionados