OpenClaw

O que é OpenClaw

O OpenClaw é um assistente pessoal de IA e gateway de código aberto e auto-hospedado que conecta canais de chat como WhatsApp, Slack, Discord, Telegram, iMessage e WebChat a agentes de IA. Ele pode enviar solicitações de modelo suportadas pela Capriole AI ao configurar provedores de modelo personalizados compatíveis com OpenAI e Anthropic.

Pré-requisitos

Antes de começar, confira se você tem:

Uma conta Capriole AI (Cadastre-se aqui)
Uma API key da Capriole AI (Obtenha sua key)

Instalação

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Configuração

Validação dos modelos

OpenClaw 2026.4.21: openai/gpt-6.1-sol, openai/gpt-6-sol, openai/gpt-6-luna, anthropic/claude-fable-5-1, anthropic/claude-opus-5-5, google/gemini-3.8-flash e zai/glm-5.3-flash passam nas verificações locais de leitura de arquivo e resposta final. claude-latest resolve para Fable 5.1. Os IDs concretos anteriores continuam disponíveis. As configurações de capacidade abaixo seguem as especificações publicadas de GPT-6 Astra, GPT-6.1 Sol, GPT-6 Sol, GPT-6 Luna, Fable 5.1, Opus 5.5, Gemini 3.8 Flash e GLM 5.3 Flash. São configurações de capacidade do modelo no cliente, não metas de saída por solicitação nem limites verificados do VectorEngine. As verificações locais de tarefas usaram contextWindow=200000 e maxTokens=2048; solicitações com capacidade máxima não foram validadas. Fable 5.1 também passa pela rota Anthropic Messages. xai/grok-4.6 aceita solicitações de Chat Completions, mas não passou nas verificações de tarefas de agentes e não está na configuração abaixo. Testes diretos no provedor também encontraram uso inconsistente de ferramentas no Grok 4.5; concluir uma solicitação API não comprova uma resposta correta do agente. Configure o provedor GPT:

export CUSTOM_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"
export CAPRIOLE_OPENAI_BASE_URL="https://api.caprioletech.com/v1"

openclaw onboard --non-interactive \
  --accept-risk \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "$CAPRIOLE_OPENAI_BASE_URL" \
  --custom-model-id "openai-latest" \
  --custom-provider-id "capriole-ai-openai" \
  --custom-compatibility openai \
  --secret-input-mode ref \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --skip-channels \
  --skip-search \
  --skip-skills \
  --skip-health \
  --no-install-daemon

openclaw config set models.providers.capriole-ai-openai.request.auth \
  '{"mode":"authorization-bearer","token":"${CUSTOM_API_KEY}"}' \
  --strict-json

openclaw config set models.providers.capriole-ai-openai.api \
  '"openai-responses"' \
  --strict-json

openclaw config set models.providers.capriole-ai-openai.models \
  '[
    {
      "id": "openai-latest",
      "name": "OpenAI latest",
      "api": "openai-responses",
      "contextWindow": 400000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-6-astra",
      "name": "GPT-6 Astra",
      "api": "openai-responses",
      "contextWindow": 1050000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-6.1-sol",
      "name": "GPT-6.1 Sol",
      "api": "openai-responses",
      "contextWindow": 1050000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-6-sol",
      "name": "GPT-6 Sol",
      "api": "openai-responses",
      "contextWindow": 1050000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-6-luna",
      "name": "GPT-6 Luna",
      "api": "openai-responses",
      "contextWindow": 1050000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-5.6-terra",
      "name": "GPT 5.6 Thinking",
      "api": "openai-responses",
      "contextWindow": 1050000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-5.6-luna",
      "name": "GPT 5.6",
      "api": "openai-responses",
      "contextWindow": 1050000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "openai/gpt-5.5",
      "name": "GPT 5.5",
      "api": "openai-responses",
      "contextWindow": 400000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    }
  ]' \
  --strict-json

Configure o provedor Chat Completions de Claude, Grok, GLM e Kimi:

