Pular para o conteúdo principal
Com uma única API key da Capriole AI, você usa GPT-6.2 Astra, Claude Fable 5.1, Opus 5.5 e Gemini 4 Carbon no OpenClaw pagando até 92% menos que os preços oficiais da API.

O que é OpenClaw

O OpenClaw é um assistente pessoal de IA e gateway de código aberto e auto-hospedado. Ele conecta canais de chat como WhatsApp, Slack, Discord, Telegram, iMessage e WebChat a agentes de IA. Esta configuração adiciona a Capriole AI como três provedores de modelo personalizados, um para cada protocolo de API que a Capriole AI oferece.

Pré-requisitos

Antes de começar, confira se você tem:
  • Uma conta Capriole AI (Cadastre-se aqui)
  • Um plano Premium (USD 9 por mês, também inclui chat na web ilimitado) ou um plano Team, necessário para a API key (Assine)
  • Uma API key da Capriole AI (Obtenha sua key)

Instalação

Instale o OpenClaw com o script oficial de instalação:
Depois, conclua a configuração inicial do próprio OpenClaw:

Configuração

Validação dos modelos

O OpenClaw 2026.4.21 passa nas verificações de leitura de arquivo, escrita de arquivo e resposta final pela Capriole AI com todos os modelos da seção Modelos suportados, usando a configuração abaixo. Adicione o bloco models e as configurações de modelo de agents.defaults abaixo a ~/.openclaw/openclaw.json. Mantenha as outras configurações que openclaw onboard gravou.
O que cada configuração faz:
  • capriole-ai-openai envia os modelos GPT para a API Responses. capriole-ai-anthropic envia os modelos Claude para Anthropic Messages. capriole-ai-compatible envia os modelos Gemini, Grok, GLM e Kimi para Chat Completions.
  • ${CAPRIOLE_AI_API_KEY} lê sua key do ambiente.
  • request.auth com authorization-bearer faz o provedor Anthropic enviar a key como Bearer token.
  • O baseUrl da Anthropic não tem /v1, porque o próprio OpenClaw adiciona /v1/messages.
  • reasoning é false para o Opus 5.5. Quando é true, o OpenClaw envia um orçamento de raciocínio, e o Opus 5.5 o rejeita com requires adaptive thinking.
  • contextWindow e maxTokens informam ao OpenClaw os limites de cada modelo.
  • agents.defaults.models é a lista de modelos que os agentes podem usar. agents.defaults.model.primary é o padrão.

Executar OpenClaw

Exporte sua key em cada terminal que inicia o OpenClaw:
Inicie o gateway:
Abra a interface de terminal em outro terminal:
Para uma execução local pontual sem o gateway:

Modelos suportados

As referências de modelo usam o formato <provider-id>/<model-id>. openai-latest, claude-latest e google-latest sempre apontam para o nosso modelo principal mais recente de cada família, atualmente GPT-6.2 Astra, Claude Fable 5.1 e Gemini 4 Carbon.

Solução de problemas

Por que a autenticação falha?

Exporte CAPRIOLE_AI_API_KEY no terminal que inicia openclaw gateway ou openclaw agent. O OpenClaw exibe missing env var quando a variável não está definida.

Por que o Opus 5.5 falha com requires adaptive thinking?

Defina reasoning como false para claude-opus-5-5.

Por que o OpenClaw informa que um modelo não é permitido ou está ausente?

Execute openclaw models list. Confirme que a referência do modelo está em agents.defaults.models e que a entrada do modelo tem o objeto completo mostrado acima, e não só id e name.

Por que uma nova sessão começa com uma conversa de configuração?

Essa é a configuração do espaço de trabalho que o OpenClaw faz na primeira execução, e não um problema da Capriole AI. Conclua-a uma vez em openclaw tui ou execute openclaw onboard de novo.

Por que o gateway não inicia?

Execute openclaw status, openclaw gateway status, openclaw logs --follow e openclaw doctor.

Observações

Última modificação em 18 de novembro de 2026