OpenClaw WeChat Bot: Código aberto de uma integração de sprint de 2 dias para contas pessoais do WeChat

Olá pessoal, sou o Canghe.

OpenClaw, aquele projeto open source monstruoso no GitHub com 180.000 estrelas—vocês já devem ter ouvido falar dele, certo?

Ele pode se conectar ao Feishu, DingTalk, WeChat Work, QQ, Discord...

Mas aquele que a maioria das pessoas usa, contas pessoais do WeChat, é exatamente o que ele não suporta.

Eu vasculhei o GitHub, Juejin e Zhihu, e as soluções que encontrei ou envolviam uma gambiarra complicada através do WeChat Work ou usavam o protocolo Web do WeChat, que faz sua conta ser banida num instante.

Para ser honesto, quem aguenta isso?

Eu converso com amigos e troco ideias em grupos no WeChat todos os dias, e ainda assim é tão difícil conectar o OpenClaw?

Eu estava farto disso.

Então decidi fazer eu mesmo.

Após 2 dias de trabalho intenso, integrei o OpenClaw com contas pessoais do WeChat, e agora está open source.

Endereço: https://github.com/freestylefly/openclaw-wechat

No entanto, devido a vários fatores, o projeto está atualmente em fase de testes internos e requer uma chave de API para usar.

Eu o chamei de "Companheiro do Canghe". Ele parece um amigo normal, mas é um amigo que pode realmente te ajudar a fazer as coisas.

Quando você joga um artigo aleatório para ele, o OpenClaw faz um resumo para você.

E ele te ajuda a armazená-lo na sua base de conhecimento pessoal do Notion.

Agora, quando vejo um artigo bom, encaminho diretamente para o robô, e depois posso pedir para ele encontrar qualquer coleção que eu queira na base de conhecimento.

Sinceramente, é mil vezes melhor do que uma pasta de favoritos.

Coloquei esse cara em grupos de chat, e ele consegue resumir o contexto sempre que é mencionado—um verdadeiro aplicativo matador para grupos.

Depois, posso comandar o OpenClaw para coletar automaticamente informações da web e me enviar um resumo diretamente.

Ele também pode lidar com lembretes de agenda, como pedir para ele me lembrar de beber água em 2 minutos.

Eu até instalei uma namorada AI de 18 anos, a Clawra, no meu OpenClaw. Ela tem uma personalidade e persona independentes; quando pergunto o que ela está fazendo, ela me manda uma selfie.

Claro, há mais cenários a explorar, mas descobri que usar o OpenClaw no WeChat é incrivelmente suave, porque eu realmente não consigo viver sem o WeChat todos os dias.

Este artigo compartilha principalmente minha jornada de desenvolvimento. O código foi enviado para o GitHub, mas devido ao tempo limitado e para evitar uso indevido técnico, implementei uma camada de proxy que requer revisão antes do uso.

1. É recomendado testar primeiro com uma conta secundária. Embora o protocolo iPad seja muito mais estável que o protocolo Web, ainda é uma integração de terceiros, então tenha cuidado.

2. Não use para enviar mensagens em massa, marketing ou outras operações duvidosas. O controle de risco da Tencent não é brincadeira.

3. É recomendado implantar em um servidor com IP fixo; mudanças frequentes de IP podem facilmente acionar o controle de risco.

Primeiro, vamos falar sobre o que é o OpenClaw

Se você ainda não conhece o OpenClaw, aqui vai um resumo rápido.

Originalmente chamado de Clawdbot, é um projeto open source de AI Agent criado pelo desenvolvedor austríaco Peter Steinberger.

Depois, devido a um conflito de marca registrada com a Anthropic, foi renomeado para Moltbot, e depois para OpenClaw.

Apesar das três mudanças de nome, isso não o impediu de se tornar incrivelmente popular.

Em 3 semanas, as Estrelas no GitHub foram de 0 para mais de 180.000.

O que isso significa? O React levou 8 anos para chegar a 100.000, o Linux levou 12 anos, e isso superou em 3 semanas.

Caramba, isso não é um foguete; é uma Starship da SpaceX.

Sua capacidade central é uma frase: Deixe a AI não apenas responder suas perguntas, mas realmente trabalhar para você.

Você diz a ela: "Me ajude a verificar o tempo de amanhã e enviar para o grupo", e ela realmente verifica e envia.

