内置 AI 助手的 OpenClaw & Hermes Agent 管理面板 — 多引擎 AI 框架管理

🇨🇳 中文 | 🇺🇸 English | 🇹🇼 繁體中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇻🇳 Tiếng Việt | 🇪🇸 Español | 🇧🇷 Português | 🇷🇺 Русский | 🇫🇷 Français | 🇩🇪 Deutsch

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 克充满热情的开发者和玩家，欢迎加入交流。

QQ 群

微信群

抖音群

飞书群

Discord  ·  元宝派  ·  Discussions  ·  反馈 Issue  ·  飞书群

下载安装

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

macOS

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

安装方式：打开 .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

Linux

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 install && npm run build && npm run serve"

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

升级面板

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

macOS / Windows 桌面版升级

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

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

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

Linux 桌面版升级

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 桌面版卸载

清理应用数据（可选）：

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 记忆等），请确认不再需要后再执行。

Docker 卸载

# 1. 停止并删除容器
docker stop clawpanel
docker rm clawpanel

# 2. 删除镜像（可选）
docker rmi $(docker images --filter "reference=*clawpanel*" -q) 2>/dev/null

# 3. 删除数据卷（可选，删除后所有配置将丢失）
docker volume rm clawpanel-data

如果使用 Docker Compose：

cd /path/to/clawpanel
docker compose down          # 停止并删除容器
docker compose down -v       # 同时删除数据卷（谨慎！）
docker rmi $(docker images --filter "reference=*clawpanel*" -q) 2>/dev/null

功能特性

• 🤖 AI 助手（全新·重磅） — 内置独立 AI 助手，4 种操作模式 + 8 大工具 + 交互式问答，详见下方 AI 助手亮点
• 🧩 多引擎架构 — 同时支持 OpenClaw 和 Hermes Agent 双引擎，自由切换，各自独立管理
• 🤖 Hermes Agent 对话 — 内置 Hermes Agent 聊天界面，支持工具调用可视化、文件系统访问开关、SSE 流式输出
• 🖼️ 图片识别 — 粘贴截图或拖拽图片，AI 自动识别分析，支持多模态图文混排对话
• 仪表盘 — 系统概览，服务状态实时监控，快捷操作
• 服务管理 — OpenClaw / Hermes Gateway 启停控制、版本检测与一键升级、配置备份与还原
• 模型配置 — 多服务商管理、模型增删改查、批量连通性测试、延迟检测、拖拽排序、自动保存+撤销
• 网关配置 — 端口、访问权限（本机/局域网）、认证 Token、Tailscale 组网
• 消息渠道 — 统一管理 Telegram、Discord、飞书、钉钉、QQ 等消息接入，支持同平台多 Agent 绑定
• 通信与自动化 — 消息设置、广播策略、斜杠命令、Webhook、执行审批转发等高级配置
• 使用情况 — Token 用量、API 费用、热门模型/服务商/工具排行、每日用量图表
• Agent 管理 — Agent 增删改查、身份编辑、模型配置、工作区管理
• 聊天 — 流式响应、Markdown 渲染、会话管理、/fast /think /verbose /reasoning 命令、Compaction 状态指示
• 定时任务 — Cron 定时执行，支持多渠道投递
• 日志查看 — 多日志源实时查看与关键词搜索
• 记忆管理 — 记忆文件查看/编辑、分类管理、ZIP 导出、Agent 切换
• 晴辰云 AI 接口 — 内部技术测试平台，兼容 OpenAI 接口，签到领测试额度
• 扩展工具 — cftunnel 内网穿透管理、ClawApp 状态监控
• 关于 — 版本信息、社群入口、相关项目链接、一键升级

功能截图

🤖 AI 助手 — 8 大技能卡片，一键触发配置检查、Gateway 诊断、环境检测、一键排障等常用操作

仪表盘 — Gateway / 隧道 / 服务实时状态，版本信息、Agent 数量、模型池一屏掌握

