1. 项目概述
Clawd Control 是一个实时仪表板应用，为 Clawdbot AI agents 提供集中监控与管理界面。它让用户通过单屏视图即可掌握整个 AI agent 集群的运行状态、健康指标和关键 metrics，充当 agents 的 mission control 中心。该项目与 Clawdbot 紧密集成，Clawdbot 是运行 AI agents 的基础平台，而 Clawd Control 则专注于其上层的可视化管理层。两者可协同工作，也可独立部署使用。
项目档案应用项目
Clawd Control 实时仪表板：监控管理 Clawdbot AI agents 的完整指南与安装教程
Clawd Control 是专为 Clawdbot AI agents 设计的实时监控与管理仪表板。本文提供完整的项目介绍，包括核心功能（fleet 概览、agent 详情、自动发现等）、安装部署步骤、操作使用指南、技术架构解析以及配置安全说明，帮助您快速掌握这一集中管理 AI agent 集群的 mission control 工具。
AI 总结
Clawd Control 是专为 Clawdbot AI agents 设计的实时监控与管理仪表板，提供单屏 fleet 概览、agent 详情深度查看、自动发现及主机资源监控功能，帮助用户集中管理 AI agent 集群，提升运维效率。
中文项目介绍
Clawd Control 是一个实时仪表板应用程序，专为监控和管理 Clawdbot AI agents 而设计。它解决了当用户运行多个 AI agents 时难以统一查看状态、健康指标及进行集中管理的痛点，提供了 mission control 式的操作界面。
该项目适用于需要集中管理多个 Clawdbot AI agents 的任何场景，无论是本地开发环境还是生产部署。用户可以通过单屏视图快速了解整个 agent 集群的健康状况，并深入查看每个 agent 的会话、频道和详细配置。
从技术实现上看，Clawd Control 采用纯 Node.js 后端与原生前端设计，无构建步骤、无框架依赖，保持了极简架构。核心服务器通过 SSE（Server-Sent Events）实现实时数据推送，支持自动发现本地网络中的 agents，并提供基于会话的密码认证。前端使用原生 HTML/JavaScript，通过共享布局模块实现 SPA 导航和主题切换，同时支持键盘快捷键操作。项目仅依赖 ws 库进行 WebSocket 通信，要求 Node.js 18+ 环境，配置简单，适合快速部署和使用。
详细信息与使用说明
2. 核心功能
Clawd Control 提供丰富的管理功能：实时监控通过 SSE 推送 agents 的最新状态、健康和指标数据；fleet 概览以健康指示器形式展示所有 agents；agent 详情视图允许深入查看特定 agent 的会话、频道和配置；agent 创建向导引导用户完成新 agent 的配置；主机指标监控显示 CPU、RAM、磁盘使用情况；自动发现功能可扫描本地网络中的 Clawdbot agents；SPA 导航实现无刷新页面切换；支持明暗主题切换（快捷键 T 或跟随系统）；基于会话的密码认证保障访问安全；键盘快捷键（B、T、?）提升操作效率。
3. 安装部署
安装 Clawd Control 需要 Node.js 18+ 环境和已安装的 Clawdbot agents。具体步骤：首先克隆仓库到本地（git clone https://github.com/Temaki-AI/clawd-control.git），进入项目目录（cd clawd-control），运行 npm install 安装唯一依赖 ws 库，然后执行 npm start 启动服务。服务默认监听 3100 端口，可通过 --port 和 --bind 参数自定义。首次运行时会生成随机密码并输出到控制台，同时保存至 auth.json。若需修改密码，可直接编辑 auth.json 文件。
4. 操作使用
启动后，在浏览器访问 http://localhost:3100 即可使用。首次登录需使用控制台显示的随机密码。主界面提供 fleet 概览，点击任意 agent 可进入详情页查看会话、频道等深度信息。通过创建向导可添加新 agents。若自动发现未找到远程或自定义端口的 agents，需手动配置：复制 agents.example.json 为 agents.json，按 JSON 格式填写 agents 列表，包括 id、host、port、token、workspace 等参数。界面支持键盘快捷键：B 切换侧边栏，T 切换主题，? 显示帮助。
5. 技术架构
Clawd Control 采用极简架构设计，单一 Node.js 服务器（server.mjs）处理 HTTP 请求、SSE 连接、认证和 API 代理，无构建步骤。前端为原生 HTML/JavaScript，通过 layout.js 共享布局模块实现一致界面。后台数据收集由 collector.mjs 负责定期轮询 agents 状态；discover.mjs 实现本地 agents 自动发现；create-agent.mjs 处理 agent 创建逻辑。安全功能集中在 security-lib/ 目录，提供认证、速率限制、安全头等。所有模块协同工作，通过 agents.json 和 auth.json 进行配置管理，确保系统灵活且易于维护。
6. 配置与安全
项目配置主要通过两个 JSON 文件管理：agents.json 定义 monitored agents 列表及轮询间隔；auth.json 设置访问密码和会话有效期。首次运行时会自动生成 auth.json 含随机密码。安全方面，server.mjs 实现了请求体大小限制、速率限制（security-lib/rate-limit.js）和安全 HTTP 头（security-lib/security-headers.js），并包含审计日志（security-lib/audit-log.js）和凭证检查（security-lib/checks/credentials.js）等机制。所有配置更改需重启服务生效，系统默认绑定 0.0.0.0，生产环境建议使用反向代理并绑定本地地址以增强安全性。
思维导图
Clawd Control
核心功能
实时监控
Fleet概览
Agent详情
创建向导
主机指标
自动发现
技术架构
Node.js服务器
原生前端
SSE推送
模块化设计
配置管理
agents.json
auth.json
端口绑定
轮询间隔
安全机制
会话认证
速率限制
安全头
审计日志
使用流程
安装依赖
启动服务
浏览器访问
配置agents
快捷键操作
常见问题
是否需要预先安装 Clawdbot？
是的。Clawd Control 是专为 Clawdbot agents 设计的仪表板，必须先在系统中安装并运行 Clawdbot agents 才能使用本工具进行监控管理。
能否监控远程主机上的 agents？
可以。通过编辑 agents.json 文件，手动添加远程 agents 的 host、port 和 token 信息即可。自动发现功能仅适用于本地网络，远程 agents 需手动配置。
项目与 Temaki.ai 有什么关系？
Clawd Control 是独立的开源项目，与 Temaki.ai 无直接代码关联。但两者可协同使用：Clawd Control 作为 agent 运维仪表板，Temaki.ai 作为人类与 AI agents 协作的工作空间。
如何自定义界面主题？
支持明暗主题切换。用户可按键盘 T 键切换，或跟随系统偏好自动调整。主题逻辑由 layout.js 管理，无需额外配置。