核心用法
long-task-monitor 是专为 OpenClaw 平台设计的长任务监控解决方案（V2），采用经典的 Worker-Monitor 分布式架构。该方案通过三个核心组件协同工作：Worker 负责执行实际的长任务（如模型训练、大规模数据处理）；Monitor 通过 hook-logger 插件实时追踪 Worker 日志状态；主会话则通过轮询机制接收 Monitor 每 10 分钟一次的汇报。
使用流程遵循标准六步：创建任务 → 启动 Worker → 更新 Worker Session Key → 启动 Monitor → 更新 Monitor Session Key → 任务完成后手动清理。所有任务元数据持久化存储于 ~/.openclaw/workspace/long-tasks/<task-id>/ 目录，便于状态追踪与故障排查。
显著优点
架构清晰：Worker-Monitor 分离设计符合云原生监控最佳实践，职责边界明确，便于独立扩展与故障隔离。
规避平台限制：巧妙利用主会话轮询绕过 OpenClaw 子代理 sessions_send 限制，在现有约束下实现可靠的双向通信。
状态可观测：hook-logger 集成提供分钟级粒度日志监控，支持 Worker 完成检测、异常挂起识别（5 分钟无日志判定）。
智能轮询策略：前 5 轮自动续期，6 轮后转人工确认，平衡自动化与资源消耗。
潜在缺点与局限性
运维复杂度：Session Key 需手动更新，无法自动获取，增加了操作流程的繁琐性。
延迟敏感：Worker 完成到 Monitor 上报存在最长 10 分钟延迟，实时性不足。
已知缺陷：complete 命令存在 ReferenceError 漏洞，需手动清理 sessions，生产环境风险较高。
版本锁定：依赖 OpenClaw 2.21+ 及特定 hook-logger 版本，兼容性受限。
适合人群
- OpenClaw 重度用户，需运行耗时 >10 分钟的模型训练、数据 ETL 任务
- 具备 Node.js 基础、能接受命令行运维的开发者
- 对任务可观测性有要求的 MLOps 工程师
常规风险
Session 泄漏：complete 命令 bug 可能导致 Worker/Monitor 会话残留，需手动介入清理。
状态不一致：手动更新 Session Key 流程易出错，可能导致 Monitor 无法关联 Worker。
资源占用：长时间轮询 Monitor 持续占用子代理配额，多任务并行时需注意配额规划。