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

Olá a todos, sou o Canghe.

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

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

Mas o mais usado por todo mundo, contas pessoais do WeChat, é exatamente o que ele não suporta.

Vasculhei o GitHub, Juejin e Zhihu, e as soluções que encontrei ou envolviam um caminho complicado via WeChat Work ou usavam o protocolo Web do WeChat, que te bane rapidinho.

Para ser sincero, quem aguenta isso?

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

Fiquei de saco cheio.

Então decidi fazer eu mesmo.

Depois de uma maratona de 2 dias, 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 não parece diferente de um amigo normal, mas é um amigo que realmente pode 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 direto para o bot, e depois posso pedir para ele encontrar qualquer coleção que eu quiser 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.

Aí posso comandar o OpenClaw para coletar automaticamente informações da web e me enviar um resumo direto.

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

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

Claro, existem mais cenários para 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 tome cuidado.

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

3. Recomenda-se 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 impediu que ele se tornasse 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.

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

Sua capacidade principal é uma frase: Deixar a IA não apenas responder suas perguntas, mas realmente trabalhar para você.

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

Não é o tipo de "assistente de IA" que finge te entender e gera um monte de texto; é um Agent com mãos e pés que realmente pode 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 dar uma olhada neles primeiro:

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

Sinceramente, não dá para culpar o OpenClaw por isso.

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

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

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

Mas os problemas são:

1. Estabilidade preocupante; o protocolo Web do WeChat pode ser banido a qualquer momento.
2. Funcionalidades limitadas; muitos recursos avançados não podem ser usados.
3. Riscos de segurança; sua conta do WeChat fica essencialmente exposta.

Tentei algumas; ou não funcionavam ou caíam 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 a seguinte:

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

A arquitetura principal é 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, o 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 IA 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 escalonamento de múltiplos modelos. Tem bastante 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 IA 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 no WeChat é bem específico.

Com um monte de gente falando em um grupo, você não pode tratar toda mensagem como um comando para a IA.

Então criei um mecanismo de "Menção com @ + Mensagem Direta":

• Mensagem Privada: Todas as mensagens são encaminhadas diretamente para o OpenClaw processar.
• Grupo: Apenas mensagens que mencionam o bot com @ acionam uma resposta da IA.

Isso evita o suicídio social da IA spammando 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 indicador de status "Pensando...". Enquanto a IA gera uma resposta, envia um aviso primeiro, depois substitui pela resposta formal quando gerada.

A experiência do usuário fica no máximo.

Armadilha 4: Alternância entre Múltiplos Modelos

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

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 de IA.

Aqui estão alguns cenários que uso pessoalmente:

1. Assistente Inteligente de Chat em Grupo

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

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

2. Gerenciador de Conhecimento Pessoal

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

Agora, quando vejo um artigo bom, encaminho direto para o bot—é 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 certa.

É melhor do que os lembretes nativos do celular porque você com certeza vai ver 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 se irritar com as palavras "Você está aí?".

Como usar?

O projeto é open source e você pode implantar por conta própria.

Existem três etapas principais:

Passo 1: Clonar o projeto

git clone

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

cd openclaw-wechat

Passo 2: Configurar 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: Adicionar 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 QR code para fazer login, e pronto.

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

Planos Futuros

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

• Suporte a Mensagens de Voz: Atualmente só suporta texto; depois adicionarei conversão de fala para texto e texto para fala.
• Compreensão de Imagens: Integrar modelos multimodais para que a IA entenda as imagens que você envia.
• Integração com o Mercado de Skills do OpenClaw: Chamar mais de 700 skills do OpenClaw diretamente no WeChat.
• Painel de Gerenciamento de Múltiplas Contas: Visualização baseada em Web para gerenciar a integração de várias contas do WeChat.

Se você tiver boas ideias, fique à vontade para enviar uma Issue ou PR no GitHub.

Considerações Finais

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

Antes, falávamos de IA como algo distante, ou em laboratórios ou em servidores de grandes empresas.

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

É uma sensação incrivelmente boa.

No entanto, também devo lembrar 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ê tiver interesse, vá 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!