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.21.6-1.x86_64.rpmlinux / x64 / rpm
12.0 MB
R2 / localR2 / 本地
cccbb375d1fb61aa
2026-09-05
ClawPanel_0.21.6_amd64.AppImagelinux / x64 / appimage · recommended推荐
83.0 MB
R2 / localR2 / 本地
dc2b9197efa0af13
2026-09-05
ClawPanel_0.21.6_amd64.deblinux / x64 / deb
12.0 MB
R2 / localR2 / 本地
0022eae1f0063c78
2026-09-05
ClawPanel_0.21.6_aarch64.dmgmacos / arm64 / dmg · recommended推荐
13.4 MB
R2 / localR2 / 本地
10419862c7d80562
2026-09-05
ClawPanel_0.21.6_x64.dmgmacos / x64 / dmg · recommended推荐
13.8 MB
R2 / localR2 / 本地
2dd6b409ee4b27d2
2026-09-05
frontend-hot-update-0.21.6.zipother / x64 / zip
3.4 MB
R2 / localR2 / 本地
92064e352de68b78
2026-09-05
web-0.21.6.zipweb / any / zip · recommended推荐
5.9 MB
R2 / localR2 / 本地
8df76d377abc99ee
2026-09-05
ClawPanel_0.21.6_x64-full_en-US.msiwindows / x64 / msi
258.7 MB
Site proxy官网代理
e6d09a028716cdd5
2026-09-05
ClawPanel_0.21.6_x64-setup-full.exewindows / x64 / exe
258.9 MB
Site proxy官网代理
5c4a8e37d636f706
2026-09-05
ClawPanel_0.21.6_x64-setup.exewindows / x64 / exe · recommended推荐
10.8 MB
R2 / localR2 / 本地
df03e496018fbb91
2026-09-05
ClawPanel_0.21.6_x64_en-US.msiwindows / x64 / msi
13.7 MB
R2 / localR2 / 本地
da276e1b47a6425b
2026-09-05
Release notes更新日志

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

2026-09-02 11:40 11 assets GitHub Release
Open release查看发布页

[0.21.6] - 2026-09-02

兼容性 (Compatibility)

  • 官方 OpenClaw 稳定基线升级到 2026.8.2 — 安装向导、Linux 一键部署与 Docker 镜像默认使用官方 openclaw@2026.8.2；继续保留 8.1 起的 agents.entries、模型策略和 Gateway challenge 时间戳兼容逻辑，并保持对旧版内核的协议范围兼容

修复 (Fixes)

  • 仪表盘实时刷新 WebSocket 状态 — Gateway 握手完成后立即把“握手中”更新为“已连接”，无需切页或手动刷新

测试与验证 (Testing)

  • 官方 npm openclaw@2026.8.2 隔离运行时通过配置 schema、Agent 注册表、协议 4 Gateway 握手、health/status、消息渠道、路由地图、梦境模式与真实本地模型对话回归

Recent release notes最近版本日志

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

All releases全部历史版本
v0.21.5ClawPanel v0.21.5 2026-09-01 · 11 assets · Expand展开Collapse收起

[0.21.5] - 2026-09-01

修复 (Fixes)

  • 修复 OpenClaw 2026.8.1 WebSocket 远程 Origin 拒绝 — Web/Ubuntu 代理不再把浏览器公网或局域网 Origin 直接传给本机 Gateway，统一使用受面板 Session 保护的 loopback 上游来源，实时聊天、路由地图、渠道运行态与梦境模式恢复连接
  • 阻止 Web 前后端混装 — /__api/health 返回后端版本和 API 契约版本；浏览器检测到只替换 dist/ 导致版本不一致时停止加载，并明确提示安装完整 Web 包

改进 (Improvements)

  • 区分完整 Web 包与桌面热更新包 — Release 中 web-x.y.z.zip 改为可独立运行的完整 Node Web 服务端包，frontend-hot-update-x.y.z.zip 仅保留给桌面端前端热更新，避免用户误装

