@@ -45,6 +45,8 @@ openclaw doctor --deep
|
45 | 45 | openclaw doctor --fix |
46 | 46 | openclaw doctor --fix --non-interactive |
47 | 47 | openclaw doctor --generate-gateway-token |
| 48 | +openclaw doctor --post-upgrade |
| 49 | +openclaw doctor --post-upgrade --json |
48 | 50 | ``` |
49 | 51 | |
50 | 52 | For channel-specific permissions, use the channel probes instead of `doctor`: |
@@ -68,7 +70,8 @@ The targeted Discord capabilities probe reports the bot's effective channel perm
|
68 | 70 | - `--allow-exec`: allow doctor to execute configured exec SecretRefs while verifying secrets |
69 | 71 | - `--deep`: scan system services for extra gateway installs and report recent Gateway supervisor restart handoffs |
70 | 72 | - `--lint`: run modernized health checks in read-only mode and emit diagnostic findings |
71 | | -- `--json`: with `--lint`, emit JSON findings instead of human output |
| 73 | +- `--post-upgrade`: run post-upgrade plugin compatibility probes; emits findings to stdout; exits with code 1 if any error-level findings are present |
| 74 | +- `--json`: with `--lint`, emit JSON findings instead of human output; with `--post-upgrade`, emit a machine-readable JSON envelope (`{ probesRun, findings }`) |
72 | 75 | - `--severity-min <level>`: with `--lint`, drop findings below `info`, `warning`, or `error` |
73 | 76 | - `--skip <id>`: with `--lint`, skip a check id; repeat to skip more than one |
74 | 77 | - `--only <id>`: with `--lint`, run only a check id; repeat to run a small selected set |
@@ -188,6 +191,14 @@ id is not registered, no check runs for that id; use the command's `checksRun`
|
188 | 191 | and `checksSkipped` fields to verify a focused gate is selecting the checks you |
189 | 192 | expect. |
190 | 193 | |
| 194 | +## Post-upgrade mode |
| 195 | + |
| 196 | +`openclaw doctor --post-upgrade` runs plugin compatibility probes intended to be |
| 197 | +chained after a build or upgrade. Findings are emitted to stdout; the command |
| 198 | +exits with code 1 if any finding has `level: "error"`. Add `--json` to receive a |
| 199 | +machine-readable envelope (`{ probesRun, findings }`) suitable for CI, the |
| 200 | +community `fork-upgrade` skill, and other post-upgrade smoke tooling. |
| 201 | + |
191 | 202 | Notes: |
192 | 203 | |
193 | 204 | - In Nix mode (`OPENCLAW_NIX_MODE=1`), read-only doctor checks still work, but `doctor --fix`, `doctor --repair`, `doctor --yes`, and `doctor --generate-gateway-token` are disabled because `openclaw.json` is immutable. Edit the Nix source for this install instead; for nix-openclaw, use the agent-first [Quick Start](https://github.com/openclaw/nix-openclaw#quick-start). |
|
