如何切换AI模型提供商？

在OpenClaw中切换AI模型提供商，你可以通过命令行工具、交互式向导或手动编辑配置文件实现。以下是详细的操作方法。

查看当前模型配置

首先确认当前使用的模型：

1. # 列出所有已配置的模型
2. openclaw models list
4. # 查看当前默认模型
5. openclaw config get agents.defaults.model.primary

方法一：使用交互式配置向导（推荐新手）

这是最简便的切换方式，系统会引导你完成整个流程：

1. # 启动配置向导
2. openclaw onboard
4. # 或使用特定参数直接选择提供商
5. openclaw onboard --auth-choice <提供商>

向导会依次让你选择：运行模式 → AI供应商 → 认证方式 → 具体模型 → 聊天渠道配置。

方法二：使用模型管理命令

1. 切换默认模型

1. # 基本切换命令
2. openclaw models set <提供商>/<模型名>
4. # 示例：切换到通义千问
5. openclaw models set qwen-portal/qwen3-max-2026-01-23
7. # 示例：切换到智谱GLM
8. openclaw models set zai/glm-5
10. # 示例：切换到MiniMax
11. openclaw models set minimax-cn/MiniMax-M2.5-highspeed
13. # 示例：切换到OpenAI GPT-5.4
14. openclaw models set openai-codex/gpt-5.4

2. 配置认证信息

不同提供商需要不同的认证方式：

1. # 对于需要API Key的提供商（如Anthropic、MiniMax）
2. openclaw auth set <提供商>:default --key "你的API_KEY"
4. # 对于支持OAuth的提供商（如OpenAI Codex、Qwen）
5. openclaw models auth login --provider <提供商>
7. # 使用GitHub Copilot认证（如有订阅）
8. openclaw models auth login-github-copilot

方法三：手动编辑配置文件

配置文件位于 ~/.openclaw/openclaw.json，你可以直接编辑：

1. {
2. "auth": {
3. "profiles": {
4. "qwen-portal:default": {
5. "provider": "qwen-portal",
6. "mode": "oauth"
7. }
8. }
9. },
10. "agents": {
11. "defaults": {
12. "model": {
13. "primary": "qwen-portal/qwen3-max-2026-01-23"
14. }
15. }
16. }
17. }

编辑后需要重启网关使配置生效。

主流提供商配置示例

1. 通义千问（Qwen） - 推荐国内用户

1. # 启用Qwen插件
2. openclaw plugins enable qwen-portal-auth
3. openclaw gateway restart
5. # OAuth登录认证
6. openclaw models auth login --provider qwen-portal --set-default
8. # 设置具体模型
9. openclaw models set qwen-portal/qwen3-max-2026-01-23

2. 智谱AI（GLM）

1. # 设置API Key
2. openclaw auth set zai:default --key "你的GLM_API_KEY"
4. # 切换模型
5. openclaw models set zai/glm-5

3. MiniMax

1. # 设置API Key
2. openclaw auth set minimax-cn:default --key "你的MINIMAX_API_KEY"
4. # 切换模型
5. openclaw models set minimax-cn/MiniMax-M2.5-highspeed

4. OpenAI（国际用户）

1. # 使用Codex OAuth授权
2. openclaw models auth login --provider openai-codex
4. # 或使用API Key
5. openclaw onboard --auth-choice openai-api-key
7. # 切换模型
8. openclaw models set openai-codex/gpt-5.4

5. Anthropic Claude

1. # 设置API Key
2. openclaw auth set anthropic:default --key "你的ANTHROPIC_API_KEY"
4. # 切换模型
5. openclaw models set anthropic/claude-opus-4-6-20251101

高级功能：多模型与故障转移

1. 配置模型回退链

当主模型不可用时，自动切换到备用模型：

1. # 设置回退模型列表
2. openclaw config set agents.defaults.model.fallbacks '["minimax-cn/MiniMax-M2.5-highspeed", "qwen-portal/qwen3.5-flash-2026-02-23"]'

2. 多API Key容错

为同一提供商配置多个Key实现自动轮询：

1. # 添加主Key和备用Key
2. openclaw auth set minimax-cn:default --key "第一个API_Key"
3. openclaw auth set minimax-cn:backup --key "第二个API_Key"
5. # 设置使用顺序
6. openclaw config set auth.order.minimax-cn '["minimax-cn:default", "minimax-cn:backup"]'

3. 对话中动态切换

在聊天窗口中直接切换模型：

1. # 输入命令
2. /model
4. # 然后选择或输入目标模型，如：
5. /model anthropic/claude-opus-4-6-20251101
6. /model openai-codex/gpt-5.4

验证切换结果

1. # 查看当前默认模型
2. openclaw models list
4. # 测试模型响应
5. openclaw gateway test
7. # 查看日志确认模型加载
8. openclaw logs --tail 20
10. # 健康检查
11. openclaw health

注意事项

1. 模型引用格式：必须使用 提供商/模型名 格式，如 qwen-portal/qwen3-max-2026-01-23
2. 认证方式差异：
   • OpenAI Codex、Qwen：推荐OAuth登录
   • Anthropic、MiniMax、GLM：使用API Key
   • GitHub Copilot：使用订阅授权
3. 国内访问建议：优先选择Qwen、GLM、MiniMax等国内模型，访问更稳定
4. 配置生效：部分配置需要重启网关 openclaw gateway restart
5. 模型模式：添加自定义提供商后，可能需要设置 openclaw config set models.mode merge

故障排查

如果切换后模型不工作：

1. 检查认证信息是否正确：openclaw auth list
2. 查看详细错误日志：openclaw logs --verbose
3. 验证网络连接：确保能访问对应API端点
4. 检查额度状态：部分免费模型有调用次数限制
5. 确认模型名称：使用 openclaw models list 查看可用模型

通过以上方法，你可以灵活地在不同AI模型提供商之间切换，根据任务需求选择最合适的模型。

© 本文著作权归作者所有。转载请联系授权，禁止商用。

🔗 系列文章

1. openclaw能做什么？