Official releases官方下载

Download ClawPanel获取官方安装包

Windows macOS Linux All files全部文件 Portable携带版

Windows

Desktop installer · Windows 10+桌面安装 · Windows 10+

macOS

Signed disk image · Apple Silicon / Intel签名镜像 · Apple Silicon / Intel
macOS first launchmacOS 首次打开 If macOS blocks first launch, confirm the package came from the official download page, then open Terminal and run: 首次打开如提示无法验证开发者，可在确认安装包来自官方下载页后，打开「终端」执行下面命令：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app

Linux

Server friendly · AppImage / deb / rpm服务器友好 · AppImage / deb / rpm
Asset matrix文件矩阵

All release files全部发布文件

File文件Size大小Source来源SHA256Updated更新Action操作
ClawPanel-0.19.0-1.x86_64.rpmlinux / x64 / rpm
11.2 MB
R2 / localR2 / 本地
c713f5ee2932ab4c
2026-07-22
ClawPanel_0.19.0_amd64.AppImagelinux / x64 / appimage · recommended推荐
81.7 MB
R2 / localR2 / 本地
56d0d960ff9e3fb7
2026-07-22
ClawPanel_0.19.0_amd64.deblinux / x64 / deb
11.2 MB
R2 / localR2 / 本地
7219a7192f0cb376
2026-07-22
ClawPanel_0.19.0_aarch64.dmgmacos / arm64 / dmg · recommended推荐
12.5 MB
R2 / localR2 / 本地
9e38c1896199ba66
2026-07-22
ClawPanel_0.19.0_x64.dmgmacos / x64 / dmg · recommended推荐
12.9 MB
R2 / localR2 / 本地
df5e45fbfd5f3629
2026-07-22
web-0.19.0.zipweb / any / zip · recommended推荐
2.6 MB
R2 / localR2 / 本地
774e8d68cfe2838b
2026-07-22
ClawPanel_0.19.0_x64-full_en-US.msiwindows / x64 / msi
205.3 MB
Site proxy官网代理
f7e422d236b0200a
2026-07-22
ClawPanel_0.19.0_x64-setup-full.exewindows / x64 / exe
205.0 MB
Site proxy官网代理
1f7dc4e5b2c72a24
2026-07-22
ClawPanel_0.19.0_x64-setup.exewindows / x64 / exe · recommended推荐
9.7 MB
R2 / localR2 / 本地
d1d310fbefa61a19
2026-07-22
ClawPanel_0.19.0_x64_en-US.msiwindows / x64 / msi
12.5 MB
R2 / localR2 / 本地
5daaacc4c6f75b40
2026-07-22
Release notes更新日志

What changed in v0.19.0v0.19.0 更新内容

2026-07-15 09:08 10 assets GitHub Release
Open release查看发布页

[0.19.0] - 2026-07-15

新功能 (Features)

  • 创作中心与后台生成队列 — 新增图片、视频生成和本地产物管理；提交后立即进入持久化后台队列，支持并发控制、队列状态、历史记录、重启恢复和批量连续提交
  • 多服务商媒体生成 — 支持火山方舟、OpenAI / GPT 与 NewAPI / OpenAI 兼容网关，可分别配置 API Key、Base URL、图片模型、视频模型、超时和产出目录
  • 统一模型渠道 — 新增统一渠道页，一处维护服务商、接口、密钥和模型列表，并显式同步到 OpenClaw、Hermes 与晴辰助手；支持从 OpenClaw 导入、在线拉取模型和未同步状态提示
  • U 盘便携模式双向迁移 — 支持迁移到便携目录及从 U 盘迁回本机；配置、Agent、记忆、模型渠道和媒体数据一并迁移，目标已有数据会先备份再切换

兼容性 (Compatibility)

  • OpenClaw 2026.7.1 稳定版适配 — 推荐稳定版切换到官方 2026.7.1 / 汉化修复版 2026.7.1-zh.2；桌面端、Web/headless、Linux 部署与 standalone 安装统一使用同一稳定基线
  • OpenClaw 7.1 Node.js 门槛对齐 — 优先读取安装包 engines.node，缺少包元数据时按 >=22.22.3 <23 || >=24.15.0 <25 || >=25.9.0 兜底，避免误放行 Node.js 23 或过旧的 24.x
  • OpenClaw 7.1 配置契约对齐 — 旧字符串模型自动迁移为含 id/name 的完整对象，旧 Codex Responses API 类型迁移到正式名称；未知 API 类型和模型能力元数据继续保留
  • Hermes Agent 稳定版跟进 — 安装与升级固定到 Hermes Agent 0.18.2 / v2026.7.7.2，同步最新 Provider Registry，并补齐 Gateway 运行所需的 croniter、httpx、openai、aiohttp、websockets
  • Hermes Dashboard 兼容 — 优先使用上游 dashboard_auth，并提供受管 Web dist 作为 token bootstrap 兜底，桌面与 Web/headless 启动行为一致

