[0.18.4] - 2026-06-15

兼容性 (Compatibility)

• 跟进 Hermes Agent 最新版 Web Search 策略 — Hermes upstream 已回滚无 Key 的 parallel-free 后端；面板不再提供或写入 parallel-free，Parallel 搜索统一使用需要 PARALLEL_API_KEY 的 parallel
• 补充 Hermes 最新模型候选 — Z.AI / GLM、Kimi / Moonshot、Nous Portal 与聚合服务商候选模型补充 glm-5.2、kimi-k2.7-code，减少用户手动输入新版模型名的成本

测试与验证 (Testing)

• 已通过 node --test tests/hermes-web-config.test.js tests/hermes-config-page-ui.test.js
• 已通过 cd src-tauri && cargo test hermes_web_config --lib
• 已通过 npm run build
• 已通过 node -e "import('./scripts/dev-api.js').then(()=>console.log('dev-api import ok'))"
• 已通过 cd src-tauri && cargo fmt --check
• 已通过 cd src-tauri && cargo check
• 已通过 git diff --check

[0.18.3] - 2026-06-11

修复 (Fixes)

• 最新版 OpenClaw 的 Node.js 门槛兼容 — 继续保留当前稳定推荐版不变；当用户已安装 OpenClaw 2026.6.5 或更高版本时，面板会按新版运行要求检测 Node.js >=22.19.0，旧稳定版不会被误拦截
• standalone OpenClaw Node.js 检测误判 — standalone 安装会优先使用同目录捆绑的 node / node.exe 做兼容检测，避免被 PATH 中较旧的系统 Node.js 误判
• 配对修复覆盖配置风险 — Gateway 配对流程只增量写入 gateway.controlUi.allowedOrigins，避免用旧的全量配置快照覆盖用户刚保存的模型、认证或安全配置
• 配置写回保留深层字段 — openclaw.json 写回改为对象递归合并，数组与标量仍显式替换，减少升级或自动修复时丢失未知配置字段的风险

兼容性 (Compatibility)

• 兼容 Parallel Web Search 插件 — Web 搜索后端白名单补充 parallel-free 与 parallel，并保留 plugins.entries.parallel.config.webSearch.apiKey / baseUrl 等插件配置
• 保留 OpenClaw 新增配置项 — 支持并保留 memory.qmd.rerank 与 security.installPolicy；校准/重置配置时会继承 memory、security 等高级配置块
• Linux 部署默认仍走稳定版 — 一键部署脚本默认安装 @qingchencloud/openclaw-zh@2026.5.18-zh.1，仅当检测到 OpenClaw 2026.6.5+ 时才提升 Node.js 运行门槛

改进 (Improvements)

• Hermes 配置页补充 QMD 与 Install Policy — 记忆配置新增 QMD rerank 开关，安全配置新增 Install Policy JSON 编辑入口，并保留其他高级 YAML 字段
• 第三方服务商接入规范更清晰 — 贡献指南新增 provider 接入规范，要求服务商 PR 保持中性技术接入，不夹带默认推广位或未经确认的商业宣传

测试与验证 (Testing)

• 已通过 git diff --check
• 已通过 bash -n scripts/linux-deploy.sh
• 已通过 npm run build
• 已通过 node --test tests/patch-gateway-origins.test.js tests/node-runtime-detection-policy.test.js tests/hermes-web-config.test.js tests/hermes-memory-config.test.js tests/hermes-security-config.test.js tests/hermes-config-page-ui.test.js
• 已通过 cd src-tauri && cargo fmt --check
• 已通过 cd src-tauri && cargo check
• 已通过 cd src-tauri && cargo test --lib
• 已通过 cd src-tauri && cargo clippy --all-targets -- -D warnings

[0.18.2] - 2026-06-08

修复 (Fixes)

• Node.js 版本过低导致 Gateway 启动失败 — 启动 Gateway 前会读取当前 OpenClaw 安装包的 engines.node 要求，发现 Node.js 不兼容时提前阻断并给出可执行提示，不再让用户看到后端崩溃日志
• Windows Node.js 版本过低时升级引导不足 — 设置向导在检测到 Node.js 过低时提供一键升级入口，通过 winget upgrade/install OpenJS.NodeJS.LTS 安装或升级 Node.js LTS，并在升级后刷新 PATH 检测
• 自定义 Node.js 路径可选中旧版本 — 扫描和手动保存 Node.js 路径时会同步校验版本兼容性，版本不满足当前 OpenClaw 要求的路径不再允许保存
• macOS / Linux / Web 模式缺少同等保护 — 桌面端 macOS 启动链路、Web/headless 后端 start_service、路径扫描和自定义路径保存均补齐 Node.js 兼容检测
• 新手引导误导用户创建 Agent — 默认 main Agent 已内置可用；仪表盘新手步骤改为“确认默认 Agent”，有任意 Agent 即视为完成，不再要求用户创建第一个 Agent