export CUSTOM_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"

openclaw config set models.providers.capriole-ai-compatible \
  '{
    "baseUrl": "https://api.caprioletech.com/v1",
    "apiKey": "${CUSTOM_API_KEY}",
    "api": "openai-completions",
    "models": [
      {
        "id": "anthropic/claude-fable-5-1",
        "name": "Fable 5.1",
        "api": "openai-completions",
        "contextWindow": 1000000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "anthropic/claude-fable-5",
        "name": "Fable 5",
        "api": "openai-completions",
        "contextWindow": 1000000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "anthropic/claude-opus-5-5",
        "name": "Opus 5.5",
        "api": "openai-completions",
        "contextWindow": 1000000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "anthropic/claude-opus-5",
        "name": "Opus 5",
        "api": "openai-completions",
        "contextWindow": 1000000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "google/gemini-3.8-flash",
        "name": "Gemini 3.8 Flash",
        "api": "openai-completions",
        "contextWindow": 1048576,
        "maxTokens": 65536,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "xai/grok-4.7",
        "name": "Grok 4.7",
        "api": "openai-completions",
        "contextWindow": 500000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "xai/grok-4.5",
        "name": "Grok 4.5",
        "api": "openai-completions",
        "contextWindow": 500000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "zai/glm-5.3-flash",
        "name": "GLM 5.3 Flash",
        "api": "openai-completions",
        "contextWindow": 1000000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "zai/glm-5.2",
        "name": "GLM 5.2",
        "api": "openai-completions",
        "contextWindow": 1000000,
        "maxTokens": 128000,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      },
      {
        "id": "moonshot/kimi-k3",
        "name": "Kimi K3",
        "api": "openai-completions",
        "contextWindow": 1048576,
        "maxTokens": 131072,
        "input": ["text"],
        "reasoning": true,
        "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
      }
    ]
  }' \
  --strict-json

Configure o provedor Anthropic:

export CUSTOM_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"
export CAPRIOLE_ANTHROPIC_BASE_URL="https://api.caprioletech.com"

openclaw onboard --non-interactive \
  --accept-risk \
  --mode local \
  --auth-choice custom-api-key \
  --custom-base-url "$CAPRIOLE_ANTHROPIC_BASE_URL" \
  --custom-model-id "claude-latest" \
  --custom-provider-id "capriole-ai-anthropic" \
  --custom-compatibility anthropic \
  --secret-input-mode ref \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --skip-channels \
  --skip-search \
  --skip-skills \
  --skip-health \
  --no-install-daemon

openclaw config set models.providers.capriole-ai-anthropic.request.auth \
  '{"mode":"authorization-bearer","token":"${CUSTOM_API_KEY}"}' \
  --strict-json

openclaw config set models.providers.capriole-ai-anthropic.api \
  '"anthropic-messages"' \
  --strict-json

openclaw config set models.providers.capriole-ai-anthropic.models \
  '[
    {
      "id": "claude-latest",
      "name": "Claude latest",
      "api": "anthropic-messages",
      "contextWindow": 1000000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-fable-5-1",
      "name": "Fable 5.1",
      "api": "anthropic-messages",
      "contextWindow": 1000000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-fable-5",
      "name": "Fable 5",
      "api": "anthropic-messages",
      "contextWindow": 1000000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-opus-5-5",
      "name": "Opus 5.5",
      "api": "anthropic-messages",
      "contextWindow": 1000000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-opus-5",
      "name": "Opus 5",
      "api": "anthropic-messages",
      "contextWindow": 1000000,
      "maxTokens": 128000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-opus-4-8",
      "name": "Opus 4.8",
      "api": "anthropic-messages",
      "contextWindow": 200000,
      "maxTokens": 32000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-opus-4-7",
      "name": "Opus 4.7",
      "api": "anthropic-messages",
      "contextWindow": 200000,
      "maxTokens": 32000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-opus-4-6",
      "name": "Opus 4.6",
      "api": "anthropic-messages",
      "contextWindow": 200000,
      "maxTokens": 32000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    },
    {
      "id": "claude-sonnet-4-6",
      "name": "Sonnet 4.6",
      "api": "anthropic-messages",
      "contextWindow": 200000,
      "maxTokens": 32000,
      "input": ["text"],
      "reasoning": true,
      "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}
    }
  ]' \
  --strict-json