⚙️ AI 设置 — 独立模型配置 + 公益 AI 接口一键接入，GPT-5 全系列免费可用

一键切换，界面颜色随模式变化，清晰感知当前权限状态：

设置中还有工具开关（终端/文件），优先级高于模式——关掉终端，即使无限模式也调不了命令。

八大工具

交互式问答（ask_user）

AI 可以通过 ask_user 工具向你提问，支持三种交互方式：

• 单选 — 从多个方案中选一个，还能输入自定义答案
• 多选 — 勾选多项，比如"选择要检查的组件"
• 文本 — 自由输入，比如"描述你遇到的问题"

AI 等你回答后才会继续操作，实现真正的人机协作。

PR 助手 & Bug 报告

发现 Bug？AI 不只是告诉你怎么修——它直接帮你修：

1. 🐛 提交 Bug 报告 — AI 自动收集系统环境、读取错误日志，按标准模板整理成 GitHub Issue，你复制粘贴就能提交
2. 🔀 PR 助手 — AI 分析 Bug 根因 → 定位代码 → 生成修复方案 → 通过 run_command 执行 git 命令完成 Fork/Branch/Commit/Push，用户只需点确认

内置技能卡片

欢迎页提供一键触发的常用技能：

技术架构

clawpanel/
├── src/                    # 前端源码
│   ├── pages/              # 10 个页面模块
│   ├── components/         # 通用组件（侧边栏、弹窗、Toast）
│   ├── lib/                # 工具库（Tauri API 封装、主题）
│   ├── style/              # 样式文件
│   ├── router.js           # 路由
│   └── main.js             # 入口
├── src-tauri/              # Rust 后端
│   ├── src/                # Tauri 命令与业务逻辑
│   ├── Cargo.toml          # Rust 依赖
│   └── tauri.conf.json     # Tauri 配置
├── public/                 # 静态资源
├── scripts/                # 开发与构建脚本
│   ├── dev.sh              # 开发模式启动
│   └── build.sh            # 编译与打包
├── .github/workflows/      # CI/CD
│   ├── ci.yml              # 持续集成（push/PR 自动检查）
│   └── release.yml         # 发布构建（全平台打包）
├── index.html              # HTML 入口
├── vite.config.js          # Vite 配置
└── package.json            # 前端依赖

从源码构建

前置条件

• Node.js >= 18
• Rust (stable)
• Tauri v2 系统依赖（参考 Tauri 官方文档）

安装与开发

git clone https://github.com/qingchencloud/clawpanel.git
cd clawpanel
npm install

macOS / Linux

# 启动完整 Tauri 桌面应用
./scripts/dev.sh

# 仅启动 Vite 前端（浏览器调试，使用 mock 数据）
./scripts/dev.sh web

Windows

# 启动完整 Tauri 桌面应用
npm run tauri dev

# 仅启动 Vite 前端（浏览器调试，使用 mock 数据）
npm run dev

构建

macOS / Linux

# 编译 debug 版本
./scripts/build.sh

# 仅检查 Rust 编译（最快，不生成产物）
./scripts/build.sh check

# 编译正式发布版本（含打包）
./scripts/build.sh release

Windows

# 检查 Rust 编译
cd src-tauri && cargo check

# 编译正式发布版本
npm run tauri build

# 指定打包格式（NSIS 安装器）
npm run tauri build -- --bundles nsis

产物位于 src-tauri/target/release/ 目录。

Web 开发版（无需 Rust/Tauri）

如果你只想开发前端或部署 Web 版，不需要安装 Rust：

# 克隆并安装
git clone https://github.com/qingchencloud/clawpanel.git
cd clawpanel
npm install

# 开发模式（热更新，自带 API mock 后端）
npm run dev
# 浏览器打开 http://localhost:1420

# 构建生产版本
npm run build

# 启动 Web 服务器（Headless，适用于 Linux/ARM/Docker）
npm run serve
# 默认监听 0.0.0.0:1420，支持 --port 和 --host 参数

