Cli 导读

一眼看穿所有通道状态,不用挨个查

`openclaw status` 是诊断通道和会话的入口,直接跑就能看到各通道是否在线、配额还剩多少。最该先试 `--deep` 做一次真实探活,别只看缓存状态。注意配额显示:MiniMax 的原始字段是剩余量,OpenClaw 已帮你反转成“已用百分比”,但优先以 count 类字段为准。

先讲这一页到底在解决什么

一眼看穿所有通道状态,不用挨个查

`openclaw status` 是诊断通道和会话的入口,直接跑就能看到各通道是否在线、配额还剩多少。最该先试 `--deep` 做一次真实探活,别只看缓存状态。注意配额显示:MiniMax 的原始字段是剩余量,OpenClaw 已帮你反转成“已用百分比”,但优先以 count 类字段为准。

原文共 2 节,先看 Start Here 路径:/cli/status 查看官方原文

第一站

👀 四条最常用命令,其实就是四档看诊力度

官方只给了四个例子,但这四个已经够你记住主线了。

1

openclaw status

像先看一眼基础体检单,够快,适合第一反应。

2

openclaw status --all

像把完整表格摊开,连诊断备注也一起看。

3

openclaw status --deep

像不只看纸面数据,还现场再做几项活体探测。

4

openclaw status --usage

像单独盯着“今天到底花了多少、用了多少”的账单角落看。

第二站

🏥 这张总状态单到底会看什么

它不是只看一个地方,而是在给整栋楼做巡检。

📮 channels

像看每一扇消息门还通不通,有没有哪扇门今天卡住了。

🗂 sessions

像看每个工位抽屉是不是都还在,最近有没有人在里面活动。

🏭 Gateway / node host

像看机房和值班小工人是不是都还在线。

🆕 update info / git SHA

像顺手看看这台机器是不是已经落后几个版本了,别把“老版本怪脾气”误会成新 bug。

第三站

🔦 --deep 真正多做了什么?就是从“看表”变成“现场敲门”

这就是为什么它更慢,但更值钱。

WhatsApp / Telegram / Discord ... probes

像不只是看值班名单,而是真的走到门口敲一敲,看里面有没有回应。

多 agent 会话仓库

像把每个工位的抽屉仓库都打开看一下,不只盯主桌。

Gateway + node host runtime

像把“楼还在不在”和“外派小工人还在不在”一起核一遍。

🎈 一句话

--deep 的味道是:别只看纸面,要去现场摸门把手。

第四站

🔐 SecretRef 那一大段,其实是在说“票没拿到时,也别把体检台掀翻”

这页官方写得挺成熟:哪怕某些密钥今天在这个命令路径里拿不到,`status` 也尽量继续给你一张可读的报告,而不是直接崩掉。

🪪 能拿到票就正常查

如果 SecretRef 现在能解出来,`status` 就按正常完整路径看。

⚠️ 拿不到票就降级报告

像门卫说“这几间房我今天没拿到钥匙”,但整张体检表不会因此撕掉。

status --all 会多写诊断摘要

像医生在报告最后再加一段:哪些钥匙今天没拿到,所以哪些检查只能看到半层。

📌 一句话

这条命令优先“把情况说清楚”,而不是“因为一把钥匙没到就当场翻桌”。

第五站

🧭 真正实用的看法是:先 status,再决定要不要去 logsdoctor

这页最像排障入口,不是排障终点。

status

先拿总貌,别乱猜。

status --all

需要分享给别人看时,把完整报告摊开。

status --deep

怀疑是现场活体问题时,再去敲门。

logs / doctor

要看监控就去 logs,要让修理工出手就去 doctor。

最后总结

🎈 把 openclaw status 这页压成一句话

openclaw status 就是 OpenClaw 的总状态体检单:先看一眼,再展开,再深探测,然后决定要不要继续去日志或修理工那边追。

如果你下一页只想继续看一页,我建议看 /cli/doctor。因为看完体检单以后,下一步最自然就是叫修理工。