[0.21.5] - 2026-09-01

修复 (Fixes)

  • 修复 OpenClaw 2026.8.1 WebSocket 远程 Origin 拒绝 — Web/Ubuntu 代理不再把浏览器公网或局域网 Origin 直接传给本机 Gateway，统一使用受面板 Session 保护的 loopback 上游来源，实时聊天、路由地图、渠道运行态与梦境模式恢复连接
  • 阻止 Web 前后端混装 — /__api/health 返回后端版本和 API 契约版本；浏览器检测到只替换 dist/ 导致版本不一致时停止加载，并明确提示安装完整 Web 包

改进 (Improvements)

  • 区分完整 Web 包与桌面热更新包 — Release 中 web-x.y.z.zip 改为可独立运行的完整 Node Web 服务端包，frontend-hot-update-x.y.z.zip 仅保留给桌面端前端热更新，避免用户误装
Open release查看发布页
v0.21.4ClawPanel v0.21.4 2026-09-01 · 10 assets · Expand展开Collapse收起

[0.21.4] - 2026-09-01

修复 (Fixes)

  • 兼容 OpenClaw 2026.8.1 Gateway 新握手 — Web、桌面端、实时聊天和聊天诊断统一复用 connect.challenge.ts 完成 Ed25519 设备签名，修复官方 8.1 运行正常但 ClawPanel 报“设备签名失败/内核过旧”的问题
  • 继续兼容旧版 Gateway — 旧版 challenge 未提供时间戳时回退客户端当前时间，并保持 3..4 协议协商范围；Token 与 Password 认证按 7.1/8.1 共同签名契约处理
  • 纠正连接错误诊断 — 设备签名、Nonce、Public Key 错误不再误判为协议版本过旧，只有明确的协议协商错误才提示升级内核

改进 (Improvements)

  • 稳定版默认使用官方原版 — 安装向导、未知来源升级、Linux 一键部署和 Docker 镜像默认使用官方 openclaw@2026.8.1；汉化版 2026.7.1-2-zh.1 继续作为明确选项，已有汉化安装不会被强制切换
  • 增加真实 Gateway 握手回归工具 — 新增隔离设备密钥的 smoke 脚本，可分别验证官方/汉化版以及 Token/Password 认证，不读取或输出用户密钥

测试与验证 (Testing)

  • 官方 openclaw@2026.8.1 完成 Token 与 Password 两种真实 Gateway 握手；汉化版 @qingchencloud/openclaw-zh@2026.7.1-2-zh.1 完成 Token 握手，三组均协商到协议版本 4
  • Node 全量测试、Rust 单元测试、生产构建、格式检查、编译检查、Clippy 严格门禁和 Linux 部署脚本语法检查通过

[0.21.4] - 2026-09-01

修复 (Fixes)

  • 兼容 OpenClaw 2026.8.1 Gateway 新握手 — Web、桌面端、实时聊天和聊天诊断统一复用 connect.challenge.ts 完成 Ed25519 设备签名，修复官方 8.1 运行正常但 ClawPanel 报“设备签名失败/内核过旧”的问题
  • 继续兼容旧版 Gateway — 旧版 challenge 未提供时间戳时回退客户端当前时间，并保持 3..4 协议协商范围；Token 与 Password 认证按 7.1/8.1 共同签名契约处理
  • 纠正连接错误诊断 — 设备签名、Nonce、Public Key 错误不再误判为协议版本过旧，只有明确的协议协商错误才提示升级内核

改进 (Improvements)

  • 稳定版默认使用官方原版 — 安装向导、未知来源升级、Linux 一键部署和 Docker 镜像默认使用官方 openclaw@2026.8.1；汉化版 2026.7.1-2-zh.1 继续作为明确选项，已有汉化安装不会被强制切换
  • 增加真实 Gateway 握手回归工具 — 新增隔离设备密钥的 smoke 脚本，可分别验证官方/汉化版以及 Token/Password 认证，不读取或输出用户密钥

