Coding Agent のセットアップ

OpenClaw の API とカスタムモデル設定

OpenClaw の models.providers に BetterToken API Key と Base URL を設定。Responses または Chat Completions を選び接続を確認します。

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

主な設定

項目	値
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
モデル	`YOUR_MODEL_ID`

前提条件

最新版の OpenClaw をインストールする
BetterToken API Key を作成する
model plaza またはキーの Setup ダイアログから Model ID をコピーする

登録して BetterToken API Key を取得

アカウントをお持ちの方は、ログインして残高をチャージし、コンソールでキーを作成してください。

インストール

macOS / Linux

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

Windows

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

コマンドラインで設定する

BetterToken の自動設定スクリプトが OpenClaw の設定を書き込みます。このスクリプトには Node.js が必要です。API Key または Model ID を引数で指定しなかった場合は、実行時に入力を求められます。

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"

agents.defaults.model.primary に Setup で表示された YOUR_MODEL_ID が設定されていることを確認します。その後、以下のコマンドで設定を検証し、Gateway を再起動します。

手動で設定する

OpenClaw を設定する

モデル広場から正確な Model ID をコピーしてください。

例では説明のために API Key のプレースホルダーを使っています。保存する設定では、OpenClaw は models.providers.bettertoken.apiKey に SecretRef または環境変数による置換を推奨しています。共有ファイルに実際の Key を保存せず、公式の認証情報ガイドに従ってください。

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.

接続を確認する

次のコマンドを実行します。

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

検証が成功し、Gateway が再起動して、モデル一覧とステータスに bettertoken/YOUR_MODEL_ID が表示されれば設定は有効です。既存のセッションが古いモデルを使い続ける場合は、新しいセッションを開始してもう一度確認してください。

モデルを切り替える

新しいモデルを models.providers.bettertoken.models に追加し、agents.defaults.model.primary を bettertoken/YOUR_MODEL_ID に変更します。保存して設定を検証し、Gateway を再起動してください。

よくあるエラー

エラー	対処方法
`config validate` が失敗する	JSON のカンマ、引用符、波括弧を確認します。
`401`	`apiKey` をもう一度コピーし、余分な空白を削除します。
`404`	`openai-responses`: `/v1/responses`; `openai-completions`: `/v1/chat/completions`. Base URL: `https://bettertoken.ai/v1`.
モデルが表示されない	プロバイダーのモデル一覧と `agents.defaults.model.primary` の両方にモデルがあることを確認します。
既存のセッションで古いモデルが使われる	`openclaw gateway restart` を実行し、新しいセッションを作成します。