Configuration des Coding Agents

Configurer OpenClaw : clé API, Base URL et modèles

Configurez models.providers dans OpenClaw, une BetterToken API Key, la Base URL et les modèles OpenAI Responses ou Chat Completions, puis validez le Gateway.

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

Paramètres principaux

Champ	Valeur
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Modèle	`YOUR_MODEL_ID`

Prérequis

Installez la dernière version d’OpenClaw
Créez une BetterToken API Key
Copiez un Model ID depuis le model plaza ou la boîte de dialogue Setup de l’API Key

Inscrivez-vous et obtenez une BetterToken API Key

Vous avez déjà un compte ? Connectez-vous, rechargez votre solde, puis créez une clé dans la console.

Installation

macOS / Linux

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

Windows

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

Configuration par la ligne de commande

Le script de configuration automatique BetterToken écrit la configuration OpenClaw. Il nécessite Node.js. Si vous ne transmettez pas l’API Key ou le Model ID en argument, le script vous les demande.

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"

Vérifiez que agents.defaults.model.primary utilise le YOUR_MODEL_ID affiché dans Setup, puis exécutez les commandes ci-dessous pour valider la configuration et redémarrer le Gateway.

Configuration manuelle

Configurer OpenClaw

Copiez le Model ID exact depuis la model plaza.

Les exemples utilisent un emplacement réservé pour l’API Key afin de faciliter la lecture. Pour une configuration enregistrée, OpenClaw recommande une SecretRef ou une substitution par variable d’environnement pour models.providers.bettertoken.apiKey ; suivez les instructions officielles sur les identifiants plutôt que d’enregistrer une vraie Key dans un fichier partagé.

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.

Vérifier la connexion

Exécutez :

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

La configuration est active lorsque la validation réussit, que le Gateway redémarre et que bettertoken/YOUR_MODEL_ID apparaît dans la liste et le statut des modèles. Si une session existante utilise toujours un ancien modèle, créez une nouvelle session et vérifiez de nouveau.

Changer de modèle

Ajoutez le nouveau modèle à models.providers.bettertoken.models, puis définissez agents.defaults.model.primary sur bettertoken/YOUR_MODEL_ID. Enregistrez, validez la configuration et redémarrez le Gateway.

Erreurs fréquentes

Erreur	Solution
Échec de `config validate`	Vérifiez les virgules, guillemets et accolades du JSON.
`401`	Copiez de nouveau `apiKey` et supprimez les espaces.
`404`	`openai-responses`: `/v1/responses`; `openai-completions`: `/v1/chat/completions`. Base URL: `https://bettertoken.ai/v1`.
Modèle absent	Vérifiez qu’il figure dans la liste des modèles du fournisseur et dans `agents.defaults.model.primary`.
La session existante utilise l’ancien modèle	Exécutez `openclaw gateway restart` et créez une nouvelle session.