clawpanel

ClawPanel 是支持多 AI Agent 框架的可视化管理面板，目前支持 OpenClaw 和 Hermes Agent 双引擎。内置智能 AI 助手，帮你一键安装、自动诊断配置、排查问题、修复错误。8 大工具 + 4 种模式 + 交互式问答，从新手到老手都能轻松管理。

🌐 官网: claw.qt.cool | 📦 下载: GitHub Releases

🎁 晴辰云 AI 接口

内部技术测试平台，面向部分用户开放体验。签到领额度，邀请得更多。

• 签到领测试额度 — 每日签到 + 邀请好友，持续获取测试额度
• 兼容 OpenAI 接口 — 无缝对接 OpenClaw，即开即用
• 资源策略 — 限速 + 请求上限，高峰期可能排队
• 模型可用性 — 模型/接口以实际页面为准，可能灰度或版本切换

配合 OpenClaw 使用：在 gpt.qt.cool 注册并签到领取测试额度，获取 API Key 后，初始化 OpenClaw 时选择 OpenAI Compatible 提供商，填入地址和 Key 即可使用。

⚠️ 合规与责任边界：本平台仅提供技术测试，禁止用于违法违规、绕过安全机制等用途。违规将限制访问并保留处置权。妥善保管 API Key，勿在截图/日志/代码库中泄露。具体规则以平台最新政策与页面展示为准。

🔥 开发板 / 嵌入式设备支持

ClawPanel 提供纯 Web 版部署模式（零 GUI 依赖），天然兼容 ARM64 开发板和嵌入式设备：

• Orange Pi / 树莓派 / RK3588 等 ARM64 板子 — npm run serve 即可运行
• Docker ARM64 镜像 — docker run ghcr.io/qingchencloud/openclaw:latest 开箱即用
• Armbian / Debian / Ubuntu Server — 一键部署脚本自动检测架构
• 无需 Rust / Tauri / 图形界面，只要有 Node.js 18+ 就能跑

📖 详见 Armbian 部署指南 | Web 版开发说明

社区交流

一群对 AI Agent 充满热情的开发者和玩家，欢迎加入交流。

下载安装

前往 Releases 页面下载最新版本，根据你的系统选择对应安装包：

macOS

| 芯片 | 安装包 | 说明 | |------|--------|------| | Apple Silicon (M1/M2/M3/M4) | ClawPanel_x.x.x_aarch64.dmg | 2020 年末及之后的 Mac | | Intel | ClawPanel_x.x.x_x64.dmg | 2020 年及之前的 Mac |

不确定芯片类型？点击左上角 → 关于本机，查看「芯片」一栏。

安装方式：打开 .dmg 文件，先将 ClawPanel 拖入「应用程序」文件夹，再双击打开。

⚠️ 首次打开提示"已损坏"或"无法验证开发者"？ 由于应用未签名，macOS 会拦截。请在终端执行以下命令解除限制：

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

或者前往「系统设置 → 隐私与安全性」，找到 ClawPanel 点击「仍要打开」。

提示 No such file？说明没有拖入应用程序文件夹。请先拖入，或改用：

sudo xattr -rd com.apple.quarantine ~/Downloads/ClawPanel.app

Windows

| 格式 | 安装包 | 说明 | |------|--------|------| | EXE 安装器 | ClawPanel_x.x.x_x64-setup.exe | 推荐，双击安装 | | MSI 安装器 | ClawPanel_x.x.x_x64_en-US.msi | 企业部署 / 静默安装 |

Linux

| 格式 | 安装包 | 说明 | |------|--------|------| | AppImage | ClawPanel_x.x.x_amd64.AppImage | 免安装，chmod +x 后直接运行 | | DEB | ClawPanel_x.x.x_amd64.deb | Debian / Ubuntu：sudo dpkg -i *.deb | | RPM | ClawPanel-x.x.x-1.x86_64.rpm | Fedora / RHEL：sudo rpm -i *.rpm |

Linux 服务器（Web 版）

没有桌面环境？一键部署 ClawPanel Web 版，通过浏览器远程管理 OpenClaw：

curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash

部署完成后访问 http://服务器IP:1420，功能与桌面版一致。

📖 详细教程见 Linux 部署指南

Docker 部署

docker run -d --name clawpanel --restart unless-stopped \
  -p 1420:1420 -v clawpanel-data:/root/.openclaw \
  node:22-slim \
  sh -c "apt-get update && apt-get install -y git && \
    npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com && \
    git clone https://github.com/qingchencloud/clawpanel.git /app && \
    cd /app && npm install && npm run build && npm run serve"

