ClawMonitor（OpenClaw监控）

当用户提出以下问题时使用此技能：

- “我的代理完成了吗？为什么没有反馈？”
“哪个会话/线程收到了最后一条消息，以及何时收到的？”
“代理正在运行、被中断还是卡住了？有没有投递失败？”
“哪个模型出了问题，是提供商的问题还是OpenClaw本身的问题？”
“最近哪个会话消耗的令牌最多？”
“我们有没有僵尸/辅助进程或脏的网关cgroup？”

前置条件

- 此技能在具有 ~/.openclaw/ 下OpenClaw状态的机器上运行。
同一台机器上安装了 clawmonitor。

预检（推荐）

在使用以下命令之前，验证二进制文件存在并能读取本地OpenClaw状态：

bash
clawmonitor --version
clawmonitor init --non-interactive || true
clawmonitor status --format md

如果 clawmonitor 缺失，或 status 失败，请先安装它。

安装：

bash
pip install -U clawmonitor

其他安装方式：

- pipx：

bash
pipx install clawmonitor

- 虚拟环境：

bash
python3 -m venv .venv
. .venv/bin/activate
pip install -U pip
pip install clawmonitor

注意：

- 某些OpenClaw环境有意禁止在运行时安装包。如果安装被阻止，请要求用户先在主机上安装 clawmonitor。
clawmonitor init 在 ~/.config/clawmonitor/config.toml 下写入配置，可以安全地重新运行。

核心命令

0）树状视图（谁拥有哪些会话）

如果您怀疑ACP/子代理路由问题（例如Telegram线程绑定），请从以下命令开始：

bash
clawmonitor tree

1）状态（Markdown格式）

显示核心状态表：

bash
clawmonitor status --format md

要获取包含任务/消息预览的更详细表格：

bash
clawmonitor status --format md --detail

2）模型健康检查

直接和/或通过OpenClaw探测配置的模型：

bash
clawmonitor models --format md

有用的变体：

bash
clawmonitor models --mode direct --format json
clawmonitor models --mode openclaw --timeout 20

3）深入分析单个会话

为单个会话密钥导出经过编辑的报告：

bash
clawmonitor report --session-key agent:main:main --format md

4）提示（要求会话报告进度）

向会话发送进度请求：

bash
clawmonitor nudge --session-key agent:main:main --template progress

5）用于交互式检查的完整TUI

当需要交互式分类时运行TUI：

bash
clawmonitor tui

重要的TUI按键：

- v：循环切换会话 / 模型 / 系统
s：直接跳转到系统
h：切换右侧状态 / 历史记录
u：循环切换令牌窗口（now / 1d / 7d / 30d）
r：刷新当前活动界面
z：循环切换面板宽度
Z：全屏详情
o：在系统视图中打开英文操作员说明

快速故障排除

- 如果 clawmonitor status 显示 DELIVERYFAILED 或 NOFEEDBACK，接下来导出报告：

bash
clawmonitor report --session-key agent:main:main --format md

- 如果模型检查不一致，请将直接提供商路径与 OpenClaw路径分开。
如果Telegram看起来绑定到了错误的会话密钥，运行 clawmonitor tree 并跟随绑定的会话，而不是假设 agent:main:... 是活动路径。
如果问题是服务级别的，使用TUI的系统视图，并总结风险、可回收内存估计以及是否检测到僵尸/孤儿进程。
如果TUI不可用，回退到 clawmonitor status --format md --detail 加上 clawmonitor models --format md。

回复指南

- 对于即时消息回复，优先使用 --format md 输出。
如果状态显示 DELIVERYFAILED 或 NOFEEDBACK，包含相关的sessionKey并建议下一步导出 report。
如果令牌问题有时间窗口限制，请说明数字是当前会话快照还是 1d / 7d / 30d 的网关使用范围。
除非用户要求，否则避免粘贴原始网关日志；使用 clawmonitor report，它会编辑常见的秘密信息。

claw-monitor爪监控器

claw-monitor

ClawMonitor (OpenClaw monitoring)

Preconditions

Preflight (recommended)

Core commands

0) Tree view (who owns which sessions)

1) Status (Markdown)

2) Model health

3) Drill down on one session

4) Nudge (ask the session to report progress)

5) Full TUI for interactive inspection

Troubleshooting quick wins

Reply guidelines

ClawMonitor（OpenClaw监控）

前置条件

预检（推荐）