改进 (Improvements)

  • 模型同步改为可验证事务 — OpenClaw 只提交目标 provider 的最小补丁并回读核对；Hermes 在备份、落盘和回读成功后才标记同步完成；助手同步同样执行本地回读确认
  • 模型密钥与能力字段无损往返 — 结构化 SecretRef、环境变量引用、上下文长度、输入能力和未知字段不会在编辑、导入或同步时被字符串化或丢失
  • OpenClaw 安装升级原子化 — npm 安装会先校验目标 Node.js 要求；standalone 归档通过 SHA-256、版本和运行依赖校验后再 staging/backup 切换，失败自动恢复旧安装
  • OpenClaw standalone 双源容灾 — 固定版本从 GitHub 下载时不再依赖 CDN latest.json；便携模式优先使用 U 盘内置 Node.js 与 CLI，并避免污染宿主机 PATH
  • Hermes 安装体验完善 — 安装与升级日志实时输出，支持 PyPI / Git 镜像、断点续行和可操作错误提示；环境异常时停留等待用户处理，不再自动跳页
  • Hermes 安装运行时加固 — 桌面端受管 uv 更新到 0.11.28，拒绝早于 0.11.24 的缓存冲突版本；wheel 元数据或分发缓存异常时自动使用隔离缓存重试，Web/headless 同步采用相同恢复策略
  • Web 自定义域名兼容 — 自动配对会把浏览器当前 Origin 增量写入 Gateway 白名单，支持 HTTPS 域名和自定义端口部署
  • 初始设置页首屏提速 — 本地检测先渲染、网络版本信息异步补充，并复用启动缓存，避免 npm registry 查询阻塞首屏
  • 发布流水线加固 — CI 在三平台运行锁定依赖的 Node / Rust 测试、格式、编译和 lint；tag 发布前校验版本、tag 与 HEAD 一致性，并在全平台产物成功后统一发布

安全 (Security)

  • 桌面运行时安全升级 — Tauri 升级到 2.11.1，修复远程页面可能混淆 Origin 并调用本地 IPC 的问题；tar 升级到 0.4.46，修复 PAX header 解析不同步问题
  • OpenClaw 配置安全写入 — 配置修改使用备份、同目录临时文件、fsync、原子替换和回读校验；失败保留最后有效备份，避免模型配置保存导致主配置损坏
  • 外部密钥引用保护 — 未改动的环境变量和结构化 SecretRef 不再阻断无关保存，也不会被当作明文写回；file / exec 引用不会被模型测试误当 API Key
  • 媒体 API Key 防泄漏 — 下载产物时仅向与服务商 Base URL 同源的地址携带 Authorization，跨源重定向自动剥离密钥，并限制响应体大小与读取超时
  • 助手付费生成必须确认 — 媒体生成工具默认关闭且需显式启用；图片、视频等付费请求在任何助手模式下都必须二次确认
  • 便携迁移路径保护 — 拒绝父目录穿越、源目标重叠和目录链接绕过，失败迁移不会留下半成品 manifest 或覆盖现有目标

