qclaw切换本地大模型需排查配置、服务状态与模型名称一致性：一、修改openclaw.json指向ollama（11434端口）；二、lm studio启用local server（1234端口）并配置provider；三、用openclawconfig命令配置siliconflow；四、设模型别名实现快速切换；五、用http/curl验证服务连通性与推理能力。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装 QClaw 并希望将其默认模型切换为本地运行的大模型，以规避云端调用的积分消耗与数据外传风险，则可能是由于配置文件未正确指向本地服务地址、Ollama 或 LM Studio 未处于活跃监听状态、或模型 ID 与实际加载名称不一致所致。以下是解决此问题的步骤：
一、通过修改 openclaw.json 配置 Ollama 本地模型
该方法直接编辑 QClaw 的核心配置文件，使其将请求路由至本机运行的 Ollama 服务（默认端口 11434），适用于稳定使用单一本地模型的场景。需确保 Ollama 已启动且目标模型已成功拉取。
1、关闭 QClaw 客户端，防止配置被覆盖。
2、打开文件资源管理器，进入路径：C:Users\.qclawopenclaw.json。
3、用 VS Code 或记事本打开该文件，将整个内容替换为以下 JSON（请将 192.168.112.186 替换为您本机实际 IPv4 地址，可通过 ipconfig 命令查询）：
4、保存文件后，重新启动 QClaw 客户端。
5、在对话框中输入 /model ollama-local/qwen3.5:35b-a3b，确认模型切换成功并响应正常。
二、通过 LM Studio 启用本地大模型接入
该方法利用 LM Studio 作为本地模型运行时网关，支持更灵活的模型加载与 GPU 显存调度，尤其适合显存充足（如 RTX 3060 12G 及以上）且需运行 Qwen3.6-35B 等大参数模型的用户。LM Studio 需以 OpenAI 兼容 API 模式对外提供服务。
1、启动 LM Studio，点击左下角 Local Server 标签页。
2、开启 Enable Local Server 开关，并记录显示的 http://localhost:1234/v1 地址。
3、在 openclaw.json 中新增一个 provider，baseUrl 设为上述地址，apiKey 设为任意非空字符串（如 lmstudio）。
4、在该 provider 的 models 数组中添加条目：{"id":"qwen3.6-35b-a3b","name":"qwen3.6-35b-a3b"}。
5、将 agents.defaults.model.primary 设置为 lmstudio/qwen3.6-35b-a3b，保存后重启 QClaw。
三、使用命令行工具动态配置 SiliconFlow 提供方
该方法绕过手动编辑 JSON，通过 openclawconfig 命令实时写入 SiliconFlow 提供方配置，适用于需快速验证 DeepSeek-V4-Pro、GLM-5.1 等商用模型 API 接入效果的调试场景。配置生效后可立即用于 /model 指令切换。
1、访问 https://www.siliconflow.cn/ 获取有效 API 密钥。
2、在终端中执行：openclawconfig set models.providers.siliconflow '{ "baseUrl": "https://api.siliconflow.cn/v1", "apiKey": "YOUR_API_KEY", "api": "openai-completions", "models": [ { "id": "Pro/deepseek-ai/DeepSeek-V4-Pro", "name": "DeepSeek-V4-Pro" } ] }'。
3、执行 openclaw config set agents.defaults.model.primary "siliconflow/Pro/deepseek-ai/DeepSeek-V4-Pro" 设为主模型。
4、重启 QClaw 网关进程（可通过任务管理器结束 openclaw.exe 后重新启动）。
5、发送 /info 指令，检查返回信息中 model 字段是否显示为 siliconflow/Pro/deepseek-ai/DeepSeek-V4-Pro。
四、启用运行时模型别名实现快速切换
该方法在不修改全局配置的前提下，为常用本地或远程模型预设简短别名，支持单次对话中通过 /model + 别名即时切换，避免重复输入冗长模型路径，提升多任务协作效率。
1、执行命令为 Ollama 中的 glm-4.7-flash:q4_K_M 添加别名：openclaw models aliases add glm4 "ollama-local/glm-4.7-flash:q4_K_M"。
2、为 LM Studio 托管的 qwen3.6-35b-a3b 添加别名：openclaw models aliases add qw36 "lmstudio/qwen3.6-35b-a3b"。
3、为 SiliconFlow 的 DeepSeek-V4-Pro 添加别名：openclaw models aliases add ds4 "siliconflow/Pro/deepseek-ai/DeepSeek-V4-Pro"。
4、在任意对话窗口中，直接输入 /model glm4 即可切换至本地 GLM 模型。
5、输入 /model qw36 或 /model ds4 可分别切换至对应模型。
五、验证本地模型服务连通性与响应能力
该方法通过独立于 QClaw 的 HTTP 请求直连本地模型服务端点，排除客户端配置干扰，精准定位是服务未启动、防火墙拦截、还是模型加载失败等底层问题。
1、打开浏览器，访问 http://192.168.112.186:11434（Ollama 地址）或 http://localhost:1234（LM Studio 地址），确认页面返回 JSON 格式欢迎信息。
2、使用 curl 命令测试 Ollama 模型列表接口：curl http://192.168.112.186:11434/api/tags，检查输出中是否包含目标模型 ID。
3、构造 POST 请求测试模型推理能力（以 Ollama 为例）：curl -X POST http://192.168.112.186:11434/api/chat -H "Content-Type: application/json" -d '{"model":"qwen3.5:35b-a3b","messages":[{"role":"user","content":"你好"}]}'。
4、观察返回流式响应是否含 content 字段及合理文本，若返回空、超时或 404 错误，则说明模型未加载或服务异常。
5、若使用 LM Studio，需确认其 Local Server 页面中 Model loaded 状态为绿色且显示模型名称与量化格式（如 Q4_K_M）。