测试与验证 (Testing)

  • 官方 openclaw@2026.8.1 完成 Token 与 Password 两种真实 Gateway 握手；汉化版 @qingchencloud/openclaw-zh@2026.7.1-2-zh.1 完成 Token 握手，三组均协商到协议版本 4
  • Node 全量测试、Rust 单元测试、生产构建、格式检查、编译检查、Clippy 严格门禁和 Linux 部署脚本语法检查通过
Open release查看发布页
v0.21.3ClawPanel v0.21.3 2026-08-31 · 10 assets · Expand展开Collapse收起

[0.21.3] - 2026-08-31

兼容性 (Compatibility)

  • 适配 OpenClaw 2026.8.1 Agent 注册表 — Web 与桌面端同时支持旧版 agents.list[] 和新版 agents.entries.{id}，Agent 列表、增删改、身份、模型、Workspace、Memory 与 Skills 均按当前内核配置形状读写，并为多 Agent 配置维护 ownership: "explicit"
  • 清理 8.1 退役配置字段 — 校准、普通保存、Docker 节点同步和已有配置回读会按已安装内核版本移除 commands.ownerDisplay* 与 gateway.controlUi.allowInsecureAuth；旧汉化内核继续保留原字段，避免两套严格 schema 互相污染
  • 适配 8.1 模型策略语义 — 保留 agents.defaults.models 作为模型元数据；仅在用户已经启用显式 modelPolicy.allow 时同步白名单，避免把新版默认的 allow-any 配置意外收紧
  • Web 端补齐 OpenClaw Doctor — Web/Ubuntu 可直接执行当前绑定 CLI 的诊断与修复；8.1 自动使用非交互迁移参数，Web 改为异步子进程并将迁移超时提升至 120 秒，桌面端同步提升超时
  • 官方稳定版基线更新 — 官方 OpenClaw 推荐版本更新为 2026.8.1；汉化版继续保持当前已发布的 2026.7.1-2-zh.1，避免向旧内核写入新版配置形状

