Installation安装指南

Installation安装指南

Start with engine capabilities, then follow its installation, model sync and workspace guide. Pi remains experimental; engine capabilities differ.先了解各引擎能力，再按目标完成安装、模型同步和工作台配置。Pi 仍为实验版，各引擎功能并不相同。

桌面版安装

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 Agent、DeepSeek Harness、OpenCode 和实验版 Pi。选择引擎后在其设置向导或「运行与配置」页面安装；各引擎独立，不以安装 OpenClaw 为共同前提。详见引擎与驱动。

完整引擎环境推荐 Node.js 24.16.0+（24.x） 和 npm；OpenClaw 的 Node 约束按安装版本检测，Hermes 另需自身 Python 环境，Pi 至少要求 Node.js 22.19.0。

OpenClaw 新安装默认采用官方稳定版，汉化版仍可显式选择。手动安装官方基线示例：

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

版本为 ClawPanel 0.22.1 文档基线，并非上游最新版本承诺；实际目标以面板页面为准。若镜像源不可用，可切换回官方 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

Select OpenClaw, Hermes Agent, DeepSeek Harness, OpenCode or experimental Pi, then use its setup or Run & configuration page. The engines run independently; OpenClaw is not a shared prerequisite. See Engines & drivers.

Node.js 24.16.0+ (24.x) and npm are recommended for the full engine environment. OpenClaw checks its installed version's Node requirement; Hermes needs its own Python environment, and Pi requires Node.js 22.19.0 or later.

New OpenClaw installations default to the official stable channel; the Chinese distribution remains an explicit choice. Manual installation example for the ClawPanel 0.22.1 documentation baseline:

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

This is a documented baseline, not an upstream latest-version claim. Use the target shown in the panel.

qt.cool