Configurar OpenClaw: API Key, Base URL y modelos personalizados

OpenClaw se conecta a BetterToken mediante ~/.openclaw/openclaw.json. Los modelos del proveedor GPT usan openai-responses; los demás proveedores compatibles usan openai-completions.

Ajustes principales

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

Instalar

macOS / Linux
Windows

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

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
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"

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

Edita ~/.openclaw/openclaw.json. Usa solo el ejemplo que corresponda al proveedor de tu 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"
      }
    }
  }
}

No deduzcas api a partir del nombre de un modelo. GPT usa openai-responses. Usa openai-completions con un proveedor que no sea GPT solo cuando el model plaza o el cuadro Setup confirmen la compatibilidad.

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` o error de protocolo	GPT debe usar `openai-responses`; los proveedores que no sean GPT deben usar `openai-completions`. No añadas un endpoint al Base URL.
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.

Configuración avanzada

Proveedores compatibles

Proveedor	Estado
Claude	No compatible
GPT	Línea de comandos y configuración manual
Kimi	Configuración manual
GLM	Configuración manual

Los estados se aplican al método de configuración de BetterToken descrito en esta página.

Qué significa cada método de configuración

Configuración por línea de comandos y manual: usa un comando generado o sigue todos los pasos manuales.
Configuración manual: introduce la API Key, la Base URL y el Model.
No compatible: todavía no hay un método de conexión directa verificado.

Preguntas frecuentes relacionadas

Opcional: gestionar el proveedor con CC Switch

Para gestionar los proveedores de varias herramientas desde un solo lugar, consulta Configurar OpenClaw en CC Switch.

Detalles técnicos

Responses y Chat Completions

openai-responses hace que OpenClaw llame a /v1/responses para los modelos del proveedor GPT. openai-completions llama a /v1/chat/completions para los proveedores compatibles que no sean GPT. Ambos usan https://www.bettertoken.ai/v1 como baseUrl.

Primeros pasos

Configuración de Coding Agents

Configuración de plataformas de aplicaciones de IA

Configuración avanzada

Configurar OpenClaw: API Key, Base URL y modelos personalizados

Ajustes principales

Requisitos previos

Instalar

Configuración mediante la línea de comandos

Configuración manual

Configurar OpenClaw

Verificar la conexión

Cambiar de modelo

Errores comunes

Configuración avanzada

Proveedores compatibles

Preguntas frecuentes relacionadas

Opcional: gestionar el proveedor con CC Switch

Detalles técnicos

​Ajustes principales

​Requisitos previos

​Instalar

​Configuración mediante la línea de comandos

​Configuración manual

​Configurar OpenClaw

​Verificar la conexión

​Cambiar de modelo

​Errores comunes

​Configuración avanzada

​Proveedores compatibles

​Preguntas frecuentes relacionadas

​Opcional: gestionar el proveedor con CC Switch

​Detalles técnicos

Ajustes principales

Requisitos previos

Instalar

Configuración mediante la línea de comandos

Configuración manual

Configurar OpenClaw

Verificar la conexión

Cambiar de modelo

Errores comunes

Configuración avanzada

Proveedores compatibles

Preguntas frecuentes relacionadas

Opcional: gestionar el proveedor con CC Switch

Detalles técnicos