Web 版功能与桌面版一致，后端通过 scripts/dev-api.js 调用本机 OpenClaw CLI 实现。

ARM/Armbian 用户：Web 模式天然兼容 ARM64 设备，详见 Armbian 部署指南。

快速上手

安装完成后，按以下步骤即可开始使用：

1. 初始设置

首次启动 ClawPanel 会自动进入初始设置页面，引导你完成环境检测：

• ✅ Node.js — 自动检测，未安装时提供一键安装
• ✅ Git — 自动检测并配置 HTTPS 模式（解决 SSH 不通问题）
• ✅ OpenClaw — 一键安装，可选汉化版或原版

所有步骤均有绿色勾标记，全部通过后点击「前往模型配置」。

2. 配置 AI 模型

进入模型配置页面，添加至少一个 AI 服务商：

填入 Base URL 和 API Key，点击「测试连接」确认可用，然后保存。

3. 启动 Gateway

前往服务管理页面，点击「启动」按钮启动 Gateway。状态变为绿色即可。

Gateway 是 OpenClaw 的核心服务，负责处理 AI 对话请求。

4. 开始聊天

前往实时聊天页面，选择模型后即可开始对话。支持流式输出、Markdown 渲染、多模态图片识别。

Web 版部署指南

Web 版适用于 Linux 服务器（无桌面环境），通过浏览器远程管理 OpenClaw。

环境要求

• Node.js >= 18（推荐 22 LTS）
• Git（用于 OpenClaw 依赖安装）
• 端口 1420（ClawPanel）+ 18789（Gateway）

一键部署

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

部署完成后访问 http://服务器IP:1420。

安全注意事项

⚠️ 公网暴露风险：Web 版默认监听所有网卡。请务必：

1. 设置访问密码 — 首次登录会提示修改默认密码，或在「安全设置」页面配置
2. 防火墙限制 — 仅开放 1420 端口给可信 IP
3. Nginx 反向代理 + HTTPS — 生产环境强烈建议使用 HTTPS