测试与验证 (Testing)

  • 官方 npm openclaw@2026.8.1 隔离运行时完成旧 agents.list → 新 agents.entries Doctor 迁移、配置回读、Gateway 启动、HTTP 200、CLI health 与 RPC status 验证；ClawPanel 直接生成的 8.1 keyed 配置通过官方 schema 校验
  • 当前本机汉化版 2026.7.1-zh.2 隔离配置继续通过旧 agents.list schema 校验
  • node --test tests/*.test.js：597 项，596 passed、1 项 POSIX 用例在 Windows 跳过；Rust cargo test --locked：363 passed；生产构建、格式检查、编译检查和 Clippy 严格门禁通过

[0.21.3] - 2026-08-31

兼容性 (Compatibility)

  • 适配 OpenClaw 2026.8.1 Agent 注册表 — Web 与桌面端同时支持旧版 agents.list[] 和新版 agents.entries.{id}，Agent 列表、增删改、身份、模型、Workspace、Memory 与 Skills 均按当前内核配置形状读写，并为多 Agent 配置维护 ownership: "explicit"
  • 清理 8.1 退役配置字段 — 校准、普通保存、Docker 节点同步和已有配置回读会按已安装内核版本移除 commands.ownerDisplay* 与 gateway.controlUi.allowInsecureAuth；旧汉化内核继续保留原字段，避免两套严格 schema 互相污染
  • 适配 8.1 模型策略语义 — 保留 agents.defaults.models 作为模型元数据；仅在用户已经启用显式 modelPolicy.allow 时同步白名单，避免把新版默认的 allow-any 配置意外收紧
  • Web 端补齐 OpenClaw Doctor — Web/Ubuntu 可直接执行当前绑定 CLI 的诊断与修复；8.1 自动使用非交互迁移参数，Web 改为异步子进程并将迁移超时提升至 120 秒，桌面端同步提升超时
  • 官方稳定版基线更新 — 官方 OpenClaw 推荐版本更新为 2026.8.1；汉化版继续保持当前已发布的 2026.7.1-2-zh.1，避免向旧内核写入新版配置形状

测试与验证 (Testing)

  • 官方 npm openclaw@2026.8.1 隔离运行时完成旧 agents.list → 新 agents.entries Doctor 迁移、配置回读、Gateway 启动、HTTP 200、CLI health 与 RPC status 验证；ClawPanel 直接生成的 8.1 keyed 配置通过官方 schema 校验
  • 当前本机汉化版 2026.7.1-zh.2 隔离配置继续通过旧 agents.list schema 校验
  • node --test tests/*.test.js：597 项，596 passed、1 项 POSIX 用例在 Windows 跳过；Rust cargo test --locked：363 passed；生产构建、格式检查、编译检查和 Clippy 严格门禁通过
Open release查看发布页
v0.21.2ClawPanel v0.21.2 2026-08-26 · 10 assets · Expand展开Collapse收起

[0.21.2] - 2026-08-26

修复 (Fixes)

  • Gateway 缺失依赖可直接定位 — 启动诊断会识别 Cannot find package / MODULE_NOT_FOUND，明确显示缺失的 OpenClaw 运行依赖，不再让用户把 npm 安装损坏误判为模型、端口或 API Key 问题
  • OpenClaw 安装完成后校验运行依赖 — Web 与桌面安装器除版本检查外，还会核对主包声明的全部直接运行依赖；镜像源返回不完整安装时自动切换 npm 官方源重装，避免“安装成功但 Gateway 无法启动”

改进 (Improvements)

  • 诊断窗口支持一键修复 — 对可修复的运行依赖缺失提供“一键修复 OpenClaw”，保留现有配置、强制重装当前稳定版、完成依赖校验并自动重新启动 Gateway
  • 修复流程保持安装模式 — 自动识别官方版、汉化版以及 npm/standalone 来源，优先沿用当前运行模式和 ClawPanel 绑定的稳定版本

测试与验证 (Testing)

  • 使用用户实际反馈的 @openclaw/ai 缺失日志补充诊断回归；Web 与 Rust 后端均覆盖不完整 npm 依赖树拒绝、完整依赖树通过和镜像失败切换官方源
  • node --test：589 项，588 passed、1 项 POSIX 用例在 Windows 跳过；Rust cargo test --lib：360 passed；生产构建、格式检查和 Clippy 严格门禁通过

[0.21.2] - 2026-08-26

修复 (Fixes)

  • Gateway 缺失依赖可直接定位 — 启动诊断会识别 Cannot find package / MODULE_NOT_FOUND，明确显示缺失的 OpenClaw 运行依赖，不再让用户把 npm 安装损坏误判为模型、端口或 API Key 问题
  • OpenClaw 安装完成后校验运行依赖 — Web 与桌面安装器除版本检查外，还会核对主包声明的全部直接运行依赖；镜像源返回不完整安装时自动切换 npm 官方源重装，避免“安装成功但 Gateway 无法启动”

改进 (Improvements)

  • 诊断窗口支持一键修复 — 对可修复的运行依赖缺失提供“一键修复 OpenClaw”，保留现有配置、强制重装当前稳定版、完成依赖校验并自动重新启动 Gateway
  • 修复流程保持安装模式 — 自动识别官方版、汉化版以及 npm/standalone 来源，优先沿用当前运行模式和 ClawPanel 绑定的稳定版本

测试与验证 (Testing)

  • 使用用户实际反馈的 @openclaw/ai 缺失日志补充诊断回归；Web 与 Rust 后端均覆盖不完整 npm 依赖树拒绝、完整依赖树通过和镜像失败切换官方源
  • node --test：589 项，588 passed、1 项 POSIX 用例在 Windows 跳过；Rust cargo test --lib：360 passed；生产构建、格式检查和 Clippy 严格门禁通过
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