文档
模型 API 双线路配置(国际 / 中国)
按网络可达性选择模型入口,避免 401 与高延迟
继续查看
安装、排障和深入阅读最常用的入口都在这里。
核心原则
- 先稳定可达,再优化成本
- 测试环境和生产环境分离
- 把“可用模型”和“备用模型”都写进文档
常见平台入口
| 平台 | 入口地址 | 说明 |
|---|---|---|
| Qwen | modelstudio.console.alibabacloud.com / bailian.console.aliyun.com | 国内可达性好 |
| OpenAI | platform.openai.com/api-keys | 关注配额与模型可用性 |
| Claude | console.anthropic.com | 注意组织权限 |
| OpenRouter | openrouter.ai/settings/keys | 多模型聚合,便于试错 |
| DeepSeek | platform.deepseek.com/api_keys | 成本较低 |
| Gemini | aistudio.google.com/apikey | 注意地区可用性 |
推荐配置模板
OPENCLAW_PROVIDER=openrouter
OPENCLAW_API_KEY=sk-xxxx
OPENCLAW_MODEL=anthropic/claude-3.5-sonnet
OPENCLAW_FALLBACK_MODEL=deepseek-chat
OPENCLAW_TIMEOUT_MS=60000
切换策略建议
- 白天高并发:优先低成本模型
- 晚上分析任务:优先高质量模型
- 失败自动降级:主模型失败后自动走备用模型
故障快速定位
401
- Key 错误或过期
- 账号无该模型权限
429
- 配额或速率限制
5xx / timeout
- 网络波动或平台短时故障
- 增加重试和超时策略