Task Monitor

核心用法

Task Monitor 是专为 OpenClaw 设计的实时 Web 监控仪表盘，提供会话状态、Discord 连接、子代理和定时任务的可视化监控。用户通过 start-server.sh 启动 Node.js 服务（默认 3030 端口），即可在浏览器或移动设备访问响应式界面。同时提供 /api/status JSON API 供第三方集成。

显著优点

1. 性能优化出色：30秒 TTL 内存缓存 + 预加载 + 后台刷新策略，缓存命中时响应<100ms，较无缓存版本提升约 365 倍
2. 移动端优先：纯 HTML/CSS/JS 实现，无重型框架，手机平板体验流畅
3. 架构简洁：基于 Express + 原生前端，依赖少，部署简单
4. 实时性保障：客户端 60 秒轮询 + 服务端智能缓存，平衡实时性与性能

潜在缺点与局限性

• 冷启动延迟：首次请求或缓存过期时仍需~15秒（阻塞 OpenClaw CLI 调用）
• 非推送到时：轮询架构而非 WebSocket，数据延迟最高达 60 秒
• 局域网限制：默认仅绑定本地网络，无内置认证，公网暴露需额外安全措施
• 单节点缓存：内存缓存无法跨实例共享，不适合多副本部署
• 版本早期：v0.1.0 功能基础，Markdown 生成已标记为 legacy

适合人群

• OpenClaw 多会话/多代理用户，需要统一监控面板
• 移动端优先的运维场景（手机随时查看状态）
• 本地/局域网环境部署，追求轻量不依赖外部服务

常规风险

• 端口 3030 若暴露公网且无认证，可能泄露会话信息（建议防火墙限制或加反向代理）
• CLI 调用阻塞风险已通过缓存缓解，但极端并发仍可能触发冷缓存路径
• 依赖 openclaw 命令行工具，若后者不稳定则监控数据异常

核心用法

Task Monitor 是一款专为 OpenClaw 设计的本地 Web 监控仪表板，通过简洁的命令即可启动服务：

./scripts/start-server.sh  # 启动 3030 端口服务
./scripts/stop-server.sh   # 停止服务

启动后通过 http://localhost:3030 或局域网 IP 访问响应式 Web 界面，同时提供 JSON API (/api/status) 供第三方集成。还支持 legacy markdown 生成模式，每 5 分钟自动更新 DASHBOARD.md。

---

显著优点

1. 极致性能优化：采用 30 秒 TTL 内存缓存 + stale-while-revalidate 模式，缓存命中响应 <100ms，较无缓存时 15 秒提升 365 倍
2. 零外部依赖：仅依赖 Express 4.22.1，无外部 API 调用，杜绝数据外泄风险
3. 移动优先设计：纯 HTML/CSS/JS 实现，无重型框架，手机端体验流畅
4. 功能完备：覆盖主会话、Discord 集成、子代理、定时任务四维监控
5. 部署零门槛：Node.js 单文件服务，无需数据库或复杂配置

---

潜在缺点与局限性

| 方面 | 说明 |

|------|------|

| 网络暴露 | 默认绑定 0.0.0.0，局域网可访问，需用户自行评估网络环境 |

| 无认证机制 | 当前版本无访问控制，公共网络部署存在风险 |

| 命令执行依赖 | 依赖本地 `openclaw` CLI，若未安装或版本不兼容则功能失效 |

| 单实例设计 | 无集群或多节点支持，大规模部署需自行扩展 |

| 缓存粒度 | 30 秒 TTL 在极高频场景下可能存在数据延迟 |

---

适合人群

• 个人开发者：需要随时查看 OpenClaw 会话状态的独立用户
• 小团队协作：局域网内共享监控视图，无需复杂权限体系
• IoT/边缘设备：资源受限环境，拒绝 Docker/K8s 重量级方案

---

常规风险

• RISK-001（低风险）：child_process.exec 执行硬编码 openclaw 命令，无用户输入拼接，已设 10 秒超时
• RISK-002（低风险）：读取 ~/.openclaw/agents/main/sessions/ 及写入 DASHBOARD.md，路径拼接已做防护
• RISK-003（提示级）：0.0.0.0 绑定属设计预期，建议文档补充 LAN 安全说明

---

安全认证摘要

• 综合评分：78/100（A 级）
• 静态分析：85 分 ✓ 无动态代码执行风险
• 动态分析：80 分 ✓ 仅本地文件系统操作
• 依赖审计：90 分 ✓ Express 4.22.1 无 CVE
• 网络分析：85 分 ✓ 零外部 API
• 威胁情报：70 分 ✓ OpenClaw Community 可信来源