diff --git a/docs/channels/troubleshooting.md b/docs/channels/troubleshooting.md index 9c492774ba0..aeb69299afb 100644 --- a/docs/channels/troubleshooting.md +++ b/docs/channels/troubleshooting.md @@ -26,7 +26,7 @@ Healthy baseline: - `Runtime: running` - `RPC probe: ok` -- Channel probe shows connected/ready +- Channel probe shows transport connected and, where supported, `works` or `audit ok` ## WhatsApp diff --git a/docs/cli/channels.md b/docs/cli/channels.md index 0fa90364528..440cee73b99 100644 --- a/docs/cli/channels.md +++ b/docs/cli/channels.md @@ -33,6 +33,12 @@ openclaw channels logs --channel all - `channels resolve`: ``, `--channel `, `--account `, `--kind `, `--json` - `channels logs`: `--channel `, `--lines `, `--json` +`channels status --probe` is the live path: on a reachable gateway it runs per-account +`probeAccount` and optional `auditAccount` checks, so output can include transport +state plus probe results such as `works`, `probe failed`, `audit ok`, or `audit failed`. +If the gateway is unreachable, `channels status` falls back to config-only summaries +instead of live probe output. + ## Add / remove accounts ```bash diff --git a/docs/cli/index.md b/docs/cli/index.md index 3441fee0005..85bddcf8824 100644 --- a/docs/cli/index.md +++ b/docs/cli/index.md @@ -669,7 +669,7 @@ Manage chat channel accounts (WhatsApp/Telegram/Discord/Google Chat/Slack/Matter Subcommands: - `channels list`: show configured channels and auth profiles. -- `channels status`: check gateway reachability and channel health (`--probe` runs extra checks; use `openclaw health` or `openclaw status --deep` for gateway health probes). +- `channels status`: check gateway reachability and channel health (`--probe` runs live per-account probe/audit checks when the gateway is reachable; if not, it falls back to config-only channel summaries. Use `openclaw health` or `openclaw status --deep` for broader gateway health probes). - Tip: `channels status` prints warnings with suggested fixes when it can detect common misconfigurations (then points you to `openclaw doctor`). - `channels logs`: show recent channel logs from the gateway log file. - `channels add`: wizard-style setup when no flags are passed; flags switch to non-interactive mode. @@ -733,6 +733,7 @@ Notes: - `channels login` supports `--verbose`. - `channels capabilities --account` only applies when `--channel` is set. +- `channels status --probe` can show transport state plus probe/audit results such as `works`, `probe failed`, `audit ok`, or `audit failed`, depending on channel support. More detail: [/concepts/oauth](/concepts/oauth) diff --git a/docs/gateway/index.md b/docs/gateway/index.md index 9b9049b6089..098ef4fd4cf 100644 --- a/docs/gateway/index.md +++ b/docs/gateway/index.md @@ -57,6 +57,10 @@ Healthy baseline: `Runtime: running` and `RPC probe: ok`. openclaw channels status --probe ``` +With a reachable gateway this runs live per-account channel probes and optional audits. +If the gateway is unreachable, the CLI falls back to config-only channel summaries instead +of live probe output. + diff --git a/docs/gateway/troubleshooting.md b/docs/gateway/troubleshooting.md index c27ff142d14..83c67d247f6 100644 --- a/docs/gateway/troubleshooting.md +++ b/docs/gateway/troubleshooting.md @@ -27,7 +27,8 @@ Expected healthy signals: - `openclaw gateway status` shows `Runtime: running` and `RPC probe: ok`. - `openclaw doctor` reports no blocking config/service issues. -- `openclaw channels status --probe` shows connected/ready channels. +- `openclaw channels status --probe` shows live per-account transport status and, + where supported, probe/audit results such as `works` or `audit ok`. ## Anthropic 429 extra usage required for long context diff --git a/docs/help/troubleshooting.md b/docs/help/troubleshooting.md index 330d2d8ae93..81591c8f6e8 100644 --- a/docs/help/troubleshooting.md +++ b/docs/help/troubleshooting.md @@ -31,7 +31,9 @@ Good output in one line: - `openclaw gateway probe` → expected gateway target is reachable (`Reachable: yes`). `RPC: limited - missing scope: operator.read` is degraded diagnostics, not a connect failure. - `openclaw gateway status` → `Runtime: running` and `RPC probe: ok`. - `openclaw doctor` → no blocking config/service errors. -- `openclaw channels status --probe` → channels report `connected` or `ready`. +- `openclaw channels status --probe` → reachable gateway returns live per-account + transport state plus probe/audit results such as `works` or `audit ok`; if the + gateway is unreachable, the command falls back to config-only summaries. - `openclaw logs --follow` → steady activity, no repeating fatal errors. ## Anthropic long context 429 @@ -101,7 +103,7 @@ flowchart TD - `Runtime: running` - `RPC probe: ok` - - Your channel shows connected/ready in `channels status --probe` + - Your channel shows transport connected and, where supported, `works` or `audit ok` in `channels status --probe` - Sender appears approved (or DM policy is open/allowlist) Common log signatures: