WeChat — IA no Aplicativo de Todos | Easy Understand Hermes Agent

Pense nisto como ensinar o seu WeChat a conversar com um assistente superinteligente — só que o assistente vive na nuvem, e você não precisa montar um único servidor para fazer funcionar.

Sobre o que é tudo isto?

O Hermes Agent é um framework de agentes de IA de código aberto. Em português claro: ele permite ligar os seus aplicativos de mensagens favoritos a ferramentas de IA que podem responder perguntas, automatizar tarefas ou até gerir o seu calendário.

Este guia foca-se no WeChat — o aplicativo de mensagens pessoais que milhares de milhões de pessoas usam diariamente. Com o Hermes, você pode fazer o seu WeChat conversar com um bot de IA, tudo através de um simples login por código QR. Sem webhooks complicados, sem endereço IP público, sem configuração de servidor.

O que você precisa antes de começar

Uma conta pessoal do WeChat (a que está no seu telemóvel)
Python instalado no seu computador
Um terminal (Prompt de Comando no Windows, Terminal no Mac/Linux)

É só isso. Sem chaves de API pagas, sem hospedagem na nuvem.

Passo 1: Instalar os Pacotes Necessários

Abra o seu terminal e execute:

pip install aiohttp cryptography

Se você instalou o Hermes com o extra “messaging”, também pode executar:

cd ~/.hermes/hermes-agent && uv pip install -e ".[messaging]"

Isto apenas adiciona ferramentas extras para mostrar o código QR de forma bonita no seu terminal.

Passo 2: Executar o Assistente de Configuração

A forma mais fácil de conectar o seu WeChat é através do assistente integrado:

hermes gateway setup

Quando for perguntado, escolha Weixin. O assistente irá:

Pedir um código QR à API do iLink Bot do WeChat
Mostrar esse código QR no seu terminal (ou fornecer um URL)
Aguardar que você o digitalize com o aplicativo WeChat do seu telemóvel
Guardar as suas credenciais de login automaticamente

Depois de confirmar o login no seu telemóvel, verá:

WeChat connected successfully, account_id=your-account-id

O seu ID de conta é guardado para si.

Passo 3: Configurar as Variáveis de Ambiente

Agora você precisa dizer ao Hermes qual conta usar. Abra o seu ficheiro ~/.hermes/.env e adicione:

WEIXIN_ACCOUNT_ID = your-account-id

Também pode controlar quem pode falar com o seu bot:

WEIXIN_DM_POLICY = open
WEIXIN_ALLOWED_USERS = user_id_1,user_id_2

open significa que qualquer pessoa pode enviar mensagens ao bot
allowed_users permite-lhe restringir a pessoas específicas

Uma Verificação Rápida da Realidade (Importante!)

Este adaptador conecta-se a uma identidade de bot iLink, não diretamente à sua conta pessoal do WeChat. Isso significa que:

O bot é uma identidade separada da sua conta pessoal
Funciona de forma fiável para mensagens diretas e pequenos grupos
Não foi concebido para transmissões em massa ou spam

Portanto, trate-o como um colega de trabalho útil, não como um megafone.

A Sua Primeira Conversa

Assim que tudo estiver configurado, inicie o gateway:

hermes gateway start

Depois abra o WeChat no seu telemóvel, encontre o contacto do bot e envie uma mensagem simples como “Olá”. Em poucos segundos, deverá receber uma resposta do seu assistente de IA.

A partir daí, pode pedir-lhe para resumir notícias, redigir e-mails ou até definir lembretes — tudo sem sair do WeChat.

Resumo e uma Dica Prática

Agora você tem um assistente de IA pessoal dentro do WeChat, conectado através de uma ferramenta gratuita e de código aberto. Toda a configuração leva menos de dez minutos e não requer nenhuma infraestrutura na nuvem.

Dica prática: Comece com um pequeno grupo de amigos ou um chat de teste antes de convidar contactos reais. Isto permite-lhe aprender como o bot se comporta, ajustar as suas definições de permissão e evitar erros iniciais embaraçosos. Quando se sentir confortável, abra as comportas e deixe o seu WeChat fazer a conversa.