Permita os modelos configurados da Capriole AI para o agente padrão:

openclaw config set agents.defaults.models \
  '{"capriole-ai-openai/openai-latest":{},"capriole-ai-openai/openai/gpt-6-astra":{},"capriole-ai-openai/openai/gpt-6.1-sol":{},"capriole-ai-openai/openai/gpt-6-sol":{},"capriole-ai-openai/openai/gpt-6-luna":{},"capriole-ai-openai/openai/gpt-5.6-terra":{},"capriole-ai-openai/openai/gpt-5.6-luna":{},"capriole-ai-openai/openai/gpt-5.5":{},"capriole-ai-compatible/anthropic/claude-fable-5-1":{},"capriole-ai-compatible/anthropic/claude-fable-5":{},"capriole-ai-compatible/anthropic/claude-opus-5-5":{},"capriole-ai-compatible/anthropic/claude-opus-5":{},"capriole-ai-compatible/google/gemini-3.8-flash":{},"capriole-ai-compatible/xai/grok-4.7":{},"capriole-ai-compatible/xai/grok-4.5":{},"capriole-ai-compatible/zai/glm-5.3-flash":{},"capriole-ai-compatible/zai/glm-5.2":{},"capriole-ai-compatible/moonshot/kimi-k3":{},"capriole-ai-anthropic/claude-latest":{},"capriole-ai-anthropic/claude-fable-5-1":{},"capriole-ai-anthropic/claude-fable-5":{},"capriole-ai-anthropic/claude-opus-5-5":{},"capriole-ai-anthropic/claude-opus-5":{},"capriole-ai-anthropic/claude-opus-4-8":{},"capriole-ai-anthropic/claude-opus-4-7":{},"capriole-ai-anthropic/claude-opus-4-6":{},"capriole-ai-anthropic/claude-sonnet-4-6":{}}' \
  --strict-json

Executar OpenClaw

Inicie o gateway:

export CUSTOM_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"
openclaw gateway --force --port 18789

Abra o TUI em outro terminal:

export CUSTOM_API_KEY="YOUR_CAPRIOLE_AI_API_KEY"
openclaw tui

Modelos suportados

O OpenClaw suporta OpenAI latest, GPT-6 Astra, GPT-6.1 Sol, GPT-6 Sol, GPT-6 Luna, GPT 5.6 Thinking, GPT 5.6, GPT 5.5, Fable 5.1, Fable 5, Opus 5.5, Opus 5, Grok 4.7, Grok 4.5, Gemini 3.8 Flash, GLM 5.3 Flash, GLM 5.2, Kimi K3, Claude latest, Opus 4.8, Opus 4.7, Opus 4.6 e Sonnet 4.6 pela Capriole AI. Fable 5 e Opus 5 podem usar o provedor compatível com Chat Completions ou o provedor Anthropic Messages.

openai-latest
openai/gpt-6-astra
openai/gpt-6.1-sol
openai/gpt-6-sol
openai/gpt-6-luna
openai/gpt-5.6-terra
openai/gpt-5.6-luna
openai/gpt-5.5
anthropic/claude-fable-5-1
anthropic/claude-fable-5
anthropic/claude-opus-5-5
anthropic/claude-opus-5
google/gemini-3.8-flash
xai/grok-4.7
xai/grok-4.5
zai/glm-5.3-flash
zai/glm-5.2
moonshot/kimi-k3
claude-latest
claude-fable-5-1
claude-fable-5
claude-opus-5-5
claude-opus-5
claude-opus-4-8
claude-opus-4-7
claude-opus-4-6
claude-sonnet-4-6

Solução de problemas

Por que as solicitações GPT falham?

