OpenClaw 設定チュートリアル
OpenClaw は models.providers を通じてカスタムモデルプロバイダーを追加します。ai2save は OpenAI Compatible インターフェースを使用し、Base URL には https://ai2save.com/v1 を入力する必要があります。
1. OpenClaw と API Key の準備
OpenClaw が既にインストールされている場合は、インストールをスキップできます:
npm install -g openclaw@latest
openclaw --version
- https://ai2save.com/keys を開きます。
- OpenAI / GPT モデルグループに属する API Key を作成します。
- 完全な
sk-...キーをコピーします。
2. OpenClaw 設定ファイルの編集
OpenClaw のデフォルト設定ファイルは次の通りです:
~/.openclaw/openclaw.json
Windows は通常 %USERPROFILE%\.openclaw\openclaw.json にあります。ファイルは JSON5 に対応しており、以下の構造に従って既存の設定に統合できます:
{
env: {
vars: {
AI2SAVE_API_KEY: "sk-あなたのAPIキー",
},
},
agents: {
defaults: {
model: {
primary: "ai2save/gpt-5.5",
},
},
},
models: {
mode: "merge",
providers: {
ai2save: {
baseUrl: "https://ai2save.com/v1",
apiKey: "${AI2SAVE_API_KEY}",
api: "openai-completions",
timeoutSeconds: 300,
models: [
{
id: "gpt-5.5",
name: "GPT 5.5",
reasoning: true,
input: ["text"],
contextWindow: 200000,
},
],
},
},
},
}
重要なフィールドの説明:
models.providers.ai2save.baseUrl:/v1を必ず含める必要があります。api: "openai-completions":OpenClaw が OpenAI Compatible に代理で使用するインターフェースの種類。models[].id:ai2save コンソールで公開されているモデルIDと完全に一致させる必要があります。agents.defaults.model.primary:形式はプロバイダーID/モデルIDです。apiKeyは直接"sk-..."を書くことができます;${AI2SAVE_API_KEY}で参照する場合、必ずenv.varsで定義する必要があります。
複数のモデルを追加したい場合は、models 配列に引き続き追加し、primary を使用したいデフォルトの ai2save/model-id に変更してください。
3. 設定を適用して確認する
OpenClaw Gateway は設定ファイルの変更を監視し、自動的に適用します。設定がすぐに反映されない場合は、以下を実行してください:
openclaw gateway restart
そして、モデルがすでに OpenClaw に表示されているかどうかを確認します:
openclaw models list --provider ai2save
デフォルトのモデルを ai2save に切り替える:
openclaw models set ai2save/gpt-5.5
もしモデルが表示されない場合は、診断を実行して設定のエラーを確認してください:
openclaw doctor
4. リクエストの検証
- OpenClaw のチャット画面または WebChat を開きます。
- 新しい会話を作成し、「こんにちは、現在のモデル名を報告してください」と送信します。
- モデルルートが
ai2save/gpt-5.5になっていることを確認します。 - 初回はテキストタスクのみで検証し、成功したらファイル、ブラウザー、長い文脈などの複雑なツールを開きます。
OpenClaw は非公式の OpenAI エージェントに対して自動的に互換性処理を行うため、手動で developer role を有効にする必要はありません。ツール呼び出しに異常が発生した場合は、まずモデル ID がツール呼び出しをサポートしているか確認し、タイムアウト時間を延長してください。
5. よくあるエラー
- 401 / invalid_api_key:
AI2SAVE_API_KEYが定義されていない、キーが完全にコピーされていない、またはキーのグループが一致しない場合。 - 404 / model not found:
models[].id、primaryまたは実際のリクエストモデル名が一致していない場合。 - 接続失敗 / empty response:
baseUrlがhttps://ai2save.com/v1であるか確認し、ルートアドレスと書かないでください。 - モデルリストが空:
models.mode: "merge"を確認し、models.providers.ai2save.models[]に少なくとも1つのモデルが含まれていることを確認してください。 - 設定を保存しても反映されない:
openclaw doctorを再実行し、必要に応じて OpenClaw Gateway を再起動してください。