OpenRouter
OpenRouter 提供统一 API，通过单一端点和 API 密钥访问多种模型。兼容 OpenAI SDK，适合需要灵活切换模型的场景。
配置
# CLI 设置
openclaw onboard --auth-choice apiKey \
--token-provider openrouter \
--token "$OPENROUTER_API_KEY"配置示例：
{
env: { OPENROUTER_API_KEY: "sk-or-..." },
agents: {
defaults: {
model: {
primary: "openrouter/anthropic/claude-sonnet-4-5"
}
}
}
}模型引用格式
OpenRouter 模型使用 openrouter/<provider>/<model> 三段式格式：
| 模型引用 | 说明 |
|---|---|
| openrouter/anthropic/claude-sonnet-4-5 | Claude Sonnet 4.5 |
| openrouter/openai/gpt-4o | GPT-4o |
| openrouter/google/gemini-2.5-pro | Gemini 2.5 Pro |
| openrouter/meta-llama/llama-3.3-70b | Llama 3.3 70B |
作为备用 Provider
OpenRouter 非常适合作为备用 Provider，当主模型限流时自动切换：
{
agents: {
defaults: {
model: {
primary: "anthropic/claude-sonnet-4-5",
fallbacks: [
"openrouter/anthropic/claude-sonnet-4-5",
"openrouter/openai/gpt-4o"
]
}
}
}
}主模型返回 429 或 5xx 时，自动切换到 OpenRouter 的备用路线。
注意事项
- OpenRouter 使用 Bearer 令牌认证
- 底层兼容 OpenAI API，大多数 OpenAI SDK 可直接使用
- 一个 API 密钥即可访问所有支持的模型
- 特别适合需要多供应商冗余的场景