LiteLLM

LiteLLM 是一个开源 LLM 网关，提供统一 API 来接入大量模型提供商。你可以让 OpenClaw 通过 LiteLLM 转发请求，从而获得集中化的成本统计、日志，以及无需修改 OpenClaw 配置即可切换后端的灵活性。

为什么把 OpenClaw 接到 LiteLLM？

成本统计：集中查看 OpenClaw 在各模型上的花费
模型路由：在 Claude、GPT、Gemini、Bedrock 等后端间切换而不改 OpenClaw 配置
虚拟 Key：为 OpenClaw 生成带预算上限的 Key
日志：记录请求/响应，便于排障
回退：主 provider 不可用时自动故障转移

快速开始

通过向导

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

手动配置

启动 LiteLLM Proxy：

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

让 OpenClaw 指向 LiteLLM：

export LITELLM_API_KEY="your-litellm-key"

openclaw

完成。OpenClaw 现在会通过 LiteLLM 路由请求。

配置

环境变量

export LITELLM_API_KEY="sk-litellm-key"

配置文件

{
  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" },
    },
  },
}

Virtual keys

为 OpenClaw 创建一个带预算限制的专用 Key：

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"
  }'

把生成的 Key 设置为 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 处理。

查看用量

查看 LiteLLM 的 dashboard 或 API：

# Key info
curl "http://localhost:4000/key/info" \
  -H "Authorization: Bearer sk-litellm-key"

# Spend logs
curl "http://localhost:4000/spend/logs" \
  -H "Authorization: Bearer $LITELLM_MASTER_KEY"

备注

LiteLLM 默认监听 http://localhost:4000
OpenClaw 通过 OpenAI 兼容的 /v1/chat/completions 端点访问
OpenClaw 的功能可通过 LiteLLM 正常工作