ClawPanel
集中安装、配置、诊断和运营 OpenClaw 与 Hermes Agent 的跨平台管理面板。
- Star 数
- ★ 2.9k
- 最近更新
- 16 天前
- License
- NOASSERTION
- 主语言
- JavaScript
- FA 评分
- 42/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 运行 OpenClaw 的个人开发者,可用服务管理页面检查 Gateway、端口和日志,并恢复配置备份。
- 不适合
- 需要独立通用 Agent 运行时的用户
- 不愿加固公网 Web 部署的团队
- 要求 macOS 应用已签名的组织
这个 Agent 能做什么,适合哪些场景?
ClawPanel 是面向 OpenClaw 和 Hermes Agent 的可视化管理面板,提供桌面应用和无图形界面的 Web 部署模式。桌面端采用 Vanilla JS、Vite、Rust 和 Tauri v2;Web 模式通过 scripts/dev-api.js 调用本机 OpenClaw CLI。它涵盖服务启停、模型与网关配置、消息渠道、Agent、记忆、日志、定时任务和用量查看,并提供流式聊天与图片识别。内置 AI 助手有聊天、规划、执行和无限四种模式,可在可配置的终端与文件权限下协助诊断和修改。适合需要在本机、桌面系统或 Linux 服务器上运营这两套 Agent 引擎的团队和个人。
面板可启动或停止 OpenClaw / Hermes Gateway,检测版本并执行升级,维护模型服务商、Base URL 和 API Key,测试连通性与延迟,并配置端口、访问范围、认证 Token 和 Tailscale。聊天界面提供 WebSocket 流式响应、Markdown 渲染和多模态图片输入;Hermes 页面可查看会话、消息流、长期记忆和工具调用细节。AI 助手通过 ask_user、get_system_info、run_command、read_file、write_file、list_directory、list_processes、check_port 八项工具读取系统与配置、执行 Shell 命令、检查端口和进程,并可按模式要求确认后写入文件。Web 生产版以 npm run build 后的 npm run serve 运行,默认监听 0.0.0.0:1420。
- 运行 OpenClaw 的个人开发者,可用服务管理页面检查 Gateway、端口和日志,并恢复配置备份。
- 需要同时试用 Hermes Agent 与 OpenClaw 的运营者,可在同一面板中切换双引擎并分别管理。
- 将 Agent 部署在 ARM64 开发板或无桌面 Linux 服务器的管理员,可通过 Web 模式在浏览器中远程管理。
- 维护多个模型服务商的用户,可录入 API Key 和 Base URL,批量测试连通性并设置主模型及备选模型。
- 把 Agent 接入 Telegram、Discord、飞书、钉钉或 QQ 的管理员,可在消息渠道页面配置连接并绑定多个 Agent。
如何安装或部署这个 Agent?
桌面源码构建需要 Node.js 18+、Rust stable 和 Tauri v2 系统依赖:
git clone https://github.com/qingchencloud/clawpanel.git
cd clawpanel
npm installmacOS/Linux 运行 ./scripts/dev.sh;Windows 运行 npm run tauri dev。
Linux 服务器 Web 部署可运行:
curl -fsSL https://raw.githubusercontent.com/qingchencloud/clawpanel/main/scripts/linux-deploy.sh | bash部署后访问 http://服务器IP:1420。Docker 方案和 ARM64 Web 部署也在仓库中提供。
如何使用这个 Agent?
首次启动时完成 Node.js、Git 和 OpenClaw 的环境检查及安装。进入“模型配置”,添加服务商的 Base URL 和 API Key,点击“测试连接”后保存;例如可选择 OpenAI 服务商,或配置 OpenAI Compatible 服务商。随后在“服务管理”启动 Gateway,状态变绿后进入“实时聊天”选择模型发送消息。需要排障时,在 AI 助手中使用“规划”模式检查配置和日志,或在“执行”模式确认后运行诊断与修复操作。
这个 Agent 有哪些优点和局限?
- 同时覆盖 OpenClaw 和 Hermes Agent,避免分别使用两套管理界面。
- 桌面 Tauri v2 应用与 Node.js Web 服务两种交付方式,Web 模式明确支持无 GUI 的 Linux、Docker 和 ARM64 场景。
- AI 助手把系统信息、文件、目录、进程、端口和 Shell 操作整合为八项明确工具,并提供四级操作模式与确认机制。
- 模型管理、Gateway 控制、日志、记忆、渠道、定时任务和用量可在同一产品内操作。
- 核心能力依赖 OpenClaw 或 Hermes Agent;面板不是独立的通用 Agent 运行时。
- Web 模式默认监听所有网卡,文档要求设置访问密码、防火墙限制和 HTTPS 反向代理,公网部署需要额外安全运维。
- 模型调用需要用户自行提供服务商 API Key;可用性、余额与网络连接会影响连接测试和对话。
- 桌面源码构建还需要 Rust、Tauri v2 系统依赖和 Git;运行 Gateway 的 Node.js 版本须满足当前 OpenClaw 要求。
- 许可证信息存在证据不一致:仓库元数据标为 NOASSERTION,而 README 声称采用 AGPL-3.0。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| ClawPanel 当前 | 42 · 缺口较多 | 桌面应用免费 | ★ 2.9k | 16 天前 | JavaScript | OpenAI API |
| HermesClaw | 53 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 758 | 17 天前 | Python | — |
| TraceRoot | 42 · 缺口较多 | 云服务 / SaaS免费版 + 付费版 | ★ 1.3k | 今天 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| Hermes 控制台 | 35 · 缺口较多 | 自托管服务免费 | ★ 901 | 4 个月前 | JavaScript | — |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示:README 提到 AI 助手有 8 个工具和 4 种模式,测试文件显示媒体生成工具(generate_image, create_video_task)被标记为 DANGEROUS_TOOLS 并强制确认,且不受 confirmDanger 开关影响,这体现了用户确认机制。但缺少对权限最小化的系统描述,如 Tauri 权限配置未展示。数据流透明度不足,未说明 API 密钥如何存储和传输。敏感数据处理仅提及 API Key 存储在本地 openclaw.json,但未说明加密措施。依赖安全方面,package.json 列出了依赖但未提供漏洞扫描或锁定文件证据。外部影响方面,README 提到一键安装脚本和 Docker 命令,但未说明其安全审查。回滚机制未提及。来源归属方面,README 和 LICENSE 明确了版权和商标,但未提供贡献者指南的详细内容。扣分原因:权限最小化、数据流透明度、敏感数据处理、依赖安全、外部影响、回滚均缺乏充分证据。
证据显示:README 功能列表与测试文件覆盖的渠道(Telegram, WhatsApp, ClickClack, Nextcloud Talk, Twitch, Nostr, IRC)一致,自洽性较好。依赖可用性方面,package.json 列出了依赖,但未提供锁文件或版本锁定证据,且 Docker 安装命令使用 npm install 而非 npm ci,可能引入不确定性。失败消息方面,测试文件中的诊断函数(buildOpenClawChannelDiagnosis)会检查凭证并返回错误详情,但未展示用户界面如何呈现这些错误。扣分原因:依赖可用性缺乏锁定证据,失败消息仅存在于测试中,未在文档中说明。
证据显示:README 面向初学者和专家,提供了桌面和 Web 版本,支持多种平台(Windows, macOS, Linux)和嵌入式设备(Orange Pi, Raspberry Pi),场景覆盖较广。能力边界方面,README 列出了功能列表,但未明确说明 AI 助手的具体能力边界和限制。触发精度方面,测试文件显示媒体工具默认关闭,需显式开启,但未说明其他工具的触发条件。环境适配方面,README 提供了 Node.js 版本要求(18+,推荐 22.19.0+)和 Docker 部署方式,但未说明对 Tauri 环境的详细要求。扣分原因:能力边界和触发精度描述不足。
证据显示:README 结构清晰,包含功能、安装、构建、相关项目等章节,信息架构良好。安装说明详细,提供了下载中心、Docker、源码构建等多种方式。命名稳定性方面,项目名称和版本号在 package.json 中明确,但未提供命名规范文档。示例和 FAQ 方面,README 提供了快速入门步骤,但未提供 FAQ 或常见问题解答。已知限制方面,README 未明确列出已知限制。许可证方面,LICENSE 文件包含 AGPL-3.0 和附加条款,但 package.json 中 license 字段为 AGPL-3.0,而 README 徽章显示 AGPL-3.0,一致。版本和变更日志方面,package.json 有版本号,但未提供 CHANGELOG 文件。维护责任方面,README 提供了联系方式和支持邮箱,但未明确维护者身份。扣分原因:缺少 FAQ、已知限制、CHANGELOG 和明确的维护者信息。
证据显示:输出可用性方面,README 描述了丰富的功能,但未提供实际输出示例或截图(除了展示图)。边际价值方面,项目提供了多引擎管理和 AI 助手,具有差异化价值。成本效益方面,项目是开源的,但未提供性能或资源占用数据。扣分原因:输出可用性缺乏具体示例,成本效益缺乏数据支持。
证据显示:README 中的功能声明与测试文件部分对应,但未提供可追溯的链接或证据。跨来源佐证方面,README 和测试文件相互印证,但缺乏第三方验证。事实与推断分离方面,README 中的声明多为断言,未区分事实和推断。扣分原因:声明缺乏可追溯性,跨来源佐证有限,事实与推断未明确分离。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- API 密钥存储和传输方式未明确,建议审查 openclaw.json 的权限和加密。
- 依赖未锁定版本,Docker 安装使用 npm install 可能引入供应链风险。
- 未提供回滚机制,升级失败时可能无法恢复。
- 媒体生成工具虽强制确认,但其他工具(如 shell)的确认机制未说明。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.22.5 ClawPanel v0.22.5
发布说明摘录
升级提示 - Windows 桌面端请下载安装新的 EXE 或 MSI(轻量包或含 WebView2 的完整包均可)。本次包含 Rust 后端修复,只更新前端不能应用后台终端弹窗修复。 - Web 部署请使用完整 web-0.22.5.zip 更新并重启 Node 服务,不要只复制 dist。 - Telegram 二维码为本地图片;扫码、点击二维码和加入按钮均使用同一群邀请。桌面点击交给既有系统浏览器能力,Web 点击开新标签。 - 本版不改变内核推荐版本,不合入尚未完成验收的 Hermes 升级候选。 --- ✅ 全部平台构建成功 📥 下载安装 根据你的操作系统选择对应安装包,点击文件名即可下载: macOS | 芯片 | 安装包 | |------|--------| | Apple Silicon (M1/M2/M3/M4) | [ClawPanel_0.22.5_aarch64.dmg](https://github.com/qingchencloud/clawpanel/releases/download/v0.22.5/ClawPanel_0.22.5_aarch64.dmg) | …在 GitHub 查看 ↗ -
v0.22.4 ClawPanel v0.22.4
发布说明摘录
本版验证范围与已知限制 本版发布已合入主线的修复,不自动升级用户已安装的内核。提交 49d3893f832ab2d8795bab20155cf772762ba3f4 的 [三平台核心 CI](https://github.com/qingchencloud/clawpanel/actions/runs/39009068501) 已通过;产物构建通过不等于所有功能完成全平台端到端验收。 - Hermes:推荐版本仍为 0.21.5;隔离候选 0.22.2 未纳入本次推荐升级。Windows 冷启动与新旧版本的完整原生生命周期验收仍在进行。 - 微信渠道:本版包含已合入的宿主兼容识别修复;一键安装能力确认及 Windows 原生界面完整验收尚未完成。Issue #342、#345 保持开放,不宣称全部问题已解决。 - 发布门禁范围:本次为维护者明确要求先发布现有主线;最终同提交的五内核运行容器、发行 Docker 和三平台维护控制器组合门禁尚未跑齐,不将历史或跳过结果计作通过。日常自动发布的原验收要求保持不变。 --- ✅ 全部平台构建成功 📥 下载安装 根据你的操作系统选择对应安装包,点击文件名即可下载: macOS | 芯片 | 安装包 | |------|--------| …在 GitHub 查看 ↗ -
v0.22.3 ClawPanel v0.22.3
发布说明摘录
✅ 全部平台构建成功 📥 下载安装 根据你的操作系统选择对应安装包,点击文件名即可下载: macOS | 芯片 | 安装包 | |------|--------| | Apple Silicon (M1/M2/M3/M4) | [ClawPanel_0.22.3_aarch64.dmg](https://github.com/qingchencloud/clawpanel/releases/download/v0.22.3/ClawPanel_0.22.3_aarch64.dmg) | | Intel | [ClawPanel_0.22.3_x64.dmg](https://github.com/qingchencloud/clawpanel/releases/download/v0.22.3/ClawPanel_0.22.3_x64.dmg) | > ⚠️ 首次打开提示"无法验证开发者"? 在终端执行:sudo xattr -rd com.apple.quarantine /Applications/ClawPanel.app,或前往 系统设置 → 隐私与安全性 点击「仍要打开」。 Windows | 格式 | 安装包 | 说明 | |------|--------|------| …在 GitHub 查看 ↗