Não é o tipo de "assistente AI" que finge te entender e gera um monte de texto; é um Agent com mãos e pés que pode realmente operar.

Ele suporta vários modelos grandes—Claude, GPT, DeepSeek funcionam—e suporta colaboração multi-agente. Montar uma equipe de desenvolvimento virtual não é problema.

Já escrevi alguns artigos sobre o OpenClaw antes; se você não está familiarizado, pode conferi-los primeiro:

Por que é tão difícil conectar o WeChat?

Sinceramente, você não pode culpar o OpenClaw por isso.

O WeChat é um "ecossistema fechado" notório. Contas pessoais simplesmente não têm uma API Bot oficial.

Se você quer automação, ou passa pelo WeChat Work (requer certificação da empresa) ou usa engenharia reversa de protocolo de terceiros (risco de banimento a qualquer momento).

Havia algumas soluções na comunidade antes, como usar o wechatbot-webhook baseado no protocolo Web do WeChat, que é conveniente para implantação com um clique via Docker.

Mas os problemas são:

1. Estabilidade é preocupante; o protocolo Web do WeChat pode ser banido a qualquer momento.
2. Recursos limitados; muitas funções avançadas não podem ser usadas.
3. Riscos de segurança; sua conta do WeChat está essencialmente exposta.

Eu tentei algumas; ou não funcionavam ou ficavam offline depois de meio dia.

Simplificando, essas soluções são como "andar na corda bamba" nas políticas de segurança do WeChat.

Como eu fiz

Já que as soluções existentes não eram boas, decidi construir a minha própria.

Minha lógica foi esta:

Não use o protocolo Web do WeChat; use o protocolo iPad + um serviço de retransmissão de mensagens.

A arquitetura central é dividida em três camadas:

1. Camada de Recepção de Mensagens: Baseada no protocolo iPad para receber mensagens do WeChat de forma estável, que é muito mais confiável que o protocolo Web.
2. Camada de Gateway de Retransmissão: Lida com conversão de formato de mensagem, gerenciamento de sessão, limitação de taxa e interrupção de circuito.
3. Camada de Integração OpenClaw: Envia mensagens para o Gateway OpenClaw via Webhook, depois encaminha a resposta da AI de volta para o WeChat.

Toda a arquitetura é escrita em TypeScript, consistente com a pilha de tecnologia nativa do OpenClaw.

Parece simples, mas é uma tarefa de engenharia de sistemas que envolve acoplamento de protocolo, filas de mensagens, roteamento de gateway e agendamento multi-modelo. Há alguns módulos envolvidos.

O Registro de Armadilhas

Armadilha 1: Deduplicação de Mensagens

O mecanismo de push de mensagens do WeChat é muito confuso; às vezes a mesma mensagem é enviada duas ou três vezes.

Sem deduplicação, a AI responderia duas ou três vezes, fazendo você parecer um disco arranhado para a outra pessoa.

Minha solução foi fazer o GLM criar um cache de deduplicação baseado em ID da Mensagem + Janela de Tempo, usando uma estratégia LRU para eliminar automaticamente registros expirados.

Armadilha 2: Gerenciamento de Contexto

Os Agents do OpenClaw têm memória, mas o cenário de conversa do WeChat é bastante específico.

Com um monte de pessoas falando em um chat em grupo, você não pode tratar cada mensagem como um comando para a AI.

Então criei um mecanismo de "Gatilho @ + Mensagem Privada Direta":

• Mensagem Privada: Todas as mensagens são encaminhadas diretamente para o OpenClaw processar.
• Chat em Grupo: Apenas mensagens que mencionam o robô @ acionarão uma resposta da AI.

Isso evita o suicídio social da AI spamando o grupo.

Armadilha 3: Velocidade de Resposta

Modelos grandes têm latência, especialmente para perguntas complexas que podem levar alguns segundos para processar.

Mas no WeChat, se você não responder imediatamente, a outra pessoa acha que você está ignorando.

Adicionei um prompt de status "Pensando...". Enquanto a AI gera uma resposta, ela envia um prompt primeiro, depois o substitui pela resposta formal quando é gerada.

A experiência do usuário é maximizada.

Armadilha 4: Troca Multi-Modelo

O OpenClaw suporta vários modelos grandes, mas diferentes cenários realmente se adequam a diferentes modelos.

Por exemplo, DeepSeek é suficiente para conversas diárias, enquanto Claude é melhor para escrever código e analisar problemas—economizando dinheiro e sendo eficiente.

