メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

このガイドは、self-hosted OpenClaw ユーザー向けで、TokenLab を AI プロバイダとして接続したい方向けです。

​
概要

現在の OpenClaw バージョンでは、推奨される方法は models.providers 経由で TokenLab を構成することです。 素早く始めたいだけなら、tokenlab のみを構成するだけで十分です。Responses API、Claude native、Gemini native、または MiniMax native の動作が明示的に必要な場合にのみ、他のプロバイダを追加してください。
プロバイダーOpenClaw api最適用途baseUrl
tokenlabopenai-completionsGPT、DeepSeek、Qwen、およびほとんどの OpenAI 互換コールhttps://api.tokenlab.sh/v1
tokenlab-responsesopenai-responses/v1/responses セマンティクスを期待する OpenAI Responses ワークフローhttps://api.tokenlab.sh/v1
tokenlab-claudeanthropic-messagesClaude のネイティブ Messages APIhttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-aiGemini のネイティブ API 形式https://api.tokenlab.sh
tokenlab-minimaxanthropic-messagesMiniMax のネイティブルーティングhttps://api.tokenlab.sh
/v1 サフィックスは openai-completions と openai-responses のみで使用してください。anthropic-messages や google-generative-ai のようなネイティブプロバイダは、/v1 なしの https://api.tokenlab.sh を使用する必要があります。さもないと OpenClaw が誤ったアップストリームパスを構築する可能性があります。

​
前提条件

  • セルフホストの OpenClaw インスタンス
  • TokenLab API Key — Get one here

​
設定

OpenClaw の設定を編集します:
  • セルフホスト: ~/.openclaw/openclaw.json
models.providers の下に TokenLab プロバイダを追加します: 
{
  agents: {
    defaults: {
      model: {
        primary: "tokenlab-claude/claude-sonnet-4-6"
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      tokenlab: {
        api: "openai-completions",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o" },
          { id: "deepseek-r1", name: "DeepSeek R1" },
          { id: "qwen3-32b", name: "Qwen 3 32B" }
        ]
      },
      "tokenlab-responses": {
        api: "openai-responses",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "tokenlab-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
          { id: "claude-opus-4-6", name: "Claude Opus 4.6" }
        ]
      },
      "tokenlab-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "gemini-3-flash-preview", name: "Gemini 3 Flash Preview" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "minimax-m1", name: "MiniMax M1" }
        ]
      }
    }
  }
}
5 つのプロバイダはすべて 同じ API Key を使用します。TokenLab アカウントは 1 つあれば十分です。
上記の models 配列は一般的な例のみを示しています。必要に応じて各プロバイダにモデル ID を追加してください。

​
モデルの使用

OpenClaw は引き続き provider/model 形式でモデルを参照します: 
{
  agents: {
    defaults: {
      model: {
        primary: "tokenlab-gemini/gemini-2.5-flash"
      }
    }
  }
}

​
モデルの例

プロバイダーモデル参照説明
tokenlabtokenlab/gpt-4oOpenAI 互換ルート
tokenlabtokenlab/deepseek-r1DeepSeek 推論モデル
tokenlab-responsestokenlab-responses/gpt-4oResponses API ルート
tokenlab-claudetokenlab-claude/claude-sonnet-4-6ネイティブ Claude Messages ルート
tokenlab-geminitokenlab-gemini/gemini-2.5-flashネイティブ Gemini ルート
tokenlab-minimaxtokenlab-minimax/minimax-m1ネイティブ MiniMax ルート
利用可能なモデルの一覧は tokenlab.sh/models を参照してください。

​
どのプロバイダを使うべきか

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

​
よくある間違い

現在の OpenClaw ドキュメントは models.providers を使用します。古いトップレベルの providers 配列形式のままにしておくと、OpenClaw が設定を無視したり、プロバイダプレフィックスの解決に失敗したりする可能性があります。
openai-responses は TokenLab の /v1/responses パスにマップされるため、tokenlab-responses は https://api.tokenlab.sh/v1 を使用する必要があります。
anthropic-messages や google-generative-ai は https://api.tokenlab.sh を /v1 なしで使用するべきです。/v1 を追加すると不正確なリクエストパスが生成される可能性があります。
はい。現在の OpenClaw ドキュメントは組み込みの google プロバイダを引き続き含み、api: "google-generative-ai" を使ったカスタムプロバイダもサポートしています。したがって tokenlab-gemini は OpenClaw ユーザーにとって有効なネイティブ Gemini ルートのままです。

​
設定の検証

設定を保存したら、OpenClaw インスタンスを再起動し、簡単なメッセージでテストしてください。レスポンスが返ってくれば、プロバイダは正しく構成されています。 
# セルフホスト: サービスを再起動
systemctl --user restart openclaw    # Linux
launchctl stop cc.tokenlab.openclaw && launchctl start cc.tokenlab.openclaw  # macOS

​
次のステップ

OpenClaw が接続されたら、以下のガイドが TokenLab をより効果的に使うのに役立ちます:
  • API 形式 — OpenAI、Responses、Anthropic、Gemini ルートの違いを理解する
  • IDE / SDK Compatibility — /v1/responses が適している場合を確認する
  • エラー処理 — 一般的な失敗モードと回復パターンを学ぶ
  • モデル概要 — エージェントに組み込む前にモデル ID を参照する