要在OpenClaw中切换Ollama本地模型，需先确保Ollama服务运行且目标模型已下载；再通过openclaw models set设置默认模型，或编辑openclaw.json配置多模型并指定primary，也可用--model参数会话级临时指定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在OpenClaw中切换已接入的Ollama本地模型，必须确保Ollama服务正在运行且目标模型已下载完成，否则OpenClaw会因无法连接或找不到模型而报错退出。
确认Ollama服务与模型就绪
打开终端，执行ollama list，检查输出中是否包含你打算切换的目标模型（如qwen3:7b、llama3.2:latest）。若列表为空或缺失目标模型，需先执行ollama pull qwen3:7b拉取模型。
运行ollama serve确保服务监听在http://localhost:11434——这是OpenClaw默认连接地址。如果端口被占用或服务未启动，后续所有切换操作都会失败。
【Ollama服务必须处于活跃状态，不能仅靠后台进程自动维持；手动执行一次ollama serve可强制激活并验证连通性】
通过命令行快速切换默认模型
这一步直接修改OpenClaw的全局默认模型，所有未显式指定模型的Agent调用都将走新模型。
第一步：查询当前可用模型清单
执行openclaw models list，确认Ollama注册的模型ID（如qwen3:7b、llama3.2）已出现在列表中。
第二步：设为默认模型
执行openclaw models set qwen3:7b，将Qwen3设为默认；若要切回Llama3，运行openclaw models set llama3.2。
第三步：验证生效
运行openclaw models status，输出中default model字段应显示刚设置的模型ID。该命令不重启网关，但会持久化写入~/.openclaw/openclaw.json。
通过配置文件启用多模型并设为主力
适用于需要长期共存多个Ollama模型，并让其中某一个作为主模型、其余作备用或任务专用的场景。
方法一：编辑~/.openclaw/openclaw.json
在models.providers节点下新增Ollama provider块，示例：
"ollama-local": {<br> "baseUrl": "http://localhost:11434/v1",<br> "apiKey": "null",<br> "api": "openai-completions",<br> "models": [<br> {"id": "qwen3:7b", "name": "Qwen3-7B本地"},<br> {"id": "llama3.2", "name": "Llama3.2本地"}<br> ]<br>}
方法二：指定主模型
在agent.model.primary字段中填入完整模型ID："primary": "ollama-local/qwen3:7b"。注意格式必须是provider-id/model-id，漏掉ollama-local/前缀会导致加载失败。
保存后执行openclaw gateway restart使配置生效。重启后OpenClaw会重新扫描并加载所有provider下的模型。
会话级强制指定模型（绕过默认设置）
当你只想在某次Agent调用中临时使用特定Ollama模型，又不想影响全局配置或触发网关重启，就用这个方法。
执行openclaw agent run --model ollama-local/llama3.2，参数--model的值必须严格匹配配置文件中定义的provider-id/model-id组合。
如果命令中模型ID拼写错误（比如写成ollama/llama3.2而非ollama-local/llama3.2），OpenClaw会静默回退到默认模型，不会报错提示——这是容易踩坑的地方。
该方式优先级最高，覆盖models.json和openclaw.json中的所有默认设定，适合A/B测试或紧急任务隔离。
