swarm — contexto
Projeto swarm (kodama1/swarm)
O que faz
Sistema de agentes Claude autônomos que opera como um "terrário econômico" sempre ativo. Os agentes descobrem nichos de mercado, produzem produtos digitais e executam vendas em marketplaces como Etsy, Gumroad e Amazon KDP, com supervisão humana mínima via dashboard e alertas Telegram.
Stack principal
- Runtime de agentes: OpenClaw (Claude), rodando em VPS via systemd
- Banco de dados: PostgreSQL (estado persistente de toda a operação)
- Dashboard: Astro + React Islands + SSE para tempo real, com OAuth via vault Kodama
- Infra: Docker Compose, Caddy como proxy reverso
- Notificações: Telegram (somente alertas críticos)
Estrutura do monorepo
infra/ docker-compose, Caddyfile, .env example
db/ schema.sql, seed, migrations
openclaw/ SOUL, AGENTS, USER, MEMORY, HEARTBEAT + skills
dashboard/ frontend de monitoramento + human-in-loop
Tabelas relevantes no banco
playbooks, niches, products, metrics, treasurer_log, approvals, agent_events, alerts
Playbooks ativos
| Playbook | Marketplace | Janela de kill |
|---|---|---|
| etsy_pod | Etsy + Printify | 21 dias |
| gumroad_notion | Gumroad | 14 dias |
| kdp_ebooks | Amazon KDP | 45 dias |
Agentes e componentes notáveis
- SOUL: núcleo de identidade e diretivas do agente
- HEARTBEAT: loop always-on que mantém os agentes ativos
- MEMORY: persistência de contexto entre ciclos
- AGENTS/USER: camadas de orquestração e interação humana
- Skills: módulos especializados acoplados ao OpenClaw (descoberta de nicho, geração de produto, publicação em marketplace)
Comandos comuns (inferidos da estrutura)
docker compose -f infra/docker-compose.yml up -d # sobe Postgres + dashboard
psql -f db/schema.sql # inicializa schema
# OpenClaw gerenciado via systemd na VPS Hermes
systemctl start openclaw
systemctl status openclaw
Status atual
Pré-implementação. Meta da semana 1: OpenClaw operacional, loop Gumroad fechado, dashboard base funcional.