Proxy Endpoints

Base URL

O API Proxy roda em cada VPS e esta disponivel apenas internamente:

http://localhost:3100

Essa URL e acessivel apenas de dentro dos containers na mesma VPS. O OpenClaw e configurado automaticamente para usar esse endereco — voce nao precisa configura-lo manualmente.

Autenticacao

Todas as requisicoes devem incluir o header de autorizacao com o token unico do agente:

Authorization: Bearer qc_bot_a1b2c3d4e5f6...

O token e injetado automaticamente no container via variavel de ambiente. O proxy valida o token contra o banco de dados e identifica qual bot esta fazendo a requisicao, incluindo seu tier, modelo e saldo de creditos.

Anthropic - POST /v1/messages

Endpoint para modelos da Anthropic (Claude Opus 4.6, Sonnet 4.5, Haiku 4.5). Usa o formato nativo da Messages API:

{
  "model": "claude-sonnet-4-5-20241022",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Ola, como voce pode me ajudar?"
    }
  ]
}

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Ola! Posso ajudar com diversas tarefas..."
    }
  ],
  "model": "claude-sonnet-4-5-20241022",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 45,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

OpenAI - POST /v1/chat/completions

Endpoint para modelos da OpenAI (GPT-4.1, GPT-4.1 mini, GPT-4o, o3-mini). Usa o formato Chat Completions:

{
  "model": "gpt-4.1",
  "messages": [
    {
      "role": "user",
      "content": "Ola, como voce pode me ajudar?"
    }
  ]
}

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gpt-4.1",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Ola! Posso ajudar com diversas tarefas..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 45,
    "total_tokens": 57
  }
}

Google - Gemini

Para modelos Google (Gemini 2.5 Pro, Gemini 2.0 Flash), o roteamento e feito automaticamente pelo proxy. O OpenClaw envia no formato OpenAI (Chat Completions) e o proxy converte internamente para o formato nativo da Gemini API (GenerateContent).

Do ponto de vista do container, a experiencia e identica a usar a OpenAI — o mesmo formato de entrada e saida. A conversao e transparente.

Respostas de erro

O API Proxy retorna codigos HTTP padrao para indicar problemas. Abaixo os mais comuns: