内置 AI 助手的 OpenClaw 管理面板 — 一键安装、配置、诊断、修复
ClawPanel 是 OpenClaw AI Agent 框架的可视化管理面板。内置智能 AI 助手，帮你一键安装 OpenClaw、自动诊断配置、排查问题、修复错误。8 大工具 + 4 种模式 + 交互式问答，从新手到老手都能轻松管理。
🌐 官网: claw.qt.cool | 📦 下载: GitHub Releases
一群对 AI Agent 充满热情的开发者和玩家，欢迎加入交流。
 QQ 群 |
 微信群 |
 抖音群 |
 飞书群 |
Discord · 元宝派 · Discussions · 反馈 Issue · 飞书群
前往 Releases 页面下载最新版本，根据你的系统选择对应安装包：
| 芯片 | 安装包 | 说明 |
|---|---|---|
| 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
| 格式 | 安装包 | 说明 |
|---|---|---|
| EXE 安装器 | ClawPanel_x.x.x_x64-setup.exe |
推荐，双击安装 |
| MSI 安装器 | ClawPanel_x.x.x_x64_en-US.msi |
企业部署 / 静默安装 |
| 格式 | 安装包 | 说明 |
|---|---|---|
| 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 |
没有桌面环境？一键部署 ClawPanel Web 版，通过浏览器远程管理 OpenClaw：
curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash部署完成后访问 http://服务器IP:1420，功能与桌面版一致。
📖 详细教程见 Linux 部署指南
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 反向代理等）
- 🤖 AI 助手（全新·重磅） — 内置独立 AI 助手，4 种操作模式 + 8 大工具 + 交互式问答，详见下方 AI 助手亮点
- 🖼️ 图片识别 — 粘贴截图或拖拽图片，AI 自动识别分析，支持多模态图文混排对话
- 仪表盘 — 系统概览，服务状态实时监控，快捷操作
- 服务管理 — OpenClaw 启停控制、版本检测与一键升级、Gateway 安装/卸载、配置备份与还原
- 模型配置 — 多服务商管理、模型增删改查、批量连通性测试、延迟检测、拖拽排序、自动保存+撤销
- 网关配置 — 端口、运行模式（本地/云端）、访问权限（本机/局域网）、认证 Token、Tailscale 组网
- 消息渠道 — 统一管理 Telegram、Discord 等外部消息接入，内置 QQ 机器人配置与凭证校验
- Agent 管理 — Agent 增删改查、身份编辑、模型配置、工作区管理
- 聊天 — 流式响应、Markdown 渲染、会话管理、Agent 选择、快捷指令
- 日志查看 — 多日志源实时查看与关键词搜索
- 记忆管理 — 记忆文件查看/编辑、分类管理、ZIP 导出、Agent 切换
- 扩展工具 — cftunnel 内网穿透管理、ClawApp 状态监控
- 关于 — 版本信息、社群入口、相关项目链接、一键升级
🤖 AI 助手 — 8 大技能卡片，一键触发配置检查、Gateway 诊断、环境检测、一键排障等常用操作
仪表盘 — Gateway / 隧道 / 服务实时状态，版本信息、Agent 数量、模型池一屏掌握
⚙️ AI 设置 — 独立模型配置 + 公益 AI 接口一键接入，GPT-5 全系列免费可用
� 借尸还魂 — 从 OpenClaw Agent 加载灵魂（SOUL / IDENTITY / USER / AGENTS / TOOLS），继承人格与记忆
实时聊天 — WebSocket 流式对话，多 Provider 模型自动聚合，支持多模态
模型配置 — 多服务商统一管理，公益接口一键添加全部模型，主模型+备选自动切换
记忆文件 — 工作记忆、记忆归档、核心文件在线编辑，多 Agent 记忆隔离
查看更多截图
Agent 管理 — 多 Agent 创建、身份配置与独立工作区管理
Gateway — Token / 密码双认证，Agent 工具权限三档管控，会话可见性控制
服务管理 — 启停控制、版本检测、一键升级、npm 源切换、配置备份
安全设置 — 访问密码保护与无视风险模式
扩展工具 — cftunnel 内网穿透、ClawApp 移动客户端一键安装
系统诊断 — 全面健康检测、WebSocket 测试、一键修复配对
关于 — 版本信息、社群入口（QQ / 微信 / 抖音）、相关项目链接
ClawPanel 内置的 AI 助手不只是聊天机器人——它能直接操作你的系统，帮你诊断、修复、甚至提交 PR。
一键切换，界面颜色随模式变化，清晰感知当前权限状态：
| 模式 | 图标 | 工具 | 写文件 | 确认 | 适用场景 |
|---|---|---|---|---|---|
| 聊天 | 💬 | ❌ | ❌ | — | 纯问答，不触碰系统 |
| 规划 | 📋 | ✅ | ❌ | ✅ | 读配置/查日志，输出方案不动文件 |
| 执行 | ⚡ | ✅ | ✅ | ✅ | 正常干活，危险操作弹确认 |
| 无限 | ∞ | ✅ | ✅ | ❌ | 全自动，工具调用不弹窗 |
设置中还有工具开关（终端/文件），优先级高于模式——关掉终端，即使无限模式也调不了命令。
| 工具 | 功能 | 示例 |
|---|---|---|
ask_user |
向用户提问（单选/多选/文本） | "选择要提交到哪个仓库？" |
get_system_info |
获取 OS、架构、主目录 | 自动判断该用 PowerShell 还是 Bash |
run_command |
执行 Shell 命令 | 重启 Gateway、查看日志 |
read_file |
读取文件 | 读取 openclaw.json 分析配置 |
write_file |
写入文件 | 修复配置错误、生成脚本 |
list_directory |
浏览目录 | 列出 .openclaw/ 结构 |
list_processes |
查看进程 | 检查 Gateway 是否在运行 |
check_port |
检测端口占用 | 18789 端口被谁占了？ |
AI 可以通过 ask_user 工具向你提问，支持三种交互方式：
- 单选 — 从多个方案中选一个，还能输入自定义答案
- 多选 — 勾选多项，比如"选择要检查的组件"
- 文本 — 自由输入，比如"描述你遇到的问题"
AI 等你回答后才会继续操作，实现真正的人机协作。
发现 Bug？AI 不只是告诉你怎么修——它直接帮你修：
- 🐛 提交 Bug 报告 — AI 自动收集系统环境、读取错误日志，按标准模板整理成 GitHub Issue，你复制粘贴就能提交
- 🔀 PR 助手 — AI 分析 Bug 根因 → 定位代码 → 生成修复方案 → 通过
run_command执行 git 命令完成 Fork/Branch/Commit/Push，用户只需点确认
欢迎页提供一键触发的常用技能：
| 技能 | 功能 |
|---|---|
| 🔧 检查配置 | 读取并分析 openclaw.json |
| 🏥 诊断 Gateway | 检查进程、端口、日志 |
| 📂 浏览目录 | 查看 .openclaw 目录结构 |
| 💻 检查环境 | Node.js、npm 版本检测 |
| 📋 分析日志 | 搜索 ERROR/WARN 关键词 |
| 🔨 一键排障 | 自动检测并修复常见问题 |
| 🐛 提交 Bug | 整理 Issue 提交到 GitHub |
| 🔀 PR 助手 | 定位 Bug 并生成修复 PR |
| 层级 | 技术 | 说明 |
|---|---|---|
| 前端 | Vanilla JS + Vite | 零框架依赖，轻量快速 |
| 后端 | Rust + Tauri v2 | 原生性能，跨平台打包 |
| 通信 | Tauri IPC + Shell Plugin | 前后端桥接，本地命令执行 |
| 样式 | 纯 CSS（CSS Variables） | 暗色/亮色主题，玻璃拟态风格 |
clawpanel/
├── src/ # 前
6366
源码
│ ├── 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# 启动完整 Tauri 桌面应用
./scripts/dev.sh
# 仅启动 Vite 前端（浏览器调试，使用 mock 数据）
./scripts/dev.sh web# 启动完整 Tauri 桌面应用
npm run tauri dev
# 仅启动 Vite 前端（浏览器调试，使用 mock 数据）
npm run dev# 编译 debug 版本
./scripts/build.sh
# 仅检查 Rust 编译（最快，不生成产物）
./scripts/build.sh check
# 编译正式发布版本（含打包）
./scripts/build.sh release# 检查 Rust 编译
cd src-tauri && cargo check
# 编译正式发布版本
npm run tauri build
# 指定打包格式（NSIS 安装器）
npm run tauri build -- --bundles nsis产物位于 src-tauri/target/release/ 目录。
安装完成后，按以下步骤即可开始使用：
首次启动 ClawPanel 会自动进入初始设置页面，引导你完成环境检测：
- ✅ Node.js — 自动检测，未安装时提供一键安装
- ✅ Git — 自动检测并配置 HTTPS 模式（解决 SSH 不通问题）
- ✅ OpenClaw — 一键安装，可选汉化版或原版
所有步骤均有绿色勾标记，全部通过后点击「前往模型配置」。
进入模型配置页面，添加至少一个 AI 服务商：
| 服务商 | 获取 API Key |
|---|---|
| DeepSeek | platform.deepseek.com |
| OpenAI | platform.openai.com |
| 阿里通义 | dashscope.console.aliyun.com |
| Ollama（本地） | 免费，无需 Key，安装后自动检测 |
填入 Base URL 和 API Key，点击「测试连接」确认可用，然后保存。
前往服务管理页面，点击「启动」按钮启动 Gateway。状态变为绿色即可。
Gateway 是 OpenClaw 的核心服务，负责处理 AI 对话请求。
前往实时聊天页面，选择模型后即可开始对话。支持流式输出、Markdown 渲染、多模态图片识别。
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 版默认监听所有网卡。请务必：
- 设置访问密码 — 首次登录会提示修改默认密码，或在「安全设置」页面配置
- 防火墙限制 — 仅开放 1420 端口给可信 IP
- Nginx 反向代理 + HTTPS — 生产环境强烈建议使用 HTTPS
Nginx 反向代理配置示例
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 存储在服务器的
~/.openclaw/openclaw.json中，不会传输到外部 - 建议为
~/.openclaw/目录设置chmod 700权限 - 多人共用时，每人应使用独立的 OpenClaw 实例
ClawPanel 支持将 AI 接入多种即时通讯平台，在「消息渠道」页面统一管理。
| 平台 | 类型 | 配置难度 | 说明 |
|---|---|---|---|
| 飞书 / Lark | 企业内部应用 | ⭐⭐ | 支持内置插件和官方插件两种模式 |
| 钉钉 | 企业内部应用 | ⭐⭐ | Stream 模式，需创建机器人应用 |
| Telegram | Bot | ⭐ | 通过 @BotFather 创建 Bot |
| Discord | Bot | ⭐⭐ | 需创建 Application + Bot |
| QQ 机器人 | 官方 Bot | ⭐⭐⭐ | 需在 QQ 开放平台注册 |
- 在飞书开放平台创建企业自建应用，开启机器人能力
- 获取
App ID和App Secret - 在 ClawPanel「消息渠道」页面选择飞书，填入凭证
- 点击「校验」确认连接，然后「保存」
- Gateway 会自动重载，飞书机器人即刻可用
- 消息渠道需要 Gateway 正在运行才能接收消息
- 每个平台需要配对审批才能连接（在渠道设置中完成）
- 飞书/钉钉需要在对应平台发布应用版本后，机器人才对其他人可见
没有苹果开发者签名，macOS Gatekeeper 会拦截。终端执行：
sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app或前往「系统设置 → 隐私与安全性」点击「仍要打开」。
从 Finder/Dock 启动 ClawPanel 时，应用的 PATH 环境变量可能不包含 Node.js 安装路径。
v0.4.1 已修复：自动补充 /usr/local/bin、/opt/homebrew/bin、~/.nvm、~/.volta 等常见路径。
临时解决：从终端启动 ClawPanel：
open /Applications/ClawPanel.app通常是文件权限或 npm 缓存问题：
- 以管理员身份运行 ClawPanel
- 或打开 PowerShell（管理员）手动安装：
npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com
- 如果仍报错，清理 npm 缓存：
npm cache clean --force
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 模式。
文件被其他进程锁定。先关闭 ClawPanel 和所有 Node.js 进程，以管理员身份打开 PowerShell 重装：
npm cache clean --force
npm install -g @qingchencloud/openclaw-zh --registry https://registry.npmmirror.com安装 Node.js 后需要重启 ClawPanel，新的 PATH 环境变量才能生效。
如果安装在非默认路径（如 D:\nodejs、F:\AI\Node），请确认该目录已加入系统 PATH 环境变量。v0.4.2+ 已自动扫描常见安装路径。
常见原因和解决方案：
| 症状 | 原因 | 解决 |
|---|---|---|
| 端口 18789 被占用 | 另一个 Gateway 进程残留 | 终端执行 pkill -f openclaw 后重启 |
| 配置文件损坏 | openclaw.json 格式错误 | 前往「服务管理」→「从备份恢复」 |
| 反复崩溃 | API Key 或模型配置异常 | 用 AI 助手「🔨 一键排障」自动诊断 |
| 提示 "auth mode" 错误 | 认证配置不兼容 | 在「安全设置」重置 Gateway 认证 |
如果仍无法解决，查看「日志查看」页面的 Gateway 日志获取详细错误信息。
- 检查 API Key — 确认 Key 未过期、余额充足
- 检查 Base URL — 不同服务商 URL 格式不同，注意结尾不要多
/v1（ClawPanel 会自动处理） - 网络问题 — 国内访问 OpenAI 需要代理；DeepSeek / 阿里通义 / Ollama 国内直连
- Ollama 特殊处理 — URL 填
http://127.0.0.1:11434（不加/v1，ClawPanel 自动补全）
- 确认 Gateway 正在运行（顶部状态栏显示绿色）
- 反向代理需要配置 WebSocket 支持（参见上方 Nginx 配置）
- 如果使用 HTTPS，WebSocket 需要
wss://协议（v0.7.3+ 已自动适配） - 清除浏览器缓存后刷新页面
升级到 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- 确认 Gateway 正在运行
- 飞书/钉钉：需要在对应开放平台发布应用版本
- 飞书：私聊测试需在「工作台」搜索机器人名称；群聊需通过「群设置 → 智能群助手」添加
- 钉钉：消息接收模式必须选择 Stream 模式
| 项目 | 说明 |
|---|---|
| OpenClaw | AI Agent 框架 |
| ClawApp | 跨平台移动聊天客户端 |
| cftunnel | Cloudflare Tunnel 内网穿透工具 |
感谢以下赞助商对 ClawPanel 项目的支持：
慈云数据服务团队于 2020 年成立，专注于基础云计算、游戏云、主题站长等业务 售前售后服务 24 小时在线值班，强力保证为客户提供优质稳定的网络资源与机房服务 |
欢迎提交 Issue 和 Pull Request。贡献流程详见 CONTRIBUTING.md。