Installation安装指南

Installation安装指南

Start with ClawPanel, then choose the runtime you want to manage.先理解 ClawPanel 产品路径，再进入安装、配置、渠道和故障恢复。

桌面版安装

Windows

  1. 从 官方下载页 下载与你系统和版本匹配的 .exe 或 .msi 安装包
  2. 运行安装程序并按提示完成安装
  3. 安装完成后从开始菜单或安装程序创建的快捷方式启动

安全提示：如果出现 Windows SmartScreen，只在确认文件来自本站官方下载页或 GitHub Release、文件名和版本匹配时继续；来源不明请不要运行。

macOS

  1. 从 官方下载页 下载 .dmg 安装包
  2. 双击打开 DMG 文件
  3. 将 ClawPanel 拖入 Applications 文件夹
  4. 首次打开可能提示「无法验证开发者」

解决方法：打开「系统设置 → 隐私与安全性」，找到 ClawPanel 并点击「仍要打开」。如果仍无法打开，且你确认安装包来自官方发布页，可在终端运行：

sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app

Linux

手动安装：请先在 下载页面 选择与你的系统匹配的 .AppImage、.deb 或 .rpm 安装包。

# Debian/Ubuntu
sudo dpkg -i ClawPanel_*_amd64.deb

# Fedora/RHEL
sudo rpm -i ClawPanel-*-1.x86_64.rpm

# AppImage（通用）
chmod +x ClawPanel_*_amd64.AppImage
./ClawPanel_*_amd64.AppImage

前置依赖

ClawPanel 作为控制台需要连接到对应运行时才能发挥完整能力。当前主要面向 OpenClaw，并预留 Hermes / 爱马仕等后续运行时入口。

如果需要手动安装 OpenClaw 中文运行时，可参考官方 Linux 部署脚本使用的包名：

npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com
openclaw --version

需要 Node.js 18 或更高版本，服务器部署建议使用 Node.js 22 LTS。若镜像源不可用，可切换回官方 npm registry 后重试。

Desktop installation

Windows

  1. Download the .exe installer or .msi package from the official download page
  2. Run the installer and follow the prompts
  3. Launch ClawPanel from Start Menu or the shortcut created by the installer
  4. If SmartScreen appears, continue only when the file comes from the official download page or GitHub Release and the filename/version match

macOS

  1. Download the .dmg package from the official download page
  2. Open the DMG and drag ClawPanel to Applications
  3. If macOS blocks the first launch, open System Settings, Privacy & Security, then allow ClawPanel only when the package source is trusted

If the official package is still blocked and you accept the risk, remove the quarantine attribute:

sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app

Linux

Choose the package that matches your distribution on the download page.

# Debian/Ubuntu
sudo dpkg -i ClawPanel_*_amd64.deb

# Fedora/RHEL
sudo rpm -i ClawPanel-*-1.x86_64.rpm

# AppImage
chmod +x ClawPanel_*_amd64.AppImage
./ClawPanel_*_amd64.AppImage

Runtime dependency

ClawPanel is a control panel and needs the target runtime to provide full functionality. OpenClaw is the current primary runtime, with Hermes reserved as a future/runtime-specific path.

npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com
openclaw --version
qt.cool