> ## Documentation Index
> Fetch the complete documentation index at: https://zju-a00451d9-feat-personal-agent-team.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# health

# `velaclaw health`

Fetch health from the running Gateway.

Options:

* `--json`: machine-readable output
* `--timeout <ms>`: connection timeout in milliseconds (default `10000`)
* `--verbose`: verbose logging
* `--debug`: alias for `--verbose`

Examples:

```bash theme={null}
velaclaw health
velaclaw health --json
velaclaw health --timeout 2500
velaclaw health --verbose
velaclaw health --debug
```

Notes:

* Default `velaclaw health` asks 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.
* `--verbose` forces 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.