🦞 Agente de IA Pessoal · Open Source · TypeScript

Gravity Claw
Hub de Recursos

Um agente Telegram com loop agêntico, construído do zero — lean, seguro, totalmente compreendido. Cada linha revisada, cada secret protegido, sem portas abertas.

Escolha features. Gere o prompt certo.

Cada store gera um output diferente — prompt para o AntiGravity ou CLAUDE.md para o Claude Code.

Guias e procedimentos

Referências para construir, deployar e operar o Gravity Claw.

Como o Gravity Claw funciona

🔒 Princípios Não-Negociáveis

  • Telegram long-polling — sem web server, sem portas abertas
  • Whitelist de Telegram ID — ignora silenciosamente outros usuários
  • Secrets no .env apenas — nunca em código ou logs
  • MCP para integrações — nenhum skill file externo não-auditado
  • Limite de iterações no loop + confirmação para shell perigoso

📦 Tech Stack

  • grammy — Telegram bot framework
  • @anthropic-ai/sdk — Claude Sonnet 4.6 (LLM primário)
  • better-sqlite3 + FTS5 — conversation buffer local
  • openai SDK — Whisper transcription (STT)
  • ElevenLabs API — Text-to-speech
  • tsx — hot-reload em dev
  • node-cron — heartbeat proativo

🧠 Memória em 3 Camadas

01
Core Memory — System Prompt Personalidade e instruções base injetadas via soul.md. Sempre presente. Editável diretamente.
soul.md
02
Conversation Buffer — SQLite + FTS5 Histórico da sessão com busca por texto. Ephemeral — reseta a cada Railway deploy.
better-sqlite3
03
Semantic Long-Term — Supabase + pgvector Memória vetorial persistente. Busca por significado, não só por palavra. Sobrevive a deploys.
pgvector

Implemente nesta ordem

Cada level adiciona uma camada de funcionalidade. Teste cada brick antes de avançar.

Level 01
Foundation

Telegram + Claude + agent loop. Uma tool: get_current_time

Level 02
Memory

SQLite + FTS5, memory tools, soul.md

Level 03
Voice

Whisper STT + ElevenLabs TTS, notas de voz

Level 04
Tools & MCP

Shell, files, Gmail, Notion, GitHub via mcp.json

Level 05
Heartbeat

node-cron, briefings diários, accountability

Ciclo de desenvolvimento

bash — gravity-claw
# 1. Pausar Railway antes de testar localmente
railway down
 
# 2. Dev com hot-reload (auto-restart em mudanças)
npm run dev     # tsx watch src/index.ts
 
# 3. Type-check antes de deployar
npx tsc --noEmit
 
# 4. Deploy no Railway (~60-90s)
railway up --detach
 
# 5. Verificar logs — startup saudável deve mostrar:
railway logs --lines 40
✅ Soul loaded (soul.md)
✅ Connected as @your_bot_name
✅ Heartbeat scheduled

OpenClaw vs Gravity Claw

Aspecto OpenClaw Gravity Claw
Exposição na internet 42.665 instâncias expostas (93,4% sem auth) Zero — Telegram long-polling apenas
Skills de terceiros 341 skills maliciosas encontradas MCP apenas — processos auditáveis
Custo mensal $500–$5.000/mês relatados $200 fixo (Claude Max) ou grátis (Ollama)
Código compreendido 100K+ linhas que ninguém leu Construído brick-by-brick, cada linha revisada
Dados do usuário Cloud compartilhada desconhecida 100% local — sua máquina, suas contas