LiteLLM

LiteLLM は、100 以上のモデルプロバイダーに統一 API で接続できるオープンソースの LLM Gateway です。OpenClaw の設定を変更せずに、OpenClaw を LiteLLM 経由でルーティングして、コストの一元追跡、ログ記録、使用上限付き仮想キー、バックエンドのフェイルオーバーを利用できます。

クイックスタート

オンボーディング（推奨）
手動セットアップ

openclaw onboard --auth-choice litellm-api-key

リモートプロキシに対して非対話形式でセットアップする場合は、プロキシ URL を明示的に渡します。

openclaw onboard --non-interactive --accept-risk --auth-choice litellm-api-key \
  --litellm-api-key "$LITELLM_API_KEY" --custom-base-url "https://litellm.example/v1"

LiteLLM Proxy を起動

pip install 'litellm[proxy]'
litellm --model claude-opus-4-6

OpenClaw の接続先を LiteLLM に設定

export LITELLM_API_KEY="your-litellm-key"
openclaw

設定

{
  models: {
    providers: {
      litellm: {
        baseUrl: "http://localhost:4000",
        apiKey: "${LITELLM_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "claude-opus-4-6",
            name: "Claude Opus 4.6",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 200000,
            maxTokens: 64000,
          },
          {
            id: "gpt-4o",
            name: "GPT-4o",
            reasoning: false,
            input: ["text", "image"],
            contextWindow: 128000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
  agents: {
    defaults: {
      model: { primary: "litellm/claude-opus-4-6" },
    },
  },
}

オンボーディングによって書き込まれるデフォルトモデルは litellm/claude-opus-4-6 です。

画像生成

LiteLLM は、OpenAI 互換の /images/generations および /images/edits ルートを介して image_generate ツールのバックエンドとして機能できます。デフォルトの画像モデルは gpt-image-2 です。別のモデルを使用するには、 agents.defaults.mediaModels.image で設定します。

{
  models: {
    providers: {
      litellm: {
        baseUrl: "http://localhost:4000",
        apiKey: "${LITELLM_API_KEY}",
      },
    },
  },
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "litellm/gpt-image-2",
        timeoutMs: 180_000,
      },
    },
  },
}

ループバック LiteLLM URL（http://localhost:4000、127.0.0.1、::1、host.docker.internal）は、プライベートネットワークのグローバルなオーバーライドなしで動作します。LAN でホストされているプロキシの場合は、API キーがそのホストに送信されるため、 models.providers.litellm.request.allowPrivateNetwork: true を設定します。

高度な設定

仮想キー

使用上限を設定した OpenClaw 専用キーを作成します。

curl -X POST "http://localhost:4000/key/generate" \
  -H "Authorization: Bearer $LITELLM_MASTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key_alias": "openclaw",
    "max_budget": 50.00,
    "budget_duration": "monthly"
  }'

生成されたキーを LITELLM_API_KEY として使用します。

モデルのルーティング

LiteLLM は、モデルリクエストを異なるバックエンドにルーティングできます。LiteLLM の config.yaml で設定します。

model_list:
  - model_name: claude-opus-4-6
    litellm_params:
      model: claude-opus-4-6
      api_key: os.environ/ANTHROPIC_API_KEY

  - model_name: gpt-4o
    litellm_params:
      model: gpt-4o
      api_key: os.environ/OPENAI_API_KEY

OpenClaw は引き続き claude-opus-4-6 をリクエストし、LiteLLM がルーティングを処理します。

使用状況の確認

# キー情報
curl "http://localhost:4000/key/info" \
  -H "Authorization: Bearer sk-litellm-key"

# 使用額ログ
curl "http://localhost:4000/spend/logs" \
  -H "Authorization: Bearer $LITELLM_MASTER_KEY"

プロキシ動作に関する注意事項

LiteLLM はデフォルトで http://localhost:4000 で動作します。
OpenClaw は、LiteLLM のプロキシ形式の OpenAI 互換 /v1 エンドポイントを介して接続します。
ネイティブ OpenAI 専用のリクエスト整形は、設定済みの LiteLLM ベース URL では適用されません。 service_tier、Responses store、プロンプトキャッシュのヒント、OpenAI の reasoning-effort ペイロード整形はいずれも使用されません。
非表示の OpenClaw 帰属ヘッダー（originator、version、User-Agent）は、検証済みのネイティブ OpenAI エンドポイントにのみ送信されるため、カスタム LiteLLM ベース URL には挿入されません。

一般的なプロバイダー設定とフェイルオーバーの動作については、モデルプロバイダーを参照してください。

LiteLLM ドキュメント

LiteLLM の公式ドキュメントおよび API リファレンスです。

モデルの選択

すべてのプロバイダー、モデル参照、フェイルオーバー動作の概要です。

設定

完全な設定リファレンスです。

モデル

モデルの選択方法と設定方法です。

Overview

Concepts and configuration

Providers

クイックスタート

設定

画像生成

高度な設定

関連情報

LiteLLM ドキュメント

モデルの選択

設定

モデル

​クイックスタート

​設定

​画像生成

​高度な設定

​関連情報

LiteLLM ドキュメント

モデルの選択

設定

モデル

クイックスタート

設定

画像生成

高度な設定

関連情報