Configurar o OpenClaw: API Key, Base URL e modelos personalizados

O OpenClaw se conecta ao BetterToken pelo arquivo ~/.openclaw/openclaw.json. Os modelos do provedor GPT usam openai-responses; os demais provedores compatíveis usam openai-completions.

Configurações principais

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://www.bettertoken.ai/v1`
Modelo	`YOUR_MODEL_ID`

Pré-requisitos

Instale a versão mais recente do OpenClaw
Crie uma BetterToken API Key
Copie um Model ID do model plaza ou da janela Setup da chave

Instalar

macOS / Linux
Windows

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

iwr -useb https://openclaw.ai/install.ps1 | iex

Configuração pela linha de comando

O script de configuração automática do BetterToken grava a configuração do OpenClaw. Ele requer Node.js. Se você não informar uma API Key ou um Model ID como argumento, o script solicitará esses dados.

macOS / Linux
Windows

curl -fsSL "https://bettertoken.ai/install-openclaw-provider.sh" | bash

iwr "https://bettertoken.ai/install-openclaw-provider.ps1" -OutFile "$env:TEMP\install-openclaw-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-openclaw-provider.ps1"

Confirme se agents.defaults.model.primary usa o YOUR_MODEL_ID exibido em Setup. Depois, execute os comandos abaixo para validar a configuração e reiniciar o Gateway.

Configuração manual

Configurar o OpenClaw

Edite ~/.openclaw/openclaw.json. Use somente o exemplo correspondente ao provedor do seu Model ID.

GPT: openai-responses
Non-GPT: openai-completions

{
  "models": {
    "mode": "merge",
    "providers": {
      "bettertoken": {
        "baseUrl": "https://www.bettertoken.ai/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-responses",
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "YOUR_MODEL_ID"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bettertoken/YOUR_MODEL_ID"
      }
    }
  }
}

{
  "models": {
    "mode": "merge",
    "providers": {
      "bettertoken": {
        "baseUrl": "https://www.bettertoken.ai/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "YOUR_MODEL_ID"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bettertoken/YOUR_MODEL_ID"
      }
    }
  }
}

Não deduza api pelo nome do modelo. GPT usa openai-responses. Use openai-completions com um provedor que não seja GPT somente quando o model plaza ou a janela Setup confirmar a compatibilidade.

Verificar a conexão

Execute:

openclaw config validate
openclaw gateway restart
openclaw models list
openclaw models status

A configuração está ativa quando a validação passa, o Gateway reinicia e bettertoken/YOUR_MODEL_ID aparece na lista e no status dos modelos. Se uma sessão existente ainda usar um modelo antigo, inicie uma nova sessão e verifique novamente.

Trocar de modelo

Adicione o novo modelo a models.providers.bettertoken.models e altere agents.defaults.model.primary para bettertoken/YOUR_MODEL_ID. Salve, valide a configuração e reinicie o Gateway.

Erros comuns

Erro	Solução
Falha em `config validate`	Verifique as vírgulas, aspas e chaves do JSON.
`401`	Copie `apiKey` novamente e remova os espaços.
`404` ou erro de protocolo	GPT deve usar `openai-responses`; provedores que não sejam GPT devem usar `openai-completions`. Não acrescente um endpoint à Base URL.
Modelo ausente	Confirme se ele aparece na lista de modelos do provedor e em `agents.defaults.model.primary`.
A sessão existente usa o modelo antigo	Execute `openclaw gateway restart` e crie uma nova sessão.

Configuração avançada

Provedores compatíveis

Provedor	Status
Claude	Sem suporte
GPT	Linha de comando e configuração manual
Kimi	Configuração manual
GLM	Configuração manual

Os status se aplicam ao método de configuração do BetterToken descrito nesta página.

O que significa cada método de configuração

Configuração pela linha de comando e manual: use um comando gerado ou siga todas as etapas manuais.
Configuração manual: informe a API Key, a Base URL e o Model.
Sem suporte: ainda não há um método verificado de conexão direta.

Perguntas frequentes relacionadas

Opcional: gerenciar o provedor com o CC Switch

Para gerenciar provedores de várias ferramentas em um só lugar, consulte Configurar o OpenClaw no CC Switch.

Detalhes técnicos

Responses e Chat Completions

openai-responses faz o OpenClaw chamar /v1/responses para os modelos do provedor GPT. openai-completions chama /v1/chat/completions para provedores compatíveis que não sejam GPT. Ambos usam https://www.bettertoken.ai/v1 como baseUrl.

Primeiros passos

Configuração de Coding Agents

Configuração de plataformas de aplicações de IA

Configuração avançada

Configurar o OpenClaw: API Key, Base URL e modelos personalizados

Configurações principais

Pré-requisitos

Instalar

Configuração pela linha de comando

Configuração manual

Configurar o OpenClaw

Verificar a conexão

Trocar de modelo

Erros comuns

Configuração avançada

Provedores compatíveis

Perguntas frequentes relacionadas

Opcional: gerenciar o provedor com o CC Switch

Detalhes técnicos

​Configurações principais

​Pré-requisitos

​Instalar

​Configuração pela linha de comando

​Configuração manual

​Configurar o OpenClaw

​Verificar a conexão

​Trocar de modelo

​Erros comuns

​Configuração avançada

​Provedores compatíveis

​Perguntas frequentes relacionadas

​Opcional: gerenciar o provedor com o CC Switch

​Detalhes técnicos

Configurações principais

Pré-requisitos

Instalar

Configuração pela linha de comando

Configuração manual

Configurar o OpenClaw

Verificar a conexão

Trocar de modelo

Erros comuns

Configuração avançada

Provedores compatíveis

Perguntas frequentes relacionadas

Opcional: gerenciar o provedor com o CC Switch

Detalhes técnicos