Confirme que models.providers.capriole-ai-openai.api está definido como "openai-responses" e que baseUrl é https://api.caprioletech.com/v1.

Por que as solicitações Grok, GLM ou Kimi falham?

Confirme que models.providers.capriole-ai-compatible.api está definido como "openai-completions" e que baseUrl é https://api.caprioletech.com/v1.

Por que as solicitações Anthropic falham?

Confirme que models.providers.capriole-ai-anthropic.api está definido como "anthropic-messages" e que o baseUrl da Anthropic é https://api.caprioletech.com sem /v1.

Por que a autenticação falha?

Exporte CUSTOM_API_KEY no terminal que inicia openclaw gateway e no terminal que inicia openclaw tui.

Por que o OpenClaw informa que um modelo não é permitido ou não está disponível?

Execute openclaw models list e confirme que o modelo selecionado e qualquer lista de permissão de agents.defaults.models incluem a referência de modelo da Capriole AI, como capriole-ai-openai/openai-latest, capriole-ai-compatible/xai/grok-4.5, capriole-ai-compatible/moonshot/kimi-k3 ou capriole-ai-anthropic/claude-latest. Se um modelo da Capriole AI aparecer como ausente, atualize a entrada do modelo com o objeto completo mostrado acima. As versões atuais do OpenClaw precisam de mais do que id e name para modelos de provedor personalizado.

Por que o gateway não inicia?

Execute openclaw status, openclaw gateway status, openclaw logs --follow e openclaw doctor. Corrija problemas de schema, gateway.mode ou serviço antes de tentar de novo.

Por que a porta `18789` falha?

Escolha outra porta local e use a mesma porta para o gateway e a configuração do cliente. Em instalações no modo serviço, execute openclaw doctor --fix ou openclaw gateway install --force depois de alterar a porta.

Observações

Os provedores personalizados do OpenClaw exigem que o modo de API do provedor corresponda à família de endpoint da Capriole AI.
O OpenClaw 2026.4.21 conclui fluxos de ferramenta exec locais com Grok 4.5, GLM 5.2 e Kimi K3 por openai-completions.
A Capriole AI trata a solicitação de modelo. O OpenClaw ainda pode moldar o comportamento final do assistente pelo gateway, pelos canais e pelas configurações do agente.
Referências oficiais: Instalação do OpenClaw, Provedores personalizados do OpenClaw, Provedores de modelo do OpenClaw e Solução de problemas do OpenClaw.

Primeiros passos

Endpoints

Integração com agentes

O que é OpenClaw

Pré-requisitos

Instalação

Configuração

Validação dos modelos

Executar OpenClaw

Modelos suportados

Solução de problemas

Por que as solicitações GPT falham?

Por que as solicitações Grok, GLM ou Kimi falham?

Por que as solicitações Anthropic falham?

Por que a autenticação falha?

Por que o OpenClaw informa que um modelo não é permitido ou não está disponível?

Por que o gateway não inicia?

Por que a porta `18789` falha?

Observações

​O que é OpenClaw

​Pré-requisitos

​Instalação

​Configuração

​Validação dos modelos

​Executar OpenClaw

​Modelos suportados

​Solução de problemas

​Por que as solicitações GPT falham?

​Por que as solicitações Grok, GLM ou Kimi falham?

​Por que as solicitações Anthropic falham?

​Por que a autenticação falha?

​Por que o OpenClaw informa que um modelo não é permitido ou não está disponível?

​Por que o gateway não inicia?

​Por que a porta 18789 falha?

​Observações

O que é OpenClaw

Pré-requisitos

Instalação

Configuração

Validação dos modelos

Executar OpenClaw

Modelos suportados

Solução de problemas

Por que as solicitações GPT falham?

Por que as solicitações Grok, GLM ou Kimi falham?

Por que as solicitações Anthropic falham?

Por que a autenticação falha?

Por que o OpenClaw informa que um modelo não é permitido ou não está disponível?

Por que o gateway não inicia?

Por que a porta `18789` falha?

Observações