名称： task-monitor
描述： 用于 OpenClaw 会话和后台任务的实时 Web 仪表板。支持移动端响应式布局与自动刷新。
版本： 0.1.0

Task Monitor v0.1

用于 OpenClaw 的实时监控仪表板，提供 Web 界面。

功能特性

• 🌐 Web 仪表板 - 美观、响应式的 UI，可从任何设备访问
• 📱 移动端优先 - 针对手机和平板电脑优化
• 🔄 自动刷新 - 每 60 秒更新一次
• 🎨 现代设计 - 采用渐变 UI 和深色主题
• 📊 实时数据 - 主会话、Discord、子代理、定时任务状态
• 🚀 快速 API - 提供 JSON 端点，并配备智能缓存（30 秒 TTL）
• ⚡ 高性能 - 缓存命中时响应时间 <100ms，冷缓存时约 15 秒

安装

cd skills/task-monitor
npm install

使用方法

启动 Web 服务器

./scripts/start-server.sh

服务器将在 3030 端口运行（局域网内可访问）。

访问地址：
- 本地：http://localhost:3030
- 局域网：http://<你的IP>:3030

停止服务器

./scripts/stop-server.sh

API 端点

curl http://localhost:3030/api/status

返回包含以下内容的 JSON：
- 主会话统计信息
- Discord 会话统计信息
- 活跃的子代理（含描述）
- 最近的定时任务历史记录

生成 Markdown 文档（v0.1）

旧版 Markdown 生成器仍可用：

./scripts/generate-dashboard.js

该命令会更新工作区根目录下的 DASHBOARD.md 文件。

自动化

定时任务（CRON）每 5 分钟运行一次，以更新 Markdown 仪表板：
*/5 * * * * -> 执行 generate-dashboard.js

架构设计

• 后端： Node.js + Express
• 前端： 纯 HTML/CSS/JS（无框架）
• 数据源： openclaw sessions list --json + openclaw cron list --json
• 缓存： 内存缓存，TTL 为 30 秒
• 服务器启动时预加载
• 缓存过期时在后台异步刷新
• 采用“过期但可复用”模式以优化用户体验
• 刷新： 客户端轮询（间隔 60 秒）

性能表现

无缓存时：
- API 响应时间：约 15 秒（阻塞式）
- 问题：每个请求都会阻塞 Node.js 事件循环

有缓存时：
- 缓存命中：<100ms（约快 365 倍）
- 缓存未命中：约 15 秒（仅首次请求）
- 过期缓存：<100ms（同时在后台刷新）
- 缓存 TTL：30 秒

缓存系统确保：
- 绝大多数请求获得极速响应
- 不会阻塞并发请求
- 缓存过期时能优雅降级