Configuração de Coding Agents

Configurar OpenClaw: API Key, Base URL e modelos

Configure models.providers do OpenClaw, uma BetterToken API Key, a Base URL e modelos OpenAI Responses ou Chat Completions, e valide o Gateway. Na prática.

openai-responses: /v1/responses; openai-completions: /v1/chat/completions. Base URL: https://bettertoken.ai/v1.

Configurações principais

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://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

Cadastre-se e obtenha uma BetterToken API Key

Já tem uma conta? Entre, recarregue o saldo e crie uma chave no console.

Instalar

macOS / Linux

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

Windows

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

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

Windows

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

Copie o Model ID exato da model plaza.

Os exemplos usam um placeholder de API Key para facilitar a leitura. Em uma configuração salva, o OpenClaw recomenda um SecretRef ou a substituição por variável de ambiente em models.providers.bettertoken.apiKey; siga as orientações oficiais sobre credenciais em vez de armazenar uma chave real em um arquivo compartilhado.

Responses API

{
  "models": {
    "mode": "merge",
    "providers": {
      "bettertoken": {
        "baseUrl": "https://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"
      }
    }
  }
}

Chat Completions

{
  "models": {
    "mode": "merge",
    "providers": {
      "bettertoken": {
        "baseUrl": "https://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"
      }
    }
  }
}

openai-responses: /v1/responses; openai-completions: /v1/chat/completions. Base URL: https://bettertoken.ai/v1.

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`	`openai-responses`: `/v1/responses`; `openai-completions`: `/v1/chat/completions`. Base URL: `https://bettertoken.ai/v1`.
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.