📖 详细教程见 Docker 部署指南（含 Compose、自定义镜像、Nginx 反向代理等）

升级面板

ClawPanel 提供多种升级方式，根据你的安装方式选择对应方案。

macOS / Windows 桌面版升级

桌面版内置自动更新机制，新版本发布后会自动提示升级：

1. 打开 ClawPanel，如有新版本会弹出升级提示
2. 点击「立即升级」，等待下载完成后自动安装重启
3. 也可前往「关于」页面手动检查更新

手动升级：如果自动更新失败，可前往 Releases 下载最新安装包，覆盖安装即可。数据不会丢失。

Linux 桌面版升级

| 格式 | 升级命令 | |------|----------| | AppImage | 下载最新 .AppImage 文件，替换旧文件，chmod +x 后运行 | | DEB | sudo dpkg -i ClawPanel_最新版本_amd64.deb | | RPM | sudo rpm -U ClawPanel-最新版本-1.x86_64.rpm |

Linux Web 版升级

方式一：一键升级脚本（推荐）

curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash

脚本会自动检测已有安装，拉取最新代码并重新构建。

方式二：手动升级

cd /opt/clawpanel  # 替换为实际安装目录
git pull origin main
npm install
npm run build
sudo systemctl restart clawpanel

升级 OpenClaw：面板和 OpenClaw 版本需要匹配。可在「服务管理」页面一键升级，或手动执行：

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

Docker 升级

Docker Compose 方式（推荐）

cd /path/to/clawpanel  # 包含 docker-compose.yml 的目录
docker compose build --no-cache clawpanel
docker compose up -d clawpanel

docker run 方式

# 停止并删除旧容器（数据保存在 Volume 中不会丢失）
docker stop clawpanel
docker rm clawpanel

# 重新启动新容器
docker run -d --name clawpanel --restart unless-stopped \
  -p 1420:1420 -v clawpanel-data:/root/.openclaw \
  node:22-slim \
  sh -c "apt-get update && apt-get install -y git && \
    npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com && \
    git clone https://github.com/qingchencloud/clawpanel.git /app && \
    cd /app && npm install && npm run build && npm run serve"

仅升级容器内的 OpenClaw

docker exec -it clawpanel npm install -g @qingchencloud/openclaw-zh@latest --registry https://registry.npmmirror.com

macOS / Windows Web 版升级

如果你使用源码部署了 Web 版（非桌面客户端），升级方式与 Linux Web 版一致：

cd clawpanel  # 替换为实际安装目录
git pull origin main
npm install
npm run build
npm run serve  # 重新启动

卸载面板

macOS 桌面版卸载

# 1. 删除应用
sudo rm -rf /Applications/ClawPanel.app

# 2. 清理应用数据（可选，删除后配置将丢失）
rm -rf ~/Library/Application\ Support/com.clawpanel.app
rm -rf ~/Library/Caches/com.clawpanel.app
rm -rf ~/Library/Preferences/com.clawpanel.app.plist

Windows 桌面版卸载

方式一：通过系统设置

1. 打开「设置」→「应用」→「已安装的应用」
2. 搜索 ClawPanel，点击「卸载」

方式二：通过控制面板

1. 打开「控制面板」→「程序」→「卸载程序」
2. 找到 ClawPanel，右键「卸载」

清理残留数据（可选）：

# 删除应用数据
Remove-Item -Recurse -Force "$env:APPDATA\com.clawpanel.app"
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\com.clawpanel.app"

Linux 桌面版卸载

| 格式 | 卸载命令 | |------|----------| | AppImage | 直接删除 .AppImage 文件即可 | | DEB | sudo dpkg -r clawpanel | | RPM | sudo rpm -e ClawPanel |

清理应用数据（可选）：

rm -rf ~/.local/share/com.clawpanel.app
rm -rf ~/.config/com.clawpanel.app

Linux Web 版卸载

# 1. 停止并禁用服务
sudo systemctl stop clawpanel
sudo systemctl disable clawpanel

# 2. 删除 systemd 服务文件
sudo rm -f /etc/systemd/system/clawpanel.service
sudo systemctl daemon-reload

# 3. 删除面板代码
sudo rm -rf /opt/clawpanel

# 4. 卸载 OpenClaw（可选）
sudo npm uninstall -g @qingchencloud/openclaw-zh

# 5. 删除 OpenClaw 数据（可选，删除后所有配置和记忆将丢失）
rm -rf ~/.openclaw

⚠️ 第 5 步会删除所有 OpenClaw 配置（API Key、模型设置、Agent 记忆等），请确认不再需要后再执行。