ClawPanel
集中安装、配置、诊断和运营 OpenClaw 与 Hermes 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 中的声明多为断言，未区分事实和推断。扣分原因：声明缺乏可追溯性，跨来源佐证有限，事实与推断未明确分离。
- API 密钥存储和传输方式未明确，建议审查 openclaw.json 的权限和加密。
- 依赖未锁定版本，Docker 安装使用 npm install 可能引入供应链风险。
- 未提供回滚机制，升级失败时可能无法恢复。
- 媒体生成工具虽强制确认，但其他工具（如 shell）的确认机制未说明。
这个 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 有哪些优点和局限？
- 同时覆盖 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？
桌面源码构建需要 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 助手中使用“规划”模式检查配置和日志，或在“执行”模式确认后运行诊断与修复操作。