> ## 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. # TokenLab プロバイダの設定 > OpenAI、Responses、Anthropic、Gemini 互換ルートを使用して OpenClaw にカスタムプロバイダとして TokenLab を構成する このガイドは、**self-hosted OpenClaw** ユーザー向けで、TokenLab を AI プロバイダとして接続したい方向けです。 ## 推奨：プラグインをインストール 通常の OpenClaw エージェント実行には、TokenLab プロバイダープラグインをインストールしてください： ```bash theme={null} openclaw plugins install @tokenlabai/openclaw-provider openclaw onboard --tokenlab-api-key "$TOKENLAB_API_KEY" ``` プラグインは TokenLab のライブチャットモデルカタログを取得し、オフライン検出用に 18 個のフォールバックモデルも保持します。モデルは `tokenlab/` 形式で指定します。 [npm パッケージ](https://www.npmjs.com/package/@tokenlabai/openclaw-provider) · [ClawHub リスト](https://clawhub.ai/tokenlabai/plugins/openclaw-provider) · [ソースコード](https://github.com/hedging8563/tokenlab-openclaw-provider) ## 手動プロバイダー設定 独立した **Responses API**、**Claude native**、**Gemini native**、または **MiniMax native** ルートが明示的に必要な場合のみ、以下の `models.providers` 手動設定を使用してください。 手動設定を選ぶ場合は、`tokenlab` のみを構成すれば十分です。**Responses API**、**Claude native**、**Gemini native**、または **MiniMax native** の動作が明示的に必要な場合にのみ、他のプロバイダを追加してください。 | プロバイダー | OpenClaw `api` | 最適用途 | baseUrl | | -------------------- | ---------------------- | ---------------------------------------------------- | ---------------------------- | | `tokenlab` | `openai-completions` | GPT、DeepSeek、Qwen、およびほとんどの OpenAI 互換コール | `https://api.tokenlab.sh/v1` | | `tokenlab-responses` | `openai-responses` | `/v1/responses` セマンティクスを期待する OpenAI Responses ワークフロー | `https://api.tokenlab.sh/v1` | | `tokenlab-claude` | `anthropic-messages` | Claude のネイティブ Messages API | `https://api.tokenlab.sh` | | `tokenlab-gemini` | `google-generative-ai` | Gemini のネイティブ API 形式 | `https://api.tokenlab.sh` | | `tokenlab-minimax` | `anthropic-messages` | MiniMax のネイティブルーティング | `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](https://tokenlab.sh/dashboard) ## 設定 OpenClaw の設定を編集します: * **セルフホスト**: `~/.openclaw/openclaw.json` `models.providers` の下に TokenLab プロバイダを追加します: ```json5 theme={null} { 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-coder-flash", name: "Qwen 3 Coder Flash" } ] }, "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-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: "sk-your-tokenlab-key", models: [ { id: "minimax-m3", name: "MiniMax M3" } ] } } } } ``` 5 つのプロバイダはすべて **同じ API Key** を使用します。TokenLab アカウントは 1 つあれば十分です。 上記の `models` 配列は一般的な例のみを示しています。必要に応じて各プロバイダにモデル ID を追加してください。 ## モデルの使用 OpenClaw は引き続き `provider/model` 形式でモデルを参照します: ```json5 theme={null} { agents: { defaults: { model: { primary: "tokenlab-gemini/gemini-3.5-flash" } } } } ``` ### モデルの例 | プロバイダー | モデル参照 | 説明 | | -------------------- | ----------------------------------- | ------------------------- | | `tokenlab` | `tokenlab/gpt-4o` | OpenAI 互換ルート | | `tokenlab` | `tokenlab/deepseek-r1` | DeepSeek 推論モデル | | `tokenlab-responses` | `tokenlab-responses/gpt-4o` | Responses API ルート | | `tokenlab-claude` | `tokenlab-claude/claude-sonnet-4-6` | ネイティブ Claude Messages ルート | | `tokenlab-gemini` | `tokenlab-gemini/gemini-3.5-flash` | ネイティブ Gemini ルート | | `tokenlab-minimax` | `tokenlab-minimax/minimax-m3` | ネイティブ MiniMax ルート | 利用可能なモデルの一覧は [tokenlab.sh/models](https://tokenlab.sh/ja/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 インスタンスを再起動し、簡単なメッセージでテストしてください。レスポンスが返ってくれば、プロバイダは正しく構成されています。 ```bash theme={null} # セルフホスト: サービスを再起動 systemctl --user restart openclaw # Linux launchctl stop cc.tokenlab.openclaw && launchctl start cc.tokenlab.openclaw # macOS ``` ## 次のステップ OpenClaw が接続されたら、以下のガイドが TokenLab をより効果的に使うのに役立ちます: * [API 形式](/guides/api-formats) — OpenAI、Responses、Anthropic、Gemini ルートの違いを理解する * [IDE / SDK Compatibility](/guides/ide-sdk-compatibility) — `/v1/responses` が適している場合を確認する * [エラー処理](/guides/error-handling) — 一般的な失敗モードと回復パターンを学ぶ * [モデル概要](https://tokenlab.sh/ja/models) — エージェントに組み込む前にモデル ID を参照する