OpenClawでOpenRouterを使って複数モデルに接続するチュートリアル

はじめに

OpenRouter は統合 AI モデルゲートウェイで、1つの API Key でほぼすべての主要な大規模モデル（Claude、GPT、Gemini、Llama、Mistral など）にアクセスできます。複数のプラットフォームに個別に登録したくないユーザーにとって、OpenRouter は非常に便利な選択肢です。本チュートリアルでは、OpenClaw で OpenRouter を設定する方法を詳しく解説します。

OpenRouter の利点

ステップ1：OpenRouter の登録と API Key の取得

1.1 アカウント登録

1. openrouter.ai にアクセス
2. Google アカウントまたはメールで登録
3. 登録完了後、ダッシュボードに移動

1.2 API Key の作成

1. Keys ページに移動
2. Create Key をクリック
3. 名前を入力（例：openclaw-prod）
4. 生成されたキーをコピー

API Key の形式：

sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

1.3 チャージ（任意）

OpenRouter は複数の支払い方法に対応しています。一部のオープンソースモデルには無料枠がありますが、Claude や GPT などの商用モデルにはプリチャージが必要です。まず $5 でお試しすることを推奨します。

ステップ2：基本設定

2.1 設定ファイルの編集

nano ~/.config/openclaw/openclaw.json5

OpenRouter の設定を追加します：

{
  models: {
    openrouter: {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "anthropic/claude-sonnet-4",
    }
  }
}

2.2 環境変数の設定

# ~/.bashrc に追加
export OPENROUTER_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
source ~/.bashrc

2.3 再起動と検証

openclaw restart
openclaw doctor

ステップ3：利用可能なモデル一覧

OpenRouter を通じて以下の主要モデルにアクセスできます：

3.1 無料モデル

OpenRouter は一部のモデルに無料枠を提供しており、試用や低頻度利用に適しています：

{
  models: {
    "openrouter-free": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "meta-llama/llama-3.3-70b:free",  // 無料版の識別子
    }
  }
}

注意：無料モデルのレート制限は厳しいため、高頻度の利用には適していません。

ステップ4：マルチモデル設定

OpenRouter の最大の強みは、複数のモデルを柔軟に切り替えられることです。

4.1 チャンネルごとに異なるモデルを設定

{
  models: {
    "router-premium": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "anthropic/claude-sonnet-4",
    },
    "router-standard": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "google/gemini-2.5-flash",
    },
    "router-budget": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "meta-llama/llama-3.3-70b",
    }
  },
  channels: {
    whatsapp: {
      model: "router-premium",     // WhatsApp では最強モデルを使用
    },
    telegram: {
      model: "router-standard",   // Telegram では中級モデルを使用
    },
    discord: {
      model: "router-budget",     // Discord ではエコノミーモデルを使用
    }
  }
}

4.2 モデルルーティング戦略

OpenRouter は自動ルーティング機能をサポートしており、リクエストの内容に応じて最適なモデルを自動的に選択します：

{
  models: {
    "router-auto": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "openrouter/auto",   // 最適なモデルを自動選択
      parameters: {
        temperature: 0.7,
      }
    }
  }
}

ステップ5：フェイルオーバー設定

特定のモデルプロバイダーに障害が発生した場合、OpenRouter は自動的に代替モデルに切り替えることができます。

5.1 フォールバックリストの設定

{
  models: {
    "router-resilient": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "anthropic/claude-sonnet-4",
      fallbackModels: [
        "openai/gpt-4o",
        "google/gemini-2.5-pro",
        "deepseek/deepseek-chat",
      ],
      retryOnFailure: true,
      maxRetries: 2,
    }
  }
}

5.2 動作の仕組み

フェイルオーバーのトリガーフロー：

リクエスト送信 → Claude Sonnet 4
    ↓ 失敗
リトライ → GPT-4o
    ↓ 失敗
リトライ → Gemini 2.5 Pro
    ↓ 失敗
最終リトライ → DeepSeek Chat
    ↓ 成功
レスポンスを返却

この設定により、特定のプロバイダーが完全にダウンしてもサービスに影響しない、非常に高い可用性を確保できます。

ステップ6：コスト最適化

6.1 予算制限の設定

OpenRouter ダッシュボードで総予算と1日あたりの上限を設定できます。同時に OpenClaw の設定でも制御層を追加できます：

{
  models: {
    openrouter: {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "google/gemini-2.5-flash",
      budget: {
        dailyLimit: 2.00,          // 1日あたり最大 $2
        monthlyLimit: 30.00,       // 1か月あたり最大 $30
        alertThreshold: 0.8,       // 80% に達した時点でアラートを発行
      }
    }
  }
}

6.2 タスクの複雑さに応じたモデル選択戦略

タスクの種類に応じてモデルを動的に選択する賢い方法です：

{
  models: {
    "router-smart": {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "google/gemini-2.5-flash",    // デフォルトは安価なモデル
      complexModel: "anthropic/claude-sonnet-4",   // 複雑なタスクは高性能モデル
      complexTriggers: [
        "代码",
        "分析",
        "翻译长文",
        "写文章",
      ]
    }
  }
}

ステップ7：高度な設定オプション

7.1 カスタム HTTP ヘッダー

一部のシーンでは追加の HTTP ヘッダー情報の送信が必要な場合があります：

{
  models: {
    openrouter: {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "anthropic/claude-sonnet-4",
      headers: {
        "HTTP-Referer": "https://your-site.com",  // OpenRouter のソース統計に役立つ
        "X-Title": "OpenClaw Assistant",           // OpenRouter のログに表示される
      }
    }
  }
}

7.2 特定プロバイダーの無効化

特定のプロバイダー経由でモデルにアクセスしたくない場合：

{
  models: {
    openrouter: {
      provider: "openrouter",
      apiKey: "${OPENROUTER_API_KEY}",
      defaultModel: "anthropic/claude-sonnet-4",
      providerPreferences: {
        exclude: ["azure"],        // Azure が提供するモデルを使用しない
        prefer: ["anthropic"],     // Anthropic への直接接続を優先
      }
    }
  }
}

よくある質問

残高不足

Error: 402 Payment Required - Insufficient credits

OpenRouter ダッシュボードでチャージすれば復旧します。

モデルが利用不可

Error: 503 Model temporarily unavailable

これは通常、上流プロバイダーの一時的な問題です。fallbackModels を設定しておけば自動的に切り替わります。設定していない場合は数分待ってからリトライしてください。

レスポンス速度が遅い

OpenRouter は中間層として若干のレイテンシ（通常100-300ms）が追加されます。レイテンシに非常に敏感な場合は、対応するモデルプロバイダーに直接接続することを推奨します。

まとめ

OpenRouter は、OpenClaw エコシステムにおける強力なモデル集約ソリューションです。その主な価値は、マルチモデル管理の簡素化、フェイルオーバー機能の提供、統一課金にあります。複数のモデルを柔軟に使いたいが、各社の API を個別に管理したくないユーザーにとって、OpenRouter は最適な選択肢です。バックアップ方案またはメインソリューションとして、フェイルオーバー設定と組み合わせて、高可用性の AI アシスタントサービスを実現することを推奨します。