OpenClaw LiteLLM 提供商配置指南

LiteLLM 是一个开源的 LLM 网关，为 100 多个模型提供商提供了统一的 API。你可以将 OpenClaw 的请求路由到 LiteLLM 网关，从而获得集中式的成本追踪、日志记录，以及无需修改 OpenClaw 配置即可切换后端模型的灵活性。

为什么要在 OpenClaw 中使用 LiteLLM？

• 成本追踪：精确查看 OpenClaw 在所有模型上的开销
• 模型路由：无需修改配置，即可在 Claude、GPT-4、Gemini、Bedrock 之间切换
• 虚拟密钥：为 OpenClaw 创建带有消费限额的专用密钥
• 日志记录：完整的请求 / 响应日志，方便调试
• 故障转移：当主提供商不可用时，自动进行故障转移

快速开始

通过入职流程配置

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

手动配置

1. 启动 LiteLLM 代理：

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

1. 将 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" },

虚拟密钥

你可以为 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 处理。

查看用量

你可以通过 LiteLLM 的仪表盘或 API 查看用量：

## 密钥信息
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 通过兼容 OpenAI 的 /v1/chat/completions 端点进行连接
• 所有 OpenClaw 功能都可以通过 LiteLLM 正常工作，没有功能限制