server {
    listen 443 ssl;
    server_name openclaw.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:1420;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # WebSocket 支持（实时聊天需要）
    location /ws {
        proxy_pass http://127.0.0.1:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}

API Key 安全

• API Key 存储在服务器的 ~/.openclaw/openclaw.json 中，不会传输到外部
• 建议为 ~/.openclaw/ 目录设置 chmod 700 权限
• 多人共用时，每人应使用独立的 OpenClaw 实例

消息渠道配置

ClawPanel 支持将 AI 接入多种即时通讯平台，在「消息渠道」页面统一管理。

支持的平台

配置步骤（以飞书为例）

1. 在飞书开放平台创建企业自建应用，开启机器人能力
2. 获取 App ID 和 App Secret
3. 在 ClawPanel「消息渠道」页面选择飞书，填入凭证
4. 点击「校验」确认连接，然后「保存」
5. Gateway 会自动重载，飞书机器人即刻可用

📖 详细教程：飞书接入指南 | 钉钉接入指南

注意事项

• 消息渠道需要 Gateway 正在运行才能接收消息
• 每个平台需要配对审批才能连接（在渠道设置中完成）
• 飞书/钉钉需要在对应平台发布应用版本后，机器人才对其他人可见

常见问题

macOS 提示"已损坏，无法打开"

没有苹果开发者签名，macOS Gatekeeper 会拦截。终端执行：

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

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

macOS 检测不到 Node.js

从 Finder/Dock 启动 ClawPanel 时，应用的 PATH 环境变量可能不包含 Node.js 安装路径。

v0.4.1 已修复：自动补充 /usr/local/bin、/opt/homebrew/bin、~/.nvm、~/.volta 等常见路径。

临时解决：从终端启动 ClawPanel：

open /Applications/ClawPanel.app

Windows 安装 OpenClaw 报 ENOENT (-4058)

通常是文件权限或 npm 缓存问题：

1. 以管理员身份运行 ClawPanel
2. 或打开 PowerShell（管理员）手动安装：

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

3. 如果仍报错，清理 npm 缓存：npm cache clean --force

Windows 安装报 exit 128 (access rights)

npm 依赖需要 Git。如果已装 Git 但仍报 128，是因为依赖用了 SSH 协议拉代码但你没配 GitHub SSH Key。运行以下命令改用 HTTPS：

git config --global url."https://github.com/".insteadOf ssh://git@github.com/
git config --global url."https://github.com/".insteadOf git@github.com:

没装 Git 的请先安装 Git for Windows。v0.4.2+ 已自动配置 HTTPS 模式。

Windows 安装报 EPERM (operation not permitted)

文件被其他进程锁定。先关闭 ClawPanel 和所有 Node.js 进程，以管理员身份打开 PowerShell 重装：

npm cache clean --force
npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com

安装后 Node.js 检测不到（Windows）

安装 Node.js 后需要重启 ClawPanel，新的 PATH 环境变量才能生效。

如果安装在非默认路径（如 D:\nodejs、F:\AI\Node），请确认该目录已加入系统 PATH 环境变量。v0.4.2+ 已自动扫描常见安装路径。

Gateway 启动失败

常见原因和解决方案：

如果仍无法解决，查看「日志查看」页面的 Gateway 日志获取详细错误信息。

模型连接超时 / 测试失败

1. 检查 API Key — 确认 Key 未过期、余额充足
2. 检查 Base URL — 不同服务商 URL 格式不同，注意结尾不要多 /v1（ClawPanel 会自动处理）
3. 网络问题 — 国内访问 OpenAI 需要代理；DeepSeek / 阿里通义 / Ollama 国内直连
4. Ollama 特殊处理 — URL 填 http://127.0.0.1:11434（不加 /v1，ClawPanel 自动补全）

WebSocket 断连 / 聊天无响应

1. 确认 Gateway 正在运行（顶部状态栏显示绿色）
2. 反向代理需要配置 WebSocket 支持（参见上方 Nginx 配置）
3. 如果使用 HTTPS，WebSocket 需要 wss:// 协议（v0.7.3+ 已自动适配）
4. 清除浏览器缓存后刷新页面

Web 版报"未实现的命令"

升级到 v0.8.5+。旧版本的 Web 后端缺少部分命令实现，v0.8.5 已补全所有 handler。

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

消息渠道保存后不生效

1. 确认 Gateway 正在运行
2. 飞书/钉钉：需要在对应开放平台发布应用版本
3. 飞书：私聊测试需在「工作台」搜索机器人名称；群聊需通过「群设置 → 智能群助手」添加
4. 钉钉：消息接收模式必须选择 Stream 模式

相关项目

赞助商

感谢以下赞助商对 ClawPanel 项目的支持：

慈云数据服务团队于 2020 年成立，专注于基础云计算、游戏云、主题站长等业务 售前售后服务 24 小时在线值班，强力保证为客户提供优质稳定的网络资源与机房服务

贡献

欢迎提交 Issue 和 Pull Request。贡献流程详见 CONTRIBUTING.md。

致谢

ClawPanel 的成长离不开每一位贡献者的付出。感谢你们让这个项目变得更好！

🛠 代码贡献者

感谢以下开发者提交 Pull Request，直接参与了代码建设：

liucong2013 #88	axdlee #58	ATGCS #107	livisun #106	kiss-kedaya #101 #94	wzh4869 #82	0xsline #15	jonntd #18
octo-patch #163	SEVENTEEN-TAN #161	roc-xie #162

🐛 社区反馈者

感谢以下用户提交 Issue 报告 Bug 或建议功能，帮助 ClawPanel 持续改进：

如果遗漏了你的贡献，请 提交 Issue 告知我们，我们会第一时间补充！

许可证

本项目采用 AGPL-3.0 开源协议。企业如需闭源商用，可联系获取商业授权。

© 2026 武汉晴辰天下网络科技有限公司 | claw.qt.cool

ClawPanel 快速上手指南

ClawPanel 是一款内置 AI 助手的 OpenClaw & Hermes Agent 可视化管理面板，支持多引擎 AI 框架管理。本指南将帮助你快速在本地或服务器上部署并使用该工具。

1. 环境准备

系统要求

• 操作系统：
  • macOS (Intel 或 Apple Silicon M1/M2/M3/M4)
  • Windows 10/11 (x64)
  • Linux (Debian, Ubuntu, Fedora, RHEL, Armbian 等)
• 硬件架构：支持 x86_64 及 ARM64 (树莓派、Orange Pi、RK3588 等开发板)
• 核心依赖：
  • 桌面版：无需额外依赖，直接运行安装包。
  • Web 版/源码部署：需安装 Node.js 18+ (推荐 Node.js 22)。
  • Docker 部署：需安装 Docker 及 Docker Compose。

前置检查

确保你的设备已连接互联网。若使用 Web 版部署，请确保防火墙已开放 1420 端口。

2. 安装步骤

根据你的使用场景，选择以下任意一种安装方式：

方案 A：桌面客户端（推荐 macOS/Windows/Linux 桌面用户）

1. 前往 GitHub Releases 下载对应系统的安装包。
   • macOS: 下载 .dmg 文件，拖入「应用程序」文件夹。

     注：若提示“已损坏”，请在终端执行 sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app

   • Windows: 下载 .exe 安装器双击运行。
   • Linux: 下载 .AppImage (免安装) 或 .deb/.rpm 包进行安装。
2. 启动应用即可自动检测并引导配置。

方案 B：Linux 服务器 Web 版（一键脚本）

适用于无图形界面的 Linux 服务器或开发板。脚本会自动安装 Node.js 环境并部署面板。

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

安装完成后，在浏览器访问：http://<服务器 IP>:1420

方案 C：Docker 部署（通用）

适用于所有支持 Docker 的环境，数据持久化存储在 Volume 中。

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"

访问地址：http://<服务器 IP>:1420

3. 基本使用

第一步：初始化与 AI 助手诊断

启动面板后，你将看到仪表盘。点击首页的 "🤖 AI 助手” 卡片：

• 它会自动检测当前环境配置（如 Node 版本、OpenClaw 状态）。
• 若未安装核心组件，可点击 “一键安装” 自动完成部署。
• 若配置有误，AI 助手会提供 “一键修复” 建议。

第二步：配置模型服务商

1. 进入左侧菜单 “模型配置”。
2. 点击 “添加服务商”，选择提供商（如 OpenAI Compatible、硅基流动、晴辰云等）。
3. 填入 API Key 和 Base URL。

   提示：若使用国内测试平台，可注册 gpt.qt.cool 获取 Key，选择 "OpenAI Compatible" 模式填入。

4. 点击 “连通性测试” 验证接口是否正常，随后保存。

第三步：创建并对话 Agent

1. 进入 "Agent 管理”，点击 “新建 Agent"。
2. 设置 Agent 名称、选择刚才配置的模型，并可预设系统提示词（Prompt）。
3. 进入 “聊天” 界面，选择新建的 Agent 开始对话。
   • 支持流式输出、Markdown 渲染。
   • 可直接粘贴截图进行图片识别分析。
   • 输入 /fast、/think 等命令切换推理模式。

第四步：高级功能（可选）

• 消息渠道：在“消息渠道”中绑定 Telegram、Discord 或飞书，实现多平台消息接入。
• 定时任务：设置 Cron 表达式，让 Agent 定时执行任务并推送结果。
• 内网穿透：若需外网访问，可使用内置的 cftunnel 工具或配置 Tailscale。

提示：面板内置详细的交互式引导，遇到任何配置问题，优先询问首页的 AI 助手，它能提供针对你当前环境的精准解决方案。