API Reference
Referencia de API para usuarios avancados e desenvolvedores.
Avancado
Para quem e?
Esta secao e destinada a desenvolvedores e usuarios avancados, especialmente os do plano Flex que trazem suas proprias chaves de API (BYOK).
Se voce e usuario final e usa os planos Starter ou Pro, nao precisa se preocupar com nada aqui. O QuickClaw cuida de tudo automaticamente — autenticacao, roteamento, contabilizacao de tokens e cobranca.
Nao e obrigatorio
A API Reference e puramente informativa. Voce nao precisa interagir diretamente com nenhum desses endpoints. O OpenClaw dentro do seu container faz tudo automaticamente.
API Proxy
Cada agente no QuickClaw se comunica com provedores de IA (Anthropic, OpenAI, Google, OpenRouter) atraves do API Proxy. O proxy e o intermediario que:
- Autentica cada requisicao usando o token unico do agente
- Roteia para o provedor correto baseado no modelo configurado
- Contabiliza tokens consumidos com precisao (cache-aware pricing)
- Debita creditos automaticamente apos cada requisicao
O proxy roda em cada VPS na porta 3100 e e acessivel apenas internamente — nenhuma chamada externa e possivel.
Autenticacao
Todas as requisicoes ao API Proxy usam o header de autorizacao com um token unico por bot, gerado automaticamente no momento da ativacao:
Authorization: Bearer qc_bot_a1b2c3d4e5f6...O formato do token e qc_bot_ seguido de 32 caracteres hexadecimais. Cada agente tem seu proprio token e ele nunca e armazenado em disco — e injetado via variavel de ambiente no container.
Token unico por bot
O token e gerado automaticamente e voce nao precisa configura-lo. Ele e rotacionado quando voce regenera a chave de API do agente no dashboard, na tab Secrets & API Keys.
Documentacao detalhada
Explore cada area da API Reference para informacoes mais aprofundadas:
