OpenClaw 切换模型

OpenClaw 切换模型1. 课程内容2. 临时切换会话模型2.1 打开TUI会话2.2 使用 /model 切换会话模型3. 切换默认模型3.1 通过 CLI 切换3.2 通过配置文件切换4. 增加模型选项列表4.1 通过配置文件增加模型4.2 模型引用格式规范5. 附录：CLI 命令速查表

1. 课程内容

本课程将系统性地介绍 OpenClaw 的模型选择工作机制以及三种模型切换操作方式。

2. 临时切换会话模型

2.1 打开TUI会话

• 终端输入

openclaw tui

2.2 使用 /model 切换会话模型

命令	说明
/model	查看可用模型列表,选择切换模型

• 在会话框输入 /model回车，例如这里选择切换为 bailian/qwen3.5-plus，使用键盘上下键选择模型，然后回车

3. 切换默认模型

3.1 通过 CLI 切换

最简单的方式是使用 CLI 命令直接设置默认模型：

• 这里以切换为 bailian/qwen3.6-plus 模型为例

xxxxxxxxxx openclaw models set bailian/qwen3.6-plus

3.2 通过配置文件切换

• 编辑 openclaw.json 配置文件来修改 Agent 的默认模型

xxxxxxxxxx nano $HOME /.openclaw/openclaw.json # 或使用您喜欢的编辑器，如 vim、code 等

在 openclaw.json 中，通过 agents.defaults.model.primary 配置项指定默认使用的主模型：

xxxxxxxxxx { "agents" : { "defaults" : { "model" : { "primary" : "bailian/qwen3.5-plus" } } } }

• 验证配置是否生效：

xxxxxxxxxx openclaw models status

4. 增加模型选项列表

• agents.defaults.models 是 OpenClaw 中控制可使用模型范围的允许列表/目录 。当此配置项被设置后，用户只能使用列表中包含的模型，该列表会同时作为 /model 命令和会话覆盖的模型范围控制依据。

4.1 通过配置文件增加模型

在 openclaw.json 中配置 agents.defaults.models，将需要使用的模型添加到允许列表中：

x "agents" : { "defaults" : { "model" : { "primary" : "bailian/qwen3.5-plus" }, "models" : { "bailian/qwen3.5-plus" : {}, "bailian/MiniMax-M2.5" : {}, "bailian/glm-4.7" : {} }, "workspace" : "/home/jetson/.openclaw/workspace" , "compaction" : { "mode" : "safeguard" , "memoryFlush" : { "enabled" : false } } } }

4.2 模型引用格式规范

在 OpenClaw 中，所有模型引用均采用统一的格式：

xxxxxxxxxx 提供商/模型ID

示例：

模型引用	说明
anthropic/claude-opus-4-6	Anthropic 的 Claude Opus 模型
anthropic/claude-sonnet-4-6	Anthropic 的 Claude Sonnet 模型
openai/gpt-5.4	OpenAI 的 GPT-5.4 模型
openrouter/moonshotai/kimi-k2	模型 ID 本身包含斜杠的情况

注意 ：如果模型 ID 本身包含 /（如 moonshotai/kimi-k2），必须完整提供 openrouter/moonshotai/kimi-k2 格式的引用。

---

5. 附录：CLI 命令速查表

命令	用途
openclaw onboard	新手引导，帮助快速完成初始配置
openclaw models list	查看所有已配置的模型列表
openclaw models status	查看当前模型配置状态详情
/model	在聊天中查看可用模型列表
/model status	在聊天中查看当前模型状态详情