コーディングツール
TokenLab プロバイダーのセットアップ
セルフホスト型の OpenClaw インスタンスを TokenLab に接続する
エージェントにセットアップを任せる
以下のタスクを、すでにコンピュータ上で実行中のエージェントにコピーしてください:
Read this guide and help me connect OpenClaw to TokenLab:
https://tokenlab.sh/docs/ja/guides/tokenlab-provider
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.このガイドはセルフホスト型の OpenClaw を対象としています。TokenLab プラグインを使用するのが最も簡単なセットアップ方法ですが、特定の API 形式が必要な場合は手動設定も可能です。
プラグインのインストール
オプション:公開されているプロバイダープラグイン 0.1.3 をインストールします。以下で説明する Gateway 環境を通じて TOKENLAB_API_KEY を提供し、セッション限定のモデル選択を使用してください。プラグインのオンボーディングウィザードによってデフォルトモデルが変更されるため、このガイドでは openclaw onboard を実行しません。既存のプラグインエントリと権限は保持してください。リクエストを行う前に、インストール済みのプラグインとモデルリストを確認してください。
インストーラーが要求する機能をレビューし、クライアントの確認プロンプトに従ってください。関連のない権限を付与したり、既存のプラグインの権限を変更したりしないでください。
openclaw plugins install @tokenlabai/openclaw-provider@0.1.3
openclaw plugins list
openclaw models list --provider tokenlab/model tokenlab/claude-sonnet-5 -s
/model default -sプロバイダーの手動設定
OpenClaw で Responses、Claude Messages、Gemini、または MiniMax の各形式を個別に扱う必要がある場合にのみ models.providers を使用してください。通常のチャットであれば、tokenlab エントリだけで十分です。
| プロバイダー | 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 | Messages 形式経由の MiniMax モデル | https://api.tokenlab.sh |
/v1 サフィックスは openai-completions および openai-responses に対してのみ使用してください。
anthropic-messages や google-generative-ai などのネイティブプロバイダーは、/v1 を付けずに https://api.tokenlab.sh を使用する必要があります。そうしないと、OpenClaw が誤ったプロバイダーパスを構築する可能性があります。
前提条件
- セルフホスト型の OpenClaw インスタンス
- OpenClaw 2026.9.4 の場合、Node.js
>=24.16.0 <25 || >=26.1.0を使用してください(バージョン要件)。その他の OpenClaw リリースについては、各リリースの要件を確認してください。 - TokenLab API Key — こちらから取得
設定
OpenClaw の設定を編集します:
- セルフホスト:
~/.openclaw/openclaw.json
models.providers の下に TokenLab プロバイダーを追加します:
実行中の Gateway と同じプロファイル、OPENCLAW_STATE_DIR、および OPENCLAW_CONFIG_PATH を使用してください。マージする前にアクティブな設定をバックアップしてください。TOKENLAB_API_KEY は、そのインスタンスの信頼されたグローバル .env またはサービス環境に配置してください。ターミナルのエクスポートやプロジェクトの .env だけでは、バックグラウンドの Gateway に届かない場合があります。環境変数の取り扱いを参照してください。
アクティブな設定をバックアップします。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-v4-pro", name: "DeepSeek V4 Pro" },
{ 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.6-flash", name: "Gemini 3.6 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" }
]
}
}
}
}5つのプロバイダーすべてで同じ API Key を使用します。TokenLab アカウントは1つあれば十分です。
上記の models 配列は一般的な例のみを示しています。必要に応じて各プロバイダーにモデル ID を追加してください。
モデルの使用
OpenClaw は引き続き provider/model 形式でモデルを参照します:
OpenClaw 2026.9.4 の場合、-s を使用して現在のセッションのみモデルを選択します。agents.defaults.model、エージェントのデフォルト設定、および権限は変更しないでください。/model default -s を使用すると、このセッションを構成済みのデフォルトに戻すことができます。
/model tokenlab-claude/claude-sonnet-5 -s
/model default -sモデルの例
| プロバイダー | モデル参照 | 説明 |
|---|---|---|
tokenlab | tokenlab/gpt-5.6-terra | OpenAI 互換 (Chat Completions) |
tokenlab-responses | tokenlab-responses/gpt-5.6-terra | Responses API |
tokenlab-claude | tokenlab-claude/claude-sonnet-5 | Claude Messages |
tokenlab-gemini | tokenlab-gemini/gemini-3.6-flash | Gemini |
tokenlab-minimax | tokenlab-minimax/minimax-m3 | Messages 経由の MiniMax |
利用可能なすべてのモデルは tokenlab.sh/models で確認できます。
各プロバイダーの使い分け
tokenlab: ほとんどの汎用エージェントおよびチャットのユースケースにおけるデフォルトの選択肢。tokenlab-responses: OpenClaw のワークフローが明示的に OpenAI Responses セマンティクスに依存している場合に使用。tokenlab-claude: Claude のネイティブな Messages 動作が必要な場合に使用。tokenlab-gemini: Gemini ネイティブのリクエスト/レスポンス形式や、既存の Gemini スタイルの統合が必要な場合に使用。tokenlab-minimax: Messages 形式経由で MiniMax モデルを使用したい場合に使用。
Gemini ネイティブの動作が不要な場合は、OpenAI 互換形式の tokenlab/gemini-* を通じて Gemini モデルを呼び出すことも可能です。
よくある間違い
セットアップの確認
インスタンスを再起動し、選択されたモデルとプロバイダーを確認します。--probe なしの models status ではモデル呼び出しテストは行われません。ライブの --probe またはチャットメッセージはトークンを消費する可能性があります。セットアップが正常に機能していると判断する前に、実際の返信を対応する TokenLab リクエストと照らし合わせて確認してください。復元するには、以前のモデルを選択し、追加した TokenLab エントリのみを削除してください。
openclaw gateway restart
openclaw models status同じエージェントで画像と動画を生成する
OpenClaw は TokenLab MCP server を使用して画像や短い動画を作成することもできます。各生成は同じ TokenLab 残高から支払われます。
openclaw mcp add tokenlab \
--command npx \
--arg -y \
--arg @tokenlabai/mcp-server@0.6.48 \
--env TOKENLAB_MCP_TOOL_PROFILE=core \
--env 'TOKENLAB_API_KEY=${TOKENLAB_API_KEY}'
openclaw mcp probe tokenlabシングルクォートはそのままにしてください。OpenClaw はキーそのものではなく変数への参照を保存し、サーバー起動時に実行環境から TOKENLAB_API_KEY を読み取ります。probe コマンドで TokenLab ツールがリストアップされます。その後、以下を試してください:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video はタスク ID を返します。エージェントは動画の準備ができるまで get_task_status を呼び出します。
次のステップ
OpenClaw が接続されたら、以下のガイドが TokenLab をより効果的に活用するのに役立ちます:
- API Formats — OpenAI、Responses、Anthropic、Gemini ルートの違いを理解する
- IDE / SDK Compatibility —
/v1/responsesが適しているケースを確認する - Error Handling — 一般的な障害モードと復旧パターンを学ぶ
- Models Overview — エージェントに組み込む前にモデル ID をブラウズする