ai2saveai2save

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
  1. https://ai2save.com/keys を開きます。
  2. OpenAI / GPT モデルグループに属する API Key を作成します。
  3. 完全な 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. リクエストの検証

  1. OpenClaw のチャット画面または WebChat を開きます。
  2. 新しい会話を作成し、「こんにちは、現在のモデル名を報告してください」と送信します。
  3. モデルルートが ai2save/gpt-5.5 になっていることを確認します。
  4. 初回はテキストタスクのみで検証し、成功したらファイル、ブラウザー、長い文脈などの複雑なツールを開きます。

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 を再起動してください。