ClawPanel 使用教程：给 OpenClaw 装上可视化管理面板

1）打开下载页#

下载地址：

• 官网：https://claw.qt.cool/
• Releases：https://github.com/qingchencloud/clawpanel/releases/latest

根据自己的系统选择安装包：

• Windows：优先下载 exe 安装器
• macOS：按芯片选择 Apple Silicon 或 Intel 版本
• Linux：如果你是桌面 Linux，优先看官方发布包；如果是服务器场景，建议直接用后面的 Web 版教程

2）安装后直接打开#

首次打开时，ClawPanel 会自动带你做基础检查，比如：

• Node.js 是否可用
• Git 是否可用
• OpenClaw 是否已安装
• 当前环境是否能启动 Gateway

3）macOS 提示“已损坏”或“无法验证开发者”怎么办#

官方给出的处理方式是：

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

如果你还没把应用拖进“应用程序”目录，就先拖进去再执行。

环境要求#

• Node.js 18+，推荐 22 LTS
• npm
• Git
• 已安装的 OpenClaw

方式一：一键部署#

这是官方最省事的方式：

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

这个脚本会自动完成：

1. 检测系统
2. 安装 Node.js（如果缺少）
3. 安装 OpenClaw（如果缺少）
4. 克隆 ClawPanel 仓库
5. 安装依赖
6. 创建服务并启动

部署完成后，直接访问：

1
http://服务器IP:1420

方式二：手动部署#

如果你想自己掌控每一步，可以按官方文档手动部署。

1
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
2
sudo apt-get install -y nodejs

1
node -v
2
npm -v

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

1
cd /opt
2
sudo git clone https://github.com/qingchencloud/clawpanel.git
3
sudo chown -R $(whoami) clawpanel
4
cd clawpanel
5
npm install

1
npm run build
2
npm run serve

1
0.0.0.0:1420

1
npm run serve -- --port 8080

快速启动#

1
docker run -d \
2
  --name clawpanel \
3
  --restart unless-stopped \
4
  -p 1420:1420 \
5
  -v clawpanel-data:/root/.openclaw \
6
  node:22-slim \
7
  sh -c "\
8
    apt-get update && apt-get install -y git && \
9
    npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com && \
10
    openclaw init 2>/dev/null || true && \
11
    git clone https://github.com/qingchencloud/clawpanel.git /app && \
12
    cd /app && npm install && npm run build && \
13
    npm run serve"

启动后访问：

1
http://服务器IP:1420

Docker 方式要注意的点#

• 数据目录要持久化到 /root/.openclaw
• 快速启动适合体验，不太适合长期生产使用
• 如果你准备长期跑，官方更推荐 Compose 或自定义镜像方案
• 如果要让面板去管理 Gateway，Docker 场景下要考虑网络和进程管理方式

1）先检查环境#

先确认面板里这些项目都是正常的：

• Node.js
• Git
• OpenClaw
• Gateway 状态

如果这里有红色报错，先不要急着继续配模型，先把基础环境处理好。

2）配置模型服务商#

进入模型配置页后，至少先添加一个可用模型。

比如常见的：

• DeepSeek
• OpenAI
• 阿里通义
• Ollama

填好 Base URL 和 API Key 之后，先做一次连接测试，确认能通再保存。

3）启动 Gateway#

进入服务管理页面，启动 Gateway。
如果状态能正常变绿，说明核心服务已经跑起来了。

4）去聊天页做一次测试#

这一步不要省。

直接去实时聊天页面，发一句简单测试，例如：

1
你好，请回复一句“连接正常”

如果能稳定返回，就说明这套流程已经打通了。

1）提示 openclaw.json 不存在#

说明 OpenClaw 还没有初始化。

执行：

1
openclaw init

2）1420 端口被占用#

可以先看是谁占用了端口：

1
lsof -i :1420

如果不想处理占用，也可以直接换端口：

1
npm run serve -- --port 3000

3）反向代理后页面打不开或聊天不通#

这种情况通常是 WebSocket 没配好。

如果你用 Nginx 反代，记得加上：

• Upgrade
• Connection "upgrade"

否则面板和 Gateway 的 WebSocket 通信可能会失败。

4）从外网访问不到#

重点检查这几项：

• 服务器防火墙
• 云服务器安全组
• 端口 1420
• 如果 Gateway 也要外部访问，再看 18789