CLI commands
Health
openclaw health
Fetch health from the running Gateway.
Options
| Flag | Default | Description |
|---|---|---|
--json |
false |
Print machine-readable JSON instead of text. |
--timeout <ms> |
10000 |
Connection timeout in milliseconds. |
--verbose |
false |
Verbose logging. Forces a live probe and expands per-agent output. |
--debug |
false |
Alias for --verbose. |
Examples:
openclaw healthopenclaw health --jsonopenclaw health --timeout 2500openclaw health --verboseopenclaw health --debugNotes:
- Default
openclaw healthasks the running gateway for its health snapshot. When the gateway already has a fresh cached snapshot, it can return that cached payload and refresh in the background. --verboseforces a live probe, prints gateway connection details, and expands the human-readable output across all configured accounts and agents.- Output includes per-agent session stores when multiple agents are configured.
Related
Was this useful?
