task-monitor

📊 OpenClaw 实时会话监控中心

🥥32总安装量 8评分人数 7
100% 的用户推荐

OpenClaw 官方生态的实时监控仪表板,提供 Web 界面和 API 端点追踪会话、子代理及定时任务状态,助力开发者高效掌握系统运行全貌。

B

存在边界风险,建议在隔离环境中验证

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 代码完全开源透明,无混淆或隐藏行为,与声明功能一致
  • ✅ 依赖极简,仅使用 Express 4.22.1 成熟框架,无已知风险依赖项
  • ✅ 文件系统访问严格限定在用户目录,采用标准路径拼接防止遍历攻击
  • ⚠️ 无身份验证机制,默认绑定 0.0.0.0,局域网内任意设备可访问 Dashboard
  • ⚠️ 仅提供 HTTP 服务,无 HTTPS 加密,传输数据存在被窃听风险

使用说明

核心用法

Task Monitor 是专为 OpenClaw 生态系统打造的实时监控仪表板,通过 Web 界面和 REST API 提供系统状态的可视化呈现。用户执行 ./scripts/start-server.sh 即可在 3030 端口启动服务,随后通过浏览器访问 http://localhost:3030 或局域网 IP 查看实时数据。核心功能包括:主会话状态追踪、Discord 会话监控、活跃子代理列表展示,以及定时任务历史记录。系统采用客户端轮询机制(60 秒间隔)实现自动刷新,同时提供 curl http://localhost:3030/api/status 的纯 JSON 接口供程序化调用。

技术实现上,该 Skill 通过调用 openclaw sessions list --jsonopenclaw cron list --json 命令获取原始数据,经解析后通过 Express 服务器对外提供。内置双层缓存机制(30 秒 TTL 会话缓存 + 5 分钟定时任务缓存)确保 API 响应时间低于 100 毫秒,相比无缓存时的 15 秒阻塞式响应提升约 365 倍性能。此外,系统保留向后兼容的 Markdown 生成能力,每 5 分钟通过 CRON 任务自动更新 DASHBOARD.md 文件。

显著优点

极简依赖架构:仅依赖 Express 4.22.1 单一生产依赖,无前端框架负担,纯 HTML/CSS/JS 实现,大幅降低维护复杂度和供应链攻击面。性能优化出色:Stale-while-revalidate 缓存模式兼顾响应速度与数据新鲜度,预加载机制确保首屏体验,异步后台刷新避免阻塞用户请求。移动优先设计:响应式布局适配手机和平板,渐变暗色主题符合开发者审美偏好。生态深度整合:作为 OpenClaw 官方社区项目,与 CLI 工具链无缝衔接,数据源自系统原生输出,准确性和实时性有保障。

潜在缺点与局限性

安全机制缺失:无身份验证、无 HTTPS、默认绑定 0.0.0.0 导致局域网内任意设备可访问,存在信息泄露风险。功能边界有限:纯只读监控,不支持远程控制或配置修改;数据可视化能力基础,无图表组件,仅列表和文本展示。扩展性约束:硬编码的 3030 端口和 60 秒轮询间隔无法通过配置调整;缓存 TTL 固定,未开放自定义接口。单点故障风险:依赖本地 openclaw CLI 可用性,若主程序异常则监控数据中断;无持久化存储,重启后历史数据丢失。

适合的目标群体

OpenClaw 重度用户:需要同时管理多个会话、子代理和定时任务的开发者,可通过单一界面掌握全局状态。小型团队协作:局域网内共享监控视图,快速定位阻塞任务或异常会话,提升调试效率。运维和 DevOps 人员:利用 API 端点集成到现有监控体系,或配合 CRON 生成的 Markdown 文档进行离线审计。教育和技术演示场景:简洁的架构设计适合作为 Node.js 服务端开发、缓存策略实现的参考案例。

使用风险

网络暴露风险:默认配置下服务监听所有网络接口,公共 Wi-Fi 或企业内网环境中可能被未授权访问,建议通过防火墙限制 3030 端口或修改绑定地址为 127.0.0.1。性能与资源消耗:虽然缓存机制优化了响应速度,但每 30 秒执行 openclaw 命令仍会产生周期性负载,大规模部署时需评估对主系统的影响。数据准确性延迟:缓存策略导致数据最大滞后 30 秒,对实时性要求极高的场景(如金融交易监控)不适用。版本兼容性:紧密耦合 OpenClaw CLI 输出格式,若主程序升级变更 JSON 结构可能导致解析失败。

task-monitor 内容

文件夹图标scripts文件夹
手动下载zip · 14.3 kB
generate-dashboard.jstext/javascript
请选择文件