Claw Monitor

使用 `clawmonitor` CLI 监控 OpenClaw 会话(最新对话消息、锁状态、投递失败、Telegram 线程路由)。

安装

概览

{ “overview_html”: “Claw Monitor 是一个专为 OpenClaw 会话设计的命令行监控工具,旨在帮助开发者和管理员实时掌握代理会话的运行状态。它通过读取本地 OpenClaw 的状态文件(位于 `~/.openclaw/`),提供对会话活动、消息投递情况和线程绑定的透明化洞察。该工具特别适用于排查会话中断、无反馈响应或消息未送达等常见问题,是运维和调试场景中的实用助手。Claw Monitor 支持多种输出格式,包括简洁的 Markdown 表格和交互式终端界面,确保在不同环境下都能高效使用。其设计注重轻量化和安全性,避免直接暴露敏感信息,适合在团队协作或远程支持中安全共享状态摘要。”, “feature_items”: [ “实时监控 OpenClaw 会话的最新消息与锁状态”, “支持查看投递失败详情及错误日志(自动脱敏)”, “提供 Telegram 线程路由绑定关系的可视化树状图”, “可通过命令行发送 nudging 请求触发会话进度报告”, “内置 TUI 交互界面,支持会话筛选、刷新与手动干预”, “生成带时间戳的详细会话报告,便于问题回溯” ], “scenarios_html”: “Claw Monitor 最适用于需要快速诊断 OpenClaw 代理会话异常的场景。例如,当用户询问‘我的代理任务是否完成?’或‘为什么没有收到反馈?’时,管理员可直接运行 `clawmonitor status` 获取当前所有活跃会话的状态概览,快速定位卡住或无响应的会话。若发现某条消息显示 `DELIVERY_FAILED`,可通过 `report` 命令导出该会话的脱敏日志,分析具体失败原因,而无需手动翻阅原始网关日志。此外,在多代理或多线程环境中,ACP 子代理的路由绑定可能出错,导致消息被发送到错误的 Telegram 线程。此时,使用 `clawmonitor tree` 可清晰展示各会话与线程的对应关系,辅助进行正确的会话切换与监控。对于长期运行的自动化流程,TUI 模式提供了持续可视化的监控面板,支持快捷键操作如刷新、切换视图或手动 nudging,极大提升运维效率。” }