openclaw快速切换模型命令
OpenClaw 修改默认大模型 3 种完整方法（适配你Ollama本地千问/DeepSeek-R1）
前置规则
模型完整格式： ollama/模型ID
示例： ollama/qwen3.5:4b-reasoning 、 ollama/deepseek-r1:latest
方法1：命令行一键设置默认（最简单，推荐）
不用手动改JSON，直接终端执行，自动写入配置
- 先查看所有已配置模型
bash
openclaw models list
- 设置默认模型（永久生效，全局智能体）
bash
切换千问3.5 4B reasoning
openclaw models set ollama/qwen3.5:4b-reasoning
切换DeepSeek-R1 8B
openclaw models set ollama/deepseek-r1:latest
- 重启网关加载新配置
bash
openclaw gateway restart
- 验证是否生效
bash
openclaw models status
输出里 Default 字段就是当前默认模型。
方法2：手动修改配置文件（精细自定义，适合调显存/上下文）
配置文件路径： ~/.openclaw/openclaw.json
步骤1：编辑文件
bash
nano ~/.openclaw/openclaw.json
步骤2：找到 agents.defaults.model.primary 修改
json
"agents": {
"defaults": {
"llm": {
"idleTimeoutSeconds": 1800,
"timeoutSeconds": 300,
"compactContext": true
},
"model": {
// 修改这里，填 ollama/你的模型名
"primary": "ollama/qwen3.5:4b-reasoning",
// 备选兜底模型，主模型断了自动切换
"fallbacks": ["ollama/deepseek-r1:latest"]
}}
}
步骤3：确保Ollama模型已注册（关键，否则报错找不到模型）
往下找到 models.providers.ollama.models ，确认里面有你要用的模型ID：
json
"ollama": {
"timeoutSeconds": 300,
"baseUrl": "http://127.0.0.1:11434",
"models": [
{
"id": "qwen3.5:4b-reasoning",
"name": "Qwen3.5 4B Reasoning",
"contextWindow": 8192,
"maxTokens": 2048
},
{
"id": "deepseek-r1:latest",
"name": "DeepSeek-R1 8B",
"contextWindow": 8192,
"maxTokens": 2048
}]
}
步骤4：校验配置语法，防止写错启动失败
bash
openclaw config validate
无报错再重启网关：
bash
openclaw gateway restart
方法3：单会话临时切换（仅当前对话生效，不修改全局默认）
在飞书/OpenClaw对话窗口内输入指令，临时换模型，重启会话会恢复全局默认：
plaintext
/model ollama/deepseek-r1:latest
查看当前会话模型：
plaintext
/model status
查看全部可用模型：
plaintext
/models
关键避坑点（你本地Ollama高频踩坑）
1. 模型ID必须和Ollama一致
ollama pull 拉取的名字是什么，配置里id就写什么，大小写、冒号不能错。
2. 修改默认后必须重启gateway，否则新任务不生效。
3. 若提示模型不存在：
- 先执行 ollama list 确认模型已拉取；
- 在openclaw.json的ollama models数组里补充对应模型配置。
4. 兜底fallbacks作用：主模型显存溢出/断开时，自动切换备用模型，减少任务中断。
快速切换示例（直接复制执行）
设千问3.5 4B reasoning为全局默认
bash
openclaw models set ollama/qwen3.5:4b-reasoning
openclaw gateway restart
openclaw models status
临时切换DeepSeek-R1做单次分析（对话内输入）
plaintext
/model ollama/deepseek-r1:latest