vultr/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-05-06 17:10:49 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: clarify update diagnostics

Browse Source
This commit is contained in:
Peter Steinberger
2026-05-03 21:21:48 +01:00
parent 53cc52981b
commit 3147efbed4
2 changed files with 15 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
docs/cli/update.md
View File

@@ -2,6 +2,7 @@
summary: "CLI reference for `openclaw update` (safe-ish source update + gateway auto-restart)" summary: "CLI reference for `openclaw update` (safe-ish source update + gateway auto-restart)"
read_when: read_when:
- You want to update a source checkout safely - You want to update a source checkout safely
- You are debugging `openclaw update` output or options
- You need to understand `--update` shorthand behavior - You need to understand `--update` shorthand behavior
title: "Update" title: "Update"
--- ---
@@ -42,6 +43,14 @@ openclaw --update
- `--timeout <seconds>`: per-step timeout (default is 1800s). - `--timeout <seconds>`: per-step timeout (default is 1800s).
- `--yes`: skip confirmation prompts (for example downgrade confirmation). - `--yes`: skip confirmation prompts (for example downgrade confirmation).
`openclaw update` does not have a `--verbose` flag. Use `--dry-run` to preview
the planned channel/tag/install/restart actions, `--json` for machine-readable
results, and `openclaw update status --json` when you only need channel and
availability details. If you are debugging Gateway logs around an update,
console verbosity and file log level are separate: Gateway `--verbose` affects
terminal/WebSocket output, while file logs require `logging.level: "debug"` or
`"trace"` in config. See [Gateway logging](/gateway/logging).
<Warning> <Warning>
Downgrades require confirmation because older versions can break configuration. Downgrades require confirmation because older versions can break configuration.
</Warning> </Warning>

6
docs/install/updating.md
View File

@@ -25,6 +25,12 @@ openclaw update --tag main
openclaw update --dry-run # preview without applying openclaw update --dry-run # preview without applying
``` ```
`openclaw update` does not accept `--verbose`. For update diagnostics, use
`--dry-run` to preview the planned actions, `--json` for structured results, or
`openclaw update status --json` to inspect channel and availability state. The
installer has its own `--verbose` flag, but that flag is not part of
`openclaw update`.
`--channel beta` prefers beta, but the runtime falls back to stable/latest when `--channel beta` prefers beta, but the runtime falls back to stable/latest when
the beta tag is missing or older than the latest stable release. Use `--tag beta` the beta tag is missing or older than the latest stable release. Use `--tag beta`
if you want the raw npm beta dist-tag for a one-off package update. if you want the raw npm beta dist-tag for a one-off package update.