Como Construí um Assistente de IA Personalizado Com Gravity Claw
Há três semanas, eu estava olhando meu app do Telegram às 23h, e meu assistente de IA — um que eu mesmo construí — me enviou uma mensagem que nunca pedi. "Você mencionou que queria terminar a migração da API até sexta. Não mexeu nisso há dois dias. O que está te bloqueando?"
Não programei essa mensagem exata. Não agendei manualmente. A coisa simplesmente sabia porque lembrava de uma conversa de quatro dias antes, extraiu contexto da memória semântica e decidiu intervir.
Esse momento quebrou meu cérebro. Porque cada assistente de IA que usei antes era fundamentalmente reativo — esperava eu perguntar algo. Este era diferente. Este tinha iniciativa.
Chama-se Gravity Claw, e vou te mostrar exatamente como o construí.
O Problema Com Todos os Assistentes de IA Que Você Já Experimentou
Todo assistente de IA que você usou compartilha a mesma falha fundamental: são reativos. Você faz uma pergunta, recebe uma resposta. Fim da interação. Não lembram o que você disse ontem. Não conectam pontos entre conversas. E definitivamente não se comunicam proativamente.
Gravity Claw resolve isso através do que chamo de framework CLAUSE — seis componentes arquitetônicos que transformam um chatbot básico em algo que realmente parece um assistente.
O Framework CLAUSE — Por Que Esta Arquitetura Faz Sentido
CLAUSE significa: Contexto, Listening (Escuta), Autonomia, Understanding (Compreensão), Storage (Armazenamento) e Execução. Cada letra representa uma camada da arquitetura:
- Contexto: O bot sabe quem você é, no que trabalha, suas preferências
- Escuta: Processamento de linguagem natural em múltiplos canais
- Autonomia: Comportamento proativo — pode iniciar conversas
- Compreensão: Raciocínio semântico sobre seu histórico de conversas
- Armazenamento: Memória persistente com busca vetorial
- Execução: Integração com serviços externos via servidores MCP
Configurando a Base — Conexão e Primeiro Contato
A configuração começa com clonar o repositório e instalar dependências:
# Clone the anti-gravity repo
git clone https://github.com/anti-gravity-claw/gravity-claw.git
cd gravity-claw
cp .env.example .env
Você precisa de duas chaves de API: um token de bot do Telegram e uma chave do OpenRouter.
TELEGRAM_BOT_TOKEN=your_bot_token_here
OPENROUTER_API_KEY=your_openrouter_key_here
Uma vez configurado, um simples docker compose levanta tudo:
docker compose up -d
Ensinando Seu Bot a Ouvir e Falar — A Camada de Voz
A camada de voz lida com processamento de linguagem natural. Gravity Claw usa OpenRouter para rotear entre diferentes modelos LLM conforme a tarefa — Claude para raciocínio complexo, modelos mais rápidos para respostas simples.
O que torna isso diferente de um wrapper do ChatGPT: o prompt do sistema é dinâmico. É reconstruído a cada mensagem incorporando seu perfil de usuário, memórias recentes relevantes e contexto da conversa atual.
A Arquitetura de Memória Que Mudou Tudo
Aqui é onde Gravity Claw se separa de todo o resto. O sistema de memória tem três camadas:
- Memória de curto prazo: Histórico da conversa atual
- Memória de longo prazo: Armazenamento vetorial de todas as conversas passadas com busca semântica
- Memória de trabalho: Fatos extraídos, preferências e tarefas em andamento
Quando você envia uma mensagem, o bot busca na memória de longo prazo por contexto relevante. É assim que "lembra" que você mencionou a migração da API quatro dias antes.
A parte de busca vetorial é fundamental. Não é correspondência de palavras-chave — é compreensão semântica.
Conectando Com Sua Vida Digital Com Servidores MCP
Servidores MCP (Model Context Protocol) são como dar mãos ao seu assistente. Sem MCP, ele só fala. Com MCP, pode agir — ler arquivos, consultar APIs, verificar calendários, enviar notificações.
Configurei servidores MCP para: sistema de arquivos, GitHub, Google Calendar e um webhook personalizado para integrações de casa inteligente.
O Sistema de Heartbeat — Quando Sua IA Verifica Você
Esta é a função que me surpreendeu. O sistema de heartbeat é um processo em segundo plano que roda em um timer — a cada poucas horas, seu assistente verifica sua memória de trabalho, procura tarefas pendentes, prazos se aproximando ou conversas que você deixou penduradas, e decide se entra em contato.
Não faz spam. O sistema tem uma pontuação de limiar — só se comunica quando urgência × relevância supera um certo nível. Na prática, isso significa 2-3 mensagens proativas por dia.
Deploy na Nuvem — Quando Seu Laptop Dorme
Rodar o bot localmente tem um problema óbvio: quando fecha o laptop, o bot morre. Deploy na nuvem resolve isso.
Usei um VPS simples com Docker Compose. O stack completo roda em uma instância de 2GB RAM. Custa cerca de $5/mês.
O Que Ninguém Te Conta Sobre Construir Seu Próprio Assistente de IA
Três coisas me surpreenderam: Primeiro, a engenharia de prompts para um assistente persistente é fundamentalmente diferente de um chatbot. Você está projetando personalidade, não apenas capacidade. Segundo, a gestão de memória é o verdadeiro desafio de engenharia. Terceiro, mensagens proativas mudam sua relação com IA de "ferramenta que uso" para "colega que me ajuda."
Os Resultados Após Três Semanas de Uso Diário
Após três semanas, Gravity Claw se tornou a ferramenta mais útil do meu stack de produtividade. Economizou aproximadamente 45 minutos por dia em verificação de contexto.
As mensagens proativas são a função destaque. Salvaram três prazos que eu teria esquecido e duas reuniões que esqueci de agendar.
O Que Isso Significa Para o Futuro da IA Pessoal
Estamos em um ponto de inflexão. As ferramentas para construir assistentes de IA personalizados estão acessíveis para qualquer desenvolvedor. A lacuna entre IA reativa e proativa é a diferença entre uma calculadora e um colega.
🤝 Vamos Trabalhar Juntos
Procurando construir sistemas de IA, automatizar fluxos de trabalho ou escalar sua infraestrutura tecnológica? Adoraria ajudar.
- 🔗 Fiverr (builds e integrações personalizadas): fiverr.com/s/EgxYmWD
- 🌐 Portfólio: mejba.me
- 🏢 Ramlit Limited (soluções empresariais): ramlit.com
- 🎨 ColorPark (design e branding): colorpark.io
- 🛡 xCyberSecurity (serviços de segurança): xcybersecurity.io
