openclaw/docs/cli/status.md

---
summary: "CLI reference for `openclaw status` (diagnostics, probes, usage snapshots)"
read_when:
  - You want a quick diagnosis of channel health + recent session recipients
  - You want a pasteable “all” status for debugging
title: "status"
---

# `openclaw status`

Diagnostics for channels + sessions.

```bash
openclaw status
openclaw status --all
openclaw status --deep
openclaw status --usage
```

Notes:

- `--deep` runs live probes (WhatsApp Web + Telegram + Discord + Google Chat + Slack + Signal).
- Output includes per-agent session stores when multiple agents are configured.
- Overview includes Gateway + node host service install/runtime status when available.
- Overview includes update channel + git SHA (for source checkouts).
- Update info surfaces in the Overview; if an update is available, status prints a hint to run `openclaw update` (see [Updating](/install/updating)).
- Read-only status surfaces (`status`, `status --json`, `status --all`) resolve supported SecretRefs for their targeted config paths when possible.
- If a supported channel SecretRef is configured but unavailable in the current command path, status stays read-only and reports degraded output instead of crashing. Human output shows warnings such as “configured token unavailable in this command path”, and JSON output includes `secretDiagnostics`.
docs(cli): add per-command CLI pages 2026-01-15 06:12:54 +00:00			`---`
refactor: rename to openclaw 2026-01-30 03:15:10 +01:00			summary: "CLI reference for `openclaw status` (diagnostics, probes, usage snapshots)"
docs(cli): add per-command CLI pages 2026-01-15 06:12:54 +00:00			`read_when:`
			`- You want a quick diagnosis of channel health + recent session recipients`
			`- You want a pasteable “all” status for debugging`
Docs: add nav titles across docs (#5689) 2026-01-31 16:04:03 -05:00			`title: "status"`
docs(cli): add per-command CLI pages 2026-01-15 06:12:54 +00:00			`---`

refactor: rename to openclaw 2026-01-30 03:15:10 +01:00			# `openclaw status`
docs(cli): add per-command CLI pages 2026-01-15 06:12:54 +00:00
			`Diagnostics for channels + sessions.`

			```bash
refactor: rename to openclaw 2026-01-30 03:15:10 +01:00			`openclaw status`
			`openclaw status --all`
			`openclaw status --deep`
			`openclaw status --usage`
docs(cli): add per-command CLI pages 2026-01-15 06:12:54 +00:00			```

docs: update health/status + doctor docs 2026-01-17 01:14:17 +00:00			`Notes:`
chore: Run `pnpm format:fix`. 2026-01-31 21:13:13 +09:00
feat: add beta googlechat channel 2026-01-23 16:45:37 -06:00			- `--deep` runs live probes (WhatsApp Web + Telegram + Discord + Google Chat + Slack + Signal).
docs: update health/status + doctor docs 2026-01-17 01:14:17 +00:00			`- Output includes per-agent session stores when multiple agents are configured.`
docs: update node CLI references 2026-01-21 16:48:31 +00:00			`- Overview includes Gateway + node host service install/runtime status when available.`
feat: add update channel status Co-authored-by: Richard Poelderl <18185649+p6l-richard@users.noreply.github.com> 2026-01-20 14:05:55 +00:00			`- Overview includes update channel + git SHA (for source checkouts).`
refactor: rename to openclaw 2026-01-30 03:15:10 +01:00			- Update info surfaces in the Overview; if an update is available, status prints a hint to run `openclaw update` (see [Updating](/install/updating)).
CLI: make read-only SecretRef status flows degrade safely (#37023) * CLI: add read-only SecretRef inspection * CLI: fix read-only SecretRef status regressions * CLI: preserve read-only SecretRef status fallbacks * Docs: document read-only channel inspection hook * CLI: preserve audit coverage for read-only SecretRefs * CLI: fix read-only status account selection * CLI: fix targeted gateway fallback analysis * CLI: fix Slack HTTP read-only inspection * CLI: align audit credential status checks * CLI: restore Telegram read-only fallback semantics 2026-03-05 23:07:13 -06:00			- Read-only status surfaces (`status`, `status --json`, `status --all`) resolve supported SecretRefs for their targeted config paths when possible.
			- If a supported channel SecretRef is configured but unavailable in the current command path, status stays read-only and reports degraded output instead of crashing. Human output shows warnings such as “configured token unavailable in this command path”, and JSON output includes `secretDiagnostics`.