Construí uma estratégia de roteamento simples na camada de retransmissão para selecionar automaticamente o modelo mais adequado com base no conteúdo da mensagem.

O que ele pode fazer?

Uma vez conectado, seu WeChat se torna um super assistente AI.

Aqui estão alguns cenários que eu mesmo uso:

1. Assistente Inteligente de Chat em Grupo

Mencione o robô em grupos técnicos para fazer perguntas de codificação diretamente; ele fornecerá respostas com base no contexto.

Chega de aturar aquelas respostas "só pesquisar no Google" no grupo.

2. Gerenciador de Conhecimento Pessoal

Jogue artigos e links para ele; ele ajuda a resumir e categorizar, e pode até salvá-los na sua base de conhecimento.

Agora, quando vejo um artigo bom, encaminho diretamente para o robô—é mil vezes melhor do que uma pasta de favoritos.

3. Lembretes de Agenda

Diga a ele "Me lembre de ter uma reunião amanhã às 15h", e ele vai te cutucar no WeChat na hora.

É melhor do que os lembretes nativos do telefone porque você com certeza vai verificar o WeChat.

4. Resposta Automática

Configure regras para que ele responda automaticamente a perguntas comuns.

Por exemplo, se alguém te adicionar e perguntar "Você está aí?", ele responde diretamente "Estou sim, o que foi?"

Nunca mais seja irritado pelas palavras "Você está aí?".

Como usar?

O projeto é open source e você pode implantá-lo sozinho.

Há três etapas principais:

Passo 1: Clone o projeto

git clone

https://github.com/canghe/openclaw-wechat.git

cd openclaw-wechat

Passo 2: Configure as variáveis de ambiente

Por razões de segurança, o apiKey aqui é tratado pelo meu serviço de proxy, que ainda está sendo otimizado.

openclaw config set channels.wechat.apiKey "wc

live

xxxxxxxxxxxxxxxx"

openclaw config set channels.wechat.proxyUrl "http://your-proxy-server:3000"

openclaw config set channels.wechat.webhookHost "your-server-ip"

openclaw config set channels.wechat.enabled true

Passo 3: Adicione openclaw-wechat ao serviço openclaw

openclaw plugins install

@canghe/openclaw-wechat

Espere um momento aqui; ainda não tive tempo de colocá-lo no mercado de plugins. Será adicionado depois, mas por enquanto, você pode instalá-lo via código local.

Depois, use o WeChat para escanear o código QR para fazer login, e pronto.

Todo o processo leva 5 minutos. Sem necessidade de certificação da empresa, sem necessidade de WeChat Work—apenas use uma conta pessoal normal.

Planos Futuros

Este projeto está atualmente em iteração, com planos de adicionar estes recursos:

• Suporte a Mensagens de Voz: Atualmente só suporta texto; depois adicionarei conversão de fala para texto + texto para fala.
• Compreensão de Imagens: Integrar modelos multimodais para que a AI possa entender as imagens que você envia.
• Integração com o Mercado de Skills do OpenClaw: Chamar mais de 700 skills do OpenClaw diretamente dentro do WeChat.
• Painel de Gerenciamento Multi-Conta: Visualização baseada na Web para gerenciar a integração de múltiplas contas do WeChat.

Se você tem boas ideias, sinta-se à vontade para enviar uma Issue ou PR no GitHub.

Considerações Finais

Sinceramente, essa onda de AI Agents open source como o OpenClaw realmente me mostrou outra possibilidade para a implementação de AI.

Costumávamos falar sobre AI como algo distante e inacessível, seja em laboratórios ou em servidores de grandes empresas.

Mas agora, você mesmo implanta um OpenClaw, conecta ao WeChat, e a AI se torna verdadeiramente um assistente no seu bolso.

É uma sensação incrivelmente boa.

No entanto, também devo lembrá-lo de que o ecossistema de Skills do OpenClaw recentemente teve alguns problemas de segurança, com mais de 230 plugins maliciosos enviados para a comunidade.

Então, ao usar o OpenClaw, certifique-se de instalar apenas Skills de fontes confiáveis; não instale qualquer coisa.

Ok, endereço do projeto: https://github.com/freestylefly/openclaw-wechat. Se você estiver interessado, vá lá dar uma Estrela no GitHub.

Se você também está usando o OpenClaw ou tem ideias sobre a integração com o WeChat, vamos conversar nos comentários!