Configuración de Coding Agents

Configurar OpenClaw: API Key, Base URL y modelos

Configura models.providers de OpenClaw, una BetterToken API Key, el Base URL y modelos de OpenAI Responses o Chat Completions, y valida el Gateway. Más.

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

Ajustes principales

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

Requisitos previos

Instala la versión más reciente de OpenClaw
Crea una BetterToken API Key
Copia un Model ID desde el model plaza o desde el cuadro Setup de la clave

Regístrate y obtén una BetterToken API Key

¿Ya tienes una cuenta? Inicia sesión, recarga el saldo y crea una clave en la consola.

Instalar

macOS / Linux

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

Windows

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

Configuración mediante la línea de comandos

El script de configuración automática de BetterToken escribe la configuración de OpenClaw. Requiere Node.js. Si no pasas una API Key o un Model ID como argumento, el script te los solicitará.

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"

Confirma que agents.defaults.model.primary usa el YOUR_MODEL_ID que aparece en Setup. Después, ejecuta los siguientes comandos para validar la configuración y reiniciar el Gateway.

Configuración manual

Configurar OpenClaw

Copia el Model ID exacto de la model plaza.

Los ejemplos usan un marcador de posición para la API Key por claridad. Para guardar la configuración, OpenClaw recomienda usar SecretRef o sustitución mediante variables de entorno en models.providers.bettertoken.apiKey; sigue la guía oficial de credenciales en lugar de guardar una Key real en un archivo compartido.

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 la conexión

Ejecuta:

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

La configuración está activa cuando la validación finaliza correctamente, el Gateway se reinicia y bettertoken/YOUR_MODEL_ID aparece en la lista y el estado de los modelos. Si una sesión existente sigue usando un modelo anterior, inicia una nueva sesión y vuelve a comprobarlo.

Cambiar de modelo

Añade el modelo nuevo a models.providers.bettertoken.models y cambia agents.defaults.model.primary a bettertoken/YOUR_MODEL_ID. Guarda los cambios, valida la configuración y reinicia el Gateway.

Errores comunes

Error	Solución
`config validate` falla	Comprueba las comas, comillas y llaves del JSON.
`401`	Vuelve a copiar `apiKey` y elimina los espacios.
`404`	`openai-responses`: `/v1/responses`; `openai-completions`: `/v1/chat/completions`. Base URL: `https://bettertoken.ai/v1`.
No aparece el modelo	Confirma que esté tanto en la lista de modelos del proveedor como en `agents.defaults.model.primary`.
Una sesión existente usa el modelo anterior	Ejecuta `openclaw gateway restart` y crea una sesión nueva.