OpenClawにOmniaKeyを設定する方法：API Providerとallowlist

「OpenClaw API 設定方法」や「OpenClaw OmniaKey 設定方法」を探している場合、最初に理解すべきなのは、Providerの定義とモデルのallowlistは別の設定だということです。OpenClawはAgent loop、ツール利用、コード編集を提供し、実際の応答は接続したモデルProviderが担当します。

OmniaKeyをProviderとして追加する

設定ファイルは ~/.openclaw/openclaw.json です。models.providers の下に次のようなProviderを追加します。

{
  "models": {
    "mode": "merge",
    "providers": {
      "omniakey": {
        "baseUrl": "https://api.omniakey.com/v1",
        "apiKey": "your-omniakey-api-key",
        "api": "openai-completions",
        "models": [
          { "id": "claude-opus-4-8" },
          { "id": "gpt-5.5" },
          { "id": "gemini-3.1-pro-preview" },
          { "id": "grok-4.5" }
        ]
      }
    }
  }
}

mode: mergeは既存の設定を残したままProviderを追加する指定です。APIキーは実際の値に置き換え、Gitや公開チャットには保存しないでください。モデルIDは現在のカタログからコピーします。

忘れやすい手順：モデルをallowlistに追加する

Providerを定義しただけでは十分ではありません。OpenClawは使用可能なモデルをallowlistでも確認します。同じ openclaw.json の models と同じ階層に agents を追加します。

{
  "agents": {
    "defaults": {
      "models": [
        "omniakey/claude-opus-4-8",
        "omniakey/gpt-5.5",
        "omniakey/gemini-3.1-pro-preview",
        "omniakey/grok-4.5"
      ],
      "model": "omniakey/claude-opus-4-8"
    }
  }
}

リクエスト本体で使うのはモデルIDですが、provider/model-id はOpenClaw内部の参照名です。Provider定義とallowlistの両方が必要です。片方だけ設定すると、キーが正しくても model not allowed になることがあります。

確認する

openclaw doctor
openclaw models list

doctorは設定ファイル、Provider、キー形式、ライブ接続、モデルアクセスを確認します。問題がなければ agents.defaults のアクティブモデルを omniakey/gpt-5.5 などに設定できます。

OmniaKeyを使う理由

一つのキーと残高でClaude、GPT、Gemini、Grokを切り替えられ、料金はトークン単位です。allowlistに指定したモデルIDが実際に実行され、上流障害時に別モデルへ黙って置き換えられることはありません。

詳細なツール別設定はコーディングAgentガイドを参照してください。