改进 (Improvements)

• 升级弹窗体验优化 — 自动过滤 winget 进度块和旋转符号噪音；升级成功后按钮改为“完成”，并提示回到仪表盘或服务页启动 Gateway
• 跨端 Node.js 升级提示更清晰 — Windows 显示一键升级，macOS / Linux 显示各自的手动升级建议和重启/重新检测提示
• Gateway 错误更用户友好 — 服务页会把 Node.js 版本过低错误转成普通用户能理解的升级提示
• 发布文案口径统一 — Release Notes、README、多语言 README 与部署文档统一说明 Node.js 要求，避免把 ClawPanel Web 后端的 Node.js 18+ 误读为当前 OpenClaw Gateway 的完整运行要求

测试与验证 (Testing)

• 已通过 npm run build
• 已通过 node -e "import('./scripts/dev-api.js').then(()=>console.log('dev-api import ok'))"
• 已通过 cd src-tauri && cargo fmt --check
• 已通过 cd src-tauri && cargo check
• 已通过 cd src-tauri && cargo test node_requirement --lib
• 已通过 git diff --check
• 已通过 npm run tauri build（Windows NSIS / MSI 本地打包）

[0.18.1] - 2026-06-07

修复 (Fixes)

• Windows OpenClaw 切换/升级后版本丢失 — 修复 npm 源切换时新旧包共用 openclaw.cmd，旧包卸载把新 CLI shim 一并删除的问题；安装成功后会重新确认 npm CLI 入口、读取版本并写入 ClawPanel 绑定
• standalone 升级后仍使用旧 CLI — standalone 安装完成后先校验目标 CLI 版本，再自动切换当前绑定路径，避免升级成功但面板仍指向旧 npm 全局目录
• 多安装路径提示误导 — 安装管理与仪表盘会区分“当前绑定安装”和 PATH 残留；已绑定新版时，旧 npm 路径只提示为 PATH 残留，不再误导用户再次绑定旧版
• Gateway 配对失败 / role-upgrade 循环 — 自动配对会补齐已有设备记录中的 operator role、scopes、approvedScopes 和 operator token，避免控制台反复提示 pairing required: device is asking for a higher role
• 配对修复误杀手动 Gateway — 设备配对和聊天页自动配对不再主动 reload/restart Gateway，避免 Windows 上手动启动的 Gateway 被面板重启打断
• Codex 导入缺少 API Key 后 OpenClaw 无法启动 — 导入 Codex/OpenAI 客户端配置时，如果引用的环境变量缺失，会阻止导入并提示补齐；保存 OpenClaw 配置时也会校验模型服务商的环境变量引用
• 仪表盘升级后仍显示旧版本/未知来源 — 升级或卸载完成后自动清理仪表盘版本缓存并刷新；自定义 npm prefix（如 D:\...\npm-global\openclaw.cmd）会读取 shim 内容识别为官方版或汉化版
• 升级弹窗关闭无效 — 修复升级完成后关闭按钮可能被页面刷新打断的问题

改进 (Improvements)

• 安装校验更严格 — npm 与 standalone 安装完成后都会校验目标版本，校验失败会保留旧绑定并给出明确错误
• Gateway 重装提示更清晰 — 切换 OpenClaw 源后会先修复并绑定当前 CLI，再重装 Gateway 服务，失败时保留更明确的手动处理提示
• Web/dev 后端行为对齐 — scripts/dev-api.js 同步桌面端的配对规范化、模型环境变量校验、安装绑定和 PATH 残留处理逻辑

测试与验证 (Testing)

• 已通过 npm run build
• 已通过 node --check scripts\dev-api.js
• 已通过 cd src-tauri && cargo fmt --check
• 已通过 cd src-tauri && cargo check
• 已通过 cd src-tauri && cargo test commands::pairing::tests
• 已通过 npm run tauri build（Windows NSIS / MSI 本地打包）