OpenClaw 修改默认大模型 3 种完整方法（适配你Ollama本地千问/DeepSeek-R1）

前置规则

模型完整格式： ollama/模型ID 
示例： ollama/qwen3.5:4b-reasoning 、 ollama/deepseek-r1:latest 

方法1：命令行一键设置默认（最简单，推荐）

不用手动改JSON，直接终端执行，自动写入配置

1. 先查看所有已配置模型

bash

openclaw models list
 

2. 设置默认模型（永久生效，全局智能体）

bash

切换千问3.5 4B reasoning

openclaw models set ollama/qwen3.5:4b-reasoning

切换DeepSeek-R1 8B

openclaw models set ollama/deepseek-r1:latest
 

3. 重启网关加载新配置

bash

openclaw gateway restart
 

4. 验证是否生效

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