<img src="public/images/logo-brand.png" width="360" alt="ClawPanel"> 内置 AI 助手的 OpenClaw 管理面板 — 一键安装、配置、诊断、修复 🇨🇳 中文 | <a href="README.en.md">🇺🇸 English</a> <a href="https://github.com/qingchencloud/clawpanel/releases/latest"> <img src="https://img.shields.io/github/v/release/qingchencloud/clawpanel?style=flat-square&color=6366f1" alt="Release"> </a> <a href="https://github.com/qingchencloud/clawpanel/releases/latest"> <img src="https://img.shields.io/github/downloads/qingchencloud/clawpanel/total?style=flat-square&color=8b5cf6" alt="Downloads"> </a> <a href="https://github.com/qingchencloud/clawpanel/blob/main/LICENSE"> <img src="https://img.shields.io/badge/license-AGPL--3.0-blue.svg?style=flat-square" alt="License"> </a> <a href="https://github.com/qingchencloud/clawpanel/actions/workflows/ci.yml"> <img src="https://img.shields.io/github/actions/workflow/status/qingchencloud/clawpanel/ci.yml?style=flat-square&label=CI" alt="CI"> </a>

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

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

⚡ OpenClaw 独立安装包（零依赖，无需 Node.js/npm）

不想折腾 Node.js 环境？直接下载 OpenClaw 独立安装包，内置运行时，解压即用：

Windows: 下载 .exe 安装向导，双击即装
macOS / Linux / 树莓派: curl -fsSL https://dl.qrj.ai/openclaw/install.sh | bash
全平台: GitHub Releases

ClawPanel 安装 OpenClaw 时会自动优先使用独立安装包，无需手动操作。此方案仅供不使用 ClawPanel 的用户独立安装。

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

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

<table align="center"> <tr> <td align="center"> <a href="https://qt.cool/c/OpenClaw"><img src="docs/qr-qq.png" width="140" alt="QQ 群二维码"></a> <a href="https://qt.cool/c/OpenClaw">QQ 群</a> </td> <td align="center"> <a href="https://qt.cool/c/OpenClawWx"><img src="docs/qr-wechat.png" width="140" alt="微信群二维码"></a> <a href="https://qt.cool/c/OpenClawWx">微信群</a> </td> <td align="center"> <a href="https://qt.cool/c/OpenClawDY"><img src="docs/qr-dy.png" width="140" alt="抖音群二维码"></a> <a href="https://qt.cool/c/OpenClawDY">抖音群</a> </td> <td align="center"> <a href="https://qt.cool/c/feishu"><img src="https://qt.cool/c/feishu/qr.png" width="140" alt="飞书群二维码"></a> <a href="https://qt.cool/c/feishu">飞书群</a> </td> </tr> </table> <a href="https://discord.gg/U9AttmsNHh">Discord</a>  ·  <a href="https://yb.tencent.com/gp/i/LsvIw7mdR7Lb">元宝派</a>  ·  <a href="https://github.com/qingchencloud/clawpanel/discussions">Discussions</a>  ·  <a href="https://github.com/qingchencloud/clawpanel/issues/new">反馈 Issue</a>  ·  <a href="https://qt.cool/c/feishu">飞书群</a>

下载安装

前往 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 反向代理等）

功能特性

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

功能截图

<img src="docs/quick-stats.gif" width="800" alt="ClawPanel 数据概览"> <img src="docs/01.png" width="800" alt="AI 助手"> 🤖 AI 助手 — 8 大技能卡片，一键触发配置检查、Gateway 诊断、环境检测、一键排障等常用操作 <img src="docs/00.png" width="800" alt="仪表盘"> 仪表盘 — Gateway / 隧道 / 服务实时状态，版本信息、Agent 数量、模型池一屏掌握 <img src="docs/02.png" width="800" alt="AI 助手设置 — 公益 AI 接口"> ⚙️ AI 设置 — 独立模型配置 + 公益 AI 接口一键接入，GPT-5 全系列免费可用 <img src="docs/05.png" width="800" alt="AI 助手人设 — Agent 灵魂"> � 借尸还魂 — 从 OpenClaw Agent 加载灵魂（SOUL / IDENTITY / USER / AGENTS / TOOLS），继承人格与记忆 <img src="docs/07.png" width="800" alt="实时聊天"> 实时聊天 — WebSocket 流式对话，多 Provider 模型自动聚合，支持多模态 <img src="docs/09.png" width="800" alt="模型配置"> 模型配置 — 多服务商统一管理，公益接口一键添加全部模型，主模型+备选自动切换 <img src="docs/13.png" width="800" alt="记忆文件"> 记忆文件 — 工作记忆、记忆归档、核心文件在线编辑，多 Agent 记忆隔离 <details> <summary>查看更多截图</summary> <img src="docs/10.png" width="800" alt="Agent 管理"> Agent 管理 — 多 Agent 创建、身份配置与独立工作区管理 <img src="docs/11.png" width="800" alt="Gateway 安全认证"> Gateway — Token / 密码双认证，Agent 工具权限三档管控，会话可见性控制 <img src="docs/03.png" width="800" alt="服务管理"> 服务管理 — 启停控制、版本检测、一键升级、npm 源切换、配置备份 <img src="docs/12.png" width="800" alt="安全设置"> 安全设置 — 访问密码保护与无视风险模式 <img src="docs/14.png" width="800" alt="扩展工具"> 扩展工具 — cftunnel 内网穿透、ClawApp 移动客户端一键安装 <img src="docs/15.png" width="800" alt="系统诊断"> 系统诊断 — 全面健康检测、WebSocket 测试、一键修复配对 <img src="docs/16.png" width="800" alt="关于"> 关于 — 版本信息、社群入口（QQ / 微信 / 抖音）、相关项目链接 </details>

🤖 AI 助手亮点

ClawPanel 内置的 AI 助手不只是聊天机器人——它能直接操作你的系统，帮你诊断、修复、甚至提交 PR。

四种操作模式

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

| 模式 | 图标 | 工具 | 写文件 | 确认 | 适用场景 | |------|------|------|--------|------|---------| | 聊天 | 💬 | ❌ | ❌ | — | 纯问答，不触碰系统 | | 规划 | 📋 | ✅ | ❌ | ✅ | 读配置/查日志，输出方案不动文件 | | 执行 | ⚡ | ✅ | ✅ | ✅ | 正常干活，危险操作弹确认 | | 无限 | ∞ | ✅ | ✅ | ❌ | 全自动，工具调用不弹窗 |

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

八大工具

| 工具 | 功能 | 示例 | |------|------|------| | ask_user | 向用户提问（单选/多选/文本） | "选择要提交到哪个仓库？" | | get_system_info | 获取 OS、架构、主目录 | 自动判断该用 PowerShell 还是 Bash | | run_command | 执行 Shell 命令 | 重启 Gateway、查看日志 | | read_file | 读取文件 | 读取 openclaw.json 分析配置 | | write_file | 写入文件 | 修复配置

Clawpanel

Install / Use

README