修复 (Fixes)

  • OpenClaw 7.1 初次安装缺少运行依赖 — standalone 激活前校验 CLI 及核心运行依赖，失败不会替换现有安装；npm 与 standalone 路径统一按目标版本检查环境
  • OpenClaw 7.1 Gateway 重载不稳定 — 配置写入交给内核 watcher 热重载，不再探测不存在的面板端口；Windows 启动终端会等待受管 Gateway 进程退出，关闭窗口即可停止服务
  • 实时聊天长时间卡住 — 等待首个响应期间也可中止本次运行，输入状态变化会重新同步发送按钮；连接恢复后不会继续保持错误的禁用状态
  • 模型配置破坏未知字段 — 保存和删除 provider 改为最小补丁及显式墓碑，保留其它 provider、认证资料和上游新增字段；旧模型结构会在写入前安全迁移
  • 模型渠道下拉显示 [object Object] — API 类型选项改为可读名称，未知类型在编辑时仍保留原值供用户确认
  • Hermes 安装 wheel 元数据无效 — 修复旧 uv 缓存冲突导致 annotated-types 报 Metadata field Name not found；自动升级受管运行时并在缓存异常时透明重试
  • Hermes 0.18.2 Windows 启动后端口未就绪 — 所有 Hermes 子进程显式继承 ClawPanel 管理的 HERMES_HOME，避免新版平台默认目录变化导致读取空配置；启动前自动补齐 API Server 开关和随机强密钥，并保留已有合格密钥与其它环境配置
  • Hermes 0.18.2 自定义模型无回复 — 旧版裸 custom 配置自动迁移为新版命名 Provider，继续使用用户原有 Base URL 和密钥环境变量；迁移前备份 config.yaml，保留其它模型及高级配置，避免请求误回退到 OpenRouter 后返回 401
  • Hermes 仪表盘误导性 9119 入口 — 隐藏默认不运行且当前安装包不提供完整页面的原生 Dashboard 外链；继续保留 ClawPanel 内置仪表盘、实时聊天及内部按需 Dashboard API 能力
  • 创作中心提交后按钮一直禁用 — 后台刷新后重新定位当前表单按钮，生成完成或失败都会正确解锁；图片和视频提交不再阻塞页面等待云端任务结束
  • 视频任务瞬时错误失联 — 429 / 5xx 时保留任务并继续轮询；已有服务商任务 ID 的失败任务可恢复，无法识别任务 ID 时也保留原始响应供排查
  • 媒体历史膨胀与大文件卡顿 — 持久化前裁剪大体积原始响应，预览限制 64MB 并限制缓存数量；跨端视频状态解析保持一致
  • 便携迁移数据和状态异常 — 媒体配置与历史跟随 OpenClaw 数据迁移，失败会显示原因并保持原目标可恢复；Web 多实例查询固定在本地执行
  • 未安装时反复跳回检测页 — 安装失败不再强制重置向导；窗口聚焦只在后台更新检测结果，API Key / 配置错误改为页面内持续展示
  • 默认密码无提示挡住登录 — 使用出厂密码 123456 时，桌面与 Web 锁定页均直接提示并预填，登录后引导立即修改
  • 移动端语言菜单点穿 — 关闭状态不再拦截点击，切换语言后同步收起菜单和侧栏并更新 html lang
  • 跨平台发布被 Tauri 版本校验拦截 — 前端 @tauri-apps/api 与 Rust Tauri 同步到 2.11 系列，并增加锁文件主次版本一致性回归测试

测试与验证 (Testing)

  • Node.js 24.15.0 下 node --test tests/*.test.js：512 passed
  • Node.js 24.15.0 下 npm run build：通过
  • cargo fmt --all -- --check：通过
  • cargo check --locked：通过
  • cargo clippy --locked --all-targets -- -D warnings：通过
  • cargo test --locked：351 passed
  • Hermes Windows 隔离安装 smoke：使用 uv 0.11.14 --no-cache 完整安装 72 个依赖，hermes version 返回 v0.18.2 (2026.7.7.2)

Recent release notes最近版本日志

The latest few historical releases are shown here for quick comparison.这里直接显示最近几个历史版本，方便对比更新内容。

All releases全部历史版本
v0.18.5ClawPanel v0.18.5 2026-06-15 · 12 assets · Expand展开Collapse收起

[0.18.5] - 2026-06-15

修复 (Fixes)

  • Hermes 文件管理路径安全 — 文件读写/列表入口拒绝 .. 路径穿越，并通过 canonical path 校验新文件父目录，避免访问 ~/.hermes 之外的路径
  • 配对 token 撤销后不再复活 — 自动配对升级遇到已撤销的 operator token 时会生成新 token，不再复用带 revokedAtMs 的旧 token
  • Linux Gateway 清理更保守 — 清理端口占用时会先确认进程命令行属于 openclaw gateway，并在 /health 连续无响应后才终止，避免误杀同端口其他服务或健康 Gateway
  • 校准不再恢复用户已删配置 — 继承模式优先使用当前非空配置，只有当前配置为空时才从 .bak 回退，避免旧备份把用户主动删除的 provider/channel 恢复回来

测试与验证 (Testing)

  • 已通过 node --test tests/calibration-source-policy.test.js tests/gateway-linux-cleanup-policy.test.js tests/patch-gateway-origins.test.js tests/hermes-web-config.test.js
  • 已通过 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 normalize_existing_pairing_rotates_revoked_operator_token --lib
  • 已通过 cd src-tauri && cargo test select_calibration_source --lib
  • 已通过 cd src-tauri && cargo test hermes_fs_path --lib
  • 已通过 cd src-tauri && cargo clippy --all-targets -- -D warnings
  • 已通过 git diff --check

[0.18.5] - 2026-06-15

修复 (Fixes)

  • Hermes 文件管理路径安全 — 文件读写/列表入口拒绝 .. 路径穿越，并通过 canonical path 校验新文件父目录，避免访问 ~/.hermes 之外的路径
  • 配对 token 撤销后不再复活 — 自动配对升级遇到已撤销的 operator token 时会生成新 token，不再复用带 revokedAtMs 的旧 token
  • Linux Gateway 清理更保守 — 清理端口占用时会先确认进程命令行属于 openclaw gateway，并在 /health 连续无响应后才终止，避免误杀同端口其他服务或健康 Gateway
  • 校准不再恢复用户已删配置 — 继承模式优先使用当前非空配置，只有当前配置为空时才从 .bak 回退，避免旧备份把用户主动删除的 provider/channel 恢复回来

测试与验证 (Testing)

  • 已通过 node --test tests/calibration-source-policy.test.js tests/gateway-linux-cleanup-policy.test.js tests/patch-gateway-origins.test.js tests/hermes-web-config.test.js
  • 已通过 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 normalize_existing_pairing_rotates_revoked_operator_token --lib
  • 已通过 cd src-tauri && cargo test select_calibration_source --lib
  • 已通过 cd src-tauri && cargo test hermes_fs_path --lib
  • 已通过 cd src-tauri && cargo clippy --all-targets -- -D warnings
  • 已通过 git diff --check
Open release查看发布页
v0.18.4ClawPanel v0.18.4 2026-06-15 · 12 assets · Expand展开Collapse收起

[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.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
Open release查看发布页
v0.18.3ClawPanel v0.18.3 2026-06-11 · 12 assets · Expand展开Collapse收起

[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.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
Open release查看发布页
v0.18.2ClawPanel v0.18.2 2026-06-08 · 12 assets · Expand展开Collapse收起

[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.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 本地打包）
Open release查看发布页
USB portable bundleU 盘携带版

ClawPanel Portable

A full portable bundle for USB drives, offline demos, classrooms and temporary machines. The package can be large, so this page currently guides users to GitHub Release instead of proxying the file through the site download token flow.U 盘携带版适合随身携带、离线演示、教学机房和临时电脑。完整包可能较大，当前本站只做引导，不通过站内下载 token 代理大文件。

Preparing first release首个携带版发布准备中

Baseline included当前组件基准

  • ClawPanel 0.18.5
  • OpenClaw zh standalone 2026.6.1-zh.1
  • Hermes Agent 0.18.0 / v2026.7.1
  • uv 0.7.12

Planned package names计划发布文件名

ClawPanelPortable-Windows-x64-full-v0.18.5.zipClawPanelPortable-macOS-arm64-full-v0.18.5.zipClawPanelPortable-macOS-x64-full-v0.18.5.zip

Windows x64 is the first public target. macOS portable packages are suitable for internal testing before signing and notarization are settled.Windows x64 是第一优先公开目标；macOS 携带包在签名和公证完成前只建议内测使用。

View portable releases查看携带版发布 Build repository查看构建仓库 Portable guideU 盘使用说明
Server workflows服务器部署

Web deployment部署 ClawPanel Web

For Linux servers and remote administration, follow the Web deployment guide and keep ClawPanel behind HTTPS and access control.用于 Linux 服务器和远程管理时，请按 Web 部署文档配置，并将 ClawPanel 放在 HTTPS 与访问控制之后。

Verified source on 2026-06-052026-06-05 已验证来源

Linux / Web deployment scriptLinux / Web 部署脚本

The command below is the full URL from the official ClawPanel repository. Read the guide first before running it on a server.下面是 ClawPanel 官方仓库里的完整脚本地址。服务器执行前请先阅读部署文档，确认端口、systemd、反向代理和访问控制。

  • Default port documented by upstream: 1420上游文档默认端口：1420
  • Install paths and service behavior follow the script version in GitHub安装路径和服务行为以 GitHub 当前脚本为准
  • Public deployments should use HTTPS and access control公网部署请配置 HTTPS 和访问控制
curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash
Linux guideLinux 文档 View script查看脚本
Verified guide on 2026-06-052026-06-05 已验证文档

Docker deploymentDocker 部署

Use the official Docker guide for quick start, Compose and data persistence. The old unverified GHCR one-liner has been removed from this page.请以官方 Docker 文档为准，里面包含快速启动、Compose 和数据持久化方案。页面已移除之前未经验证的 GHCR 一行命令。

  • Base image in the guide: node:22-slim文档中的基础镜像：node:22-slim
  • Data volume: /root/.openclaw数据目录：/root/.openclaw
  • Recommended for production: Docker Compose生产环境推荐：Docker Compose
Docker guideDocker 文档 Releases发布页
qt.cool