Arquitetura - Visao Geral
Como o QuickClaw funciona por dentro. Stack tecnologica e componentes principais.
Stack tecnologica
O QuickClaw e composto por diversas camadas que trabalham juntas para entregar uma experiencia de deploy e gerenciamento de bots totalmente automatizada.
| Camada | Tecnologia | Descricao |
|---|---|---|
| Frontend | Next.js 14 + Tailwind + shadcn/ui | Hospedado na Vercel com auto-deploy via GitHub |
| Backend | Supabase (PostgreSQL + Auth + Edge Functions) | Banco de dados, autenticacao e 18 funcoes serverless |
| Pagamentos | Stripe | Checkout, assinaturas, portal do cliente e webhooks |
| VPS | Hostinger KVM 8 | 32GB RAM, 8 vCPU, 400GB SSD, 32TB de banda |
| Proxy | API Proxy (Node.js) | Roteia requisicoes de IA, autentica e contabiliza tokens |
| Renderizacao | Media Render (Node.js) | Converte HTML em imagens PNG e documentos PDF via Puppeteer |
| Gerenciamento | Agent Manager + PM2 | Lifecycle dos containers, health checks e reconciliacao |
Componentes principais
Frontend (Dashboard)
Interface web onde o usuario gerencia seus bots. Permite criar, configurar, monitorar e parar bots. Tambem exibe consumo de creditos, alertas e historico de uso. Hospedado na Vercel com deploy automatico a cada push na branch main.
Supabase
Banco de dados PostgreSQL gerenciado, sistema de autenticacao (email, Google OAuth, GitHub OAuth) e funcoes serverless (Edge Functions). E o ponto central de dados do sistema — bots, slots, assinaturas, creditos, skills e configuracoes ficam aqui.
Edge Functions
18 funcoes serverless que orquestram operacoes criticas: ativar/desativar bots, processar webhooks do Stripe, gerenciar skills, escalar VPS, enviar emails e realizar reconciliacao. Rodam no edge da Supabase (Deno).
VPS + Agent Manager
Cada VPS roda o Agent Manager, um servico Node.js/Fastify responsavel por criar, iniciar, parar e monitorar containers. Ele garante que o estado real dos containers esteja sincronizado com o banco de dados.
API Proxy
Servico que roda na porta 3100 de cada VPS. Todas as chamadas de IA passam por ele. O proxy autentica o agente, roteia para o provedor correto (Anthropic, OpenAI, Google, OpenRouter), contabiliza tokens (incluindo cache) e debita creditos automaticamente.
Media Render Service
Servico de renderizacao que roda na porta 3200 de cada VPS. Converte HTML em imagens PNG ou documentos PDF usando Puppeteer (Chromium headless). Skills que precisam gerar graficos, tabelas ou documentos visuais usam esse servico. O Chrome roda no host com recursos completos, contornando as restricoes de seguranca dos containers.
Containers (OpenClaw)
Cada agente roda em um container isolado com 1 vCPU, 4GB RAM, rede propria e 20+ camadas de seguranca/privacidade. O OpenClaw dentro do container conecta ao canal de mensagem (Telegram, Discord, etc.) e processa conversas com IA.
Diagrama simplificado
O fluxo de dados do QuickClaw segue esta cadeia:
Caminho de uma mensagem
Quando um usuario envia uma mensagem no Telegram, ela percorre todo esse caminho (de baixo para cima e de volta) em milissegundos. O container recebe a mensagem, chama o API Proxy, que roteia para o provedor de IA, e a resposta volta pelo mesmo caminho.
Explore mais
Cada componente tem sua propria pagina com detalhes tecnicos aprofundados:
- Como Funciona — Fluxo completo: do checkout ao agente online respondendo mensagens
- Containers e VPS — Infraestrutura de containers isolados em VPS de alta performance
- API Proxy — Como o proxy roteia, autentica e contabiliza tokens
- Agent Manager — Gerenciamento de lifecycle dos containers
