OpenClaw版本升级与本地模型Qwen对接教程实用指南

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“OpenClaw版本升级与本地模型Qwen对接教程”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

最近， OpenClaw终于不再疯狂的更新了，有时间把旧的版本升级到最新版、对接本地部署的 Qwen 模型，本文记录了升级、设置的过程，并分享踩坑与排错经验。

为什么要用 OpenClaw + 本地模型？

• 数据隐私：所有对话和工具调用都运行在本地，不经过第三方 API。
• 成本可控：采用开源模型（如 Qwen、Llama）可大幅降低调用成本。
• 灵活扩展：OpenClaw 的插件体系让智能体不仅能聊天，还能执行实际操作（文件、浏览器、设备等）。

第一步：升级 OpenClaw 到最新版

结合项目来看，OpenClaw 团队迭代很快，建议始终采用最新稳定版。升级方式取决于你的安装方式：

直接安装（建议）

powershell -c "irm https://openclaw.ai/install.ps1 | iex"

借助 npm 全局安装

npm update -g openclaw

检查版本：

openclaw --version
# 示例输出：2026.7.1-2 (0790d9f)

第二步：设置自定义模型提供者（本地 Qwen 服务）

我的本地模型服务运行在 （链接已移除）（借助 LM Studio 或 Ollama 启动），模型 ID 为 qwen3.6-35b-a3b。

采用onboard非交互式命令一次性设置

OpenClaw 提供了 onboard 向导，我们采用非交互模式（适合脚本化和重复执行）：

openclaw onboard --non-interactive --accept-risk 
  --auth-choice custom-api-key 
  --custom-provider-id my-local-llm 
  --custom-base-url http://192.168.1.12:1234/v1 
  --custom-model-id qwen3.6-35b-a3b 
  --custom-api-key "none" 
  --custom-compatibility openai

参数说明：

• --accept-risk：必须显式确认风险（AI 智能体有系统访问权限）。
• --auth-choice custom-api-key：采用自定义 API Key 方式（本地模型无需真实 key）。
• --custom-provider-id：给这个提供商起一个唯一名称，比如 my-local-llm。
• --custom-base-url：你的本地 API 端点。
• --custom-model-id：模型实际 ID。
• --custom-api-key：本地服务若无认证，填 "none" 即可。
• --custom-compatibility openai：大多数本地服务兼容 OpenAI API 格式。

执行后，设置会写入 ~/.openclaw/openclaw.json。如果遇到健康检查超时（因为网关未启动），无需担心，设置已经保存。

设置默认模型

在这个场景下，虽然提供商已添加，但 OpenClaw 的 Agent 默认可能仍采用 OpenAI。我们需手动指定默认模型路径（格式为 provider/model）：

openclaw config set agents.defaults.model "my-local-llm/qwen3.6-35b-a3b"

如果想要特定 Agent（如 main）也采用该模型：

openclaw agents set main --model "my-local-llm/qwen3.6-35b-a3b"

注意：早期版本的 OpenClaw 不兼容 agents.defaults.provider，只能设置 model，且必须包含提供商前缀。

第三步：启动网关并访问 Web 控制台

启动网关（前台运行，便于调试）

openclaw gateway run

日志显示 http server listening 和 agent model: my-local-llm/qwen3.6-35b-a3b 即表示成功。

作为后台服务运行（建议）

为便于开机自启，能够安装为系统服务（Windows 计划任务）：

openclaw gateway install   # 或 openclaw onboard --install-daemon

启动/停止/重启：

openclaw gateway start
openclaw gateway stop
openclaw gateway restart

拿到 Web 控制台地址

网关默认 127.0.0.1:18789，访问地址为 （链接已移除）。

从实现思路看，但首次访问需认证 Token，可借助以下命令拿到完整链接（含 Token）：

openclaw dashboard --no-open

复制输出的 URL 到浏览器即可进入控制台。

第四步：验证与测试

理解这一步时，在 Web 控制台发送一条消息，比如“北京今天天气怎么样？”，观察网关日志：

[provider-transport-fetch] [model-fetch] start provider=my-local-llm model=qwen3.6-35b-a3b url=http://192.168.1.12:1234/v1/ch@t/completions
[provider-transport-fetch] [model-fetch] response status=200 elapsedMs=351 contentType=text/event-stream

若看到 status=200，说明模型调用成功。如果天气插件已启用，你还会看到工具调用日志。

常用问题与解决

No API key found for provider "openai"

原因：Agent 仍回退到默认 OpenAI 提供者。

解决：检查 agents.defaults.model 是否设置为 my-local-llm/qwen3.6-35b-a3b，同时确认没有残留的 agents.defaults.provider 设置。

Config path not found: agents.defaults.provider

说明：你的设置版本不兼容该路径，直接设置 model 即可，无需设置 provider。

网关启动失败，端口 18789 被占用

解决：采用 openclaw gateway stop 停止旧进程，或换端口启动：openclaw gateway run --port 18790。

Web 控制台无法连接（WebSocket 错误）

• 检查网关是否正在运行：openclaw status
• 检查防火墙是否放行 18789 端口。
• 落到代码里，访问时需带上 Token 参数（或借助 openclaw dashboard --no-open 生成的完整链接）。

本地模型服务不可达

• 验证服务是否在 （链接已移除） 可访问。
• 在这个场景下，检查 IP 地址是否正确，若为动态 IP，建议采用静态 IP 或主机名。

设置文件片段（供参考）

最后 ~/.openclaw/openclaw.json 中关键部分如下所示（已隐去敏感信息）：

{
  "models": {
    "providers": {
      "my-local-llm": {
        "baseUrl": "http://192.168.1.12:1234/v1",
        "apiKey": "none",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.6-35b-a3b",
            "name": "Qwen 3.6",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0 },
            "contextWindow": 8192,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": "my-local-llm/qwen3.6-35b-a3b"
    },
    "main": {
      "model": "my-local-llm/qwen3.6-35b-a3b"
    }
  },
  "gateway": {
    "auth": {
      "token": "claw-xxxx-xxxx-xxxx"   // 请妥善保管
    },
    "port": 18789
  }
}

总结

从实现思路看，借助上述步骤，我成功将 OpenClaw 升级到最新版，同时完成了本地模型的对接。现在，我能够：

• 在漂亮的 Web 控制台与智能体对话。
• 调用内置插件（天气、搜索、文件等），而所有 AI 推理都运行在本地。
• 享受与云端模型接近的体验，同时拥有完全的隐私和控制权。

从实现思路看，OpenClaw 的模块化设计让接入自定义模型很顺畅，即使是非交互式设置也足够灵活。如果你也想打造自己的专属 AI 助理，不妨按照本文试一试！

实际处理时，以上就是OpenClaw版本升级与本地模型Qwen对接教程的详细内容，更多关于OpenClaw版本升级与对接Qwen的资料请关注脚本之家其它相关文章！