TokenLab プロバイダの設定

既存のエージェントに設定を任せるCopy Anchor Link

パソコンですでに使えるエージェントに、次のタスクをコピーして渡してください。

このガイドを読み、OpenClaw を TokenLab に接続するのを手伝ってください：
https://tokenlab.sh/docs/ja/guides/tokenlab-provider
インストール済みのバージョンと現在有効な設定を最初に確認してください。
既存のアカウント、プロバイダー、権限、その他の設定を保持してください。
ローカルファイルをバックアップし、変更案を示してください。
必要な API キーは私がローカルで入力します。チャットでキーを求めたり、表示したり、貼り付けたりしないでください。
最初に設定を読み込めることを確認してください。
有料リクエストによるテストは、実行前に費用を別途説明してください。

推奨：プラグインをインストールCopy Anchor Link

任意で公開済みプロバイダープラグイン 0.1.0 をインストールできます。以下の Gateway 環境に TOKENLAB_API_KEY を渡し、モデルはセッションだけで選択してください。初期設定ウィザードは既定モデルを変更するため、この手順では openclaw onboard を実行しません。既存のプラグインと権限を維持し、リクエスト前にプラグインの読み込みとモデル一覧を確認します。

インストーラーが要求する機能を確認し、クライアントの確認画面に従ってください。無関係な権限の付与や既存プラグインの権限変更は行いません。

openclaw plugins install @tokenlabai/openclaw-provider@0.1.0
openclaw plugins list
openclaw models list --provider tokenlab

/model tokenlab/claude-sonnet-5 -s
/model default -s

npm · GitHub

手動プロバイダー設定Copy Anchor Link

独立した Responses API、Claude native、Gemini native、または MiniMax native ルートが明示的に必要な場合のみ、以下の models.providers 手動設定を使用してください。

手動設定を選ぶ場合は、tokenlab のみを構成すれば十分です。Responses API、Claude native、Gemini native、または MiniMax native の動作が明示的に必要な場合にのみ、他のプロバイダを追加してください。

前提条件Copy Anchor Link

• セルフホストの OpenClaw インスタンス
• OpenClaw 2026.9.4 には Node.js >=24.16.0 <25 || >=26.1.0 が必要です（バージョン要件）。他の OpenClaw リリースでは、そのリリースの要件を確認してください。
• TokenLab API Key — Get one here

設定Copy Anchor Link

OpenClaw の設定を編集します:

• セルフホスト: ~/.openclaw/openclaw.json

models.providers の下に TokenLab プロバイダを追加します:

稼働中 Gateway と同じ profile、OPENCLAW_STATE_DIR、OPENCLAW_CONFIG_PATH を使い、設定をバックアップします。TOKENLAB_API_KEY はそのインスタンスの信頼されたグローバル .env またはサービス環境に保存します。端末の export やプロジェクト .env だけではバックグラウンドに届かない場合があります。環境の説明を参照してください。

使用中の設定をバックアップしてください。TokenLab の項目だけを追加し、既存のプロバイダー、アカウント、既定モデル、権限を維持します。名前が使用済みなら別名を選び、コマンドも合わせて変更します。戻す際は追加項目だけを削除するか、以前のバックアップを復元してください。

{
  models: {
    mode: "merge",
    providers: {
      tokenlab: {
        api: "openai-completions",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra" },
          { id: "deepseek-reasoner", name: "DeepSeek Reasoner" },
          { id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
        ]
      },
      "tokenlab-responses": {
        api: "openai-responses",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "tokenlab-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "claude-sonnet-5", name: "Claude Sonnet 5" },
          { id: "claude-opus-5", name: "Claude Opus 5" }
        ]
      },
      "tokenlab-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gemini-3.5-flash", name: "Gemini 3.5 Flash" },
          { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "minimax-m3", name: "MiniMax M3" }
        ]
      }
    }
  }
}

モデルの使用Copy Anchor Link

OpenClaw は引き続き provider/model 形式でモデルを参照します:

OpenClaw 2026.9.4 では -s を付けて現在のセッションだけのモデルを選択します。agents.defaults.model、エージェントの既定値、権限は維持してください。/model default -s でこのセッションを設定済みの既定モデルに戻せます。

/model tokenlab-claude/claude-sonnet-5 -s
/model default -s

モデルの例Copy Anchor Link

利用可能なモデルの一覧は tokenlab.sh/models を参照してください。

どのプロバイダを使うべきかCopy Anchor Link

• tokenlab: 一般的なエージェントやチャット用途のデフォルト選択。
• tokenlab-responses: OpenClaw のワークフローが OpenAI Responses のセマンティクスに明示的に依存する場合に使用。
• tokenlab-claude: Claude のネイティブ Messages 動作を利用したい場合に使用。
• tokenlab-gemini: Gemini ネイティブのリクエスト/レスポンス形式や既存の Gemini スタイル統合を使いたい場合に使用。
• tokenlab-minimax: MiniMax をネイティブルートで利用したい場合に使用。

Gemini ネイティブの動作が不要な場合でも、OpenAI 互換ルートの tokenlab/gemini-* 経由で Gemini モデルを呼び出すことができます。

よくある間違いCopy Anchor Link

設定の検証Copy Anchor Link

同じインスタンスを再起動してモデルとプロバイダーを確認します。--probe なしの models status はモデル呼び出しを検証しません。実際の探測や会話には token を使う場合があります。応答と TokenLab の記録を照合してください。復元時は元のモデルを選び、追加した項目だけを削除します。

openclaw gateway restart
openclaw models status

次のステップCopy Anchor Link

OpenClaw が接続されたら、以下のガイドが TokenLab をより効果的に使うのに役立ちます:

• API 形式 — OpenAI、Responses、Anthropic、Gemini ルートの違いを理解する
• IDE / SDK Compatibility — /v1/responses が適している場合を確認する
• エラー処理 — 一般的な失敗モードと回復パターンを学ぶ
• モデル概要 — エージェントに組み込む前にモデル ID を参照する