@@ -40,9 +40,11 @@ openclaw --update
4040`postUpdate.plugins.integrityDrifts` when npm plugin artifact drift is
4141 detected during post-update plugin sync.
4242- `--timeout <seconds>`: per-step timeout (default is 1800s).
43-- `--yes`: skip confirmation prompts (for example downgrade confirmation)
43+- `--yes`: skip confirmation prompts (for example downgrade confirmation).
444445-Note: downgrades require confirmation because older versions can break configuration.
45+<Warning>
46+Downgrades require confirmation because older versions can break configuration.
47+</Warning>
46484749## `update status`
4850@@ -91,35 +93,53 @@ build.
91939294## Git checkout flow
939594-Channels:
95-96-- `stable`: checkout the latest non-beta tag, then build + doctor.
97-- `beta`: prefer the latest `-beta` tag, but fall back to the latest stable tag
98- when beta is missing or older.
99-- `dev`: checkout `main`, then fetch + rebase.
100-101-High-level:
102-103-1. Requires a clean worktree (no uncommitted changes).
104-2. Switches to the selected channel (tag or branch).
105-3. Fetches upstream (dev only).
106-4. Dev only: preflight lint + TypeScript build in a temp worktree; if the tip fails, walks back up to 10 commits to find the newest clean build.
107-5. Rebases onto the selected commit (dev only).
108-6. Installs deps with the repo package manager. For pnpm checkouts, the updater bootstraps `pnpm` on demand (via `corepack` first, then a temporary `npm install pnpm@10` fallback) instead of running `npm run build` inside a pnpm workspace.
109-7. Builds + builds the Control UI.
110-8. Runs `openclaw doctor` as the final “safe update” check.
111-9. Syncs plugins to the active channel (dev uses bundled plugins; stable/beta uses npm) and updates npm-installed plugins.
112-113-If an exact pinned npm plugin update resolves to an artifact whose integrity
114-differs from the stored install record, `openclaw update` aborts that plugin
115-artifact update instead of installing it. Reinstall or update the plugin
116-explicitly only after verifying that you trust the new artifact.
117-118-Post-update plugin sync failures fail the update result and stop restart
119-follow-up work. Fix the plugin install/update error, then rerun
120-`openclaw update`.
121-122-If pnpm bootstrap still fails, the updater now stops early with a package-manager-specific error instead of trying `npm run build` inside the checkout.
96+### Channel selection
97+98+- `stable`: checkout the latest non-beta tag, then build and doctor.
99+- `beta`: prefer the latest `-beta` tag, but fall back to the latest stable tag when beta is missing or older.
100+- `dev`: checkout `main`, then fetch and rebase.
101+102+### Update steps
103+104+<Steps>
105+<Step title="Verify clean worktree">
106+Requires no uncommitted changes.
107+</Step>
108+<Step title="Switch channel">
109+Switches to the selected channel (tag or branch).
110+</Step>
111+<Step title="Fetch upstream">
112+Dev only.
113+</Step>
114+<Step title="Preflight build (dev only)">
115+Runs lint and TypeScript build in a temp worktree. If the tip fails, walks back up to 10 commits to find the newest clean build.
116+</Step>
117+<Step title="Rebase">
118+Rebases onto the selected commit (dev only).
119+</Step>
120+<Step title="Install dependencies">
121+Uses the repo package manager. For pnpm checkouts, the updater bootstraps `pnpm` on demand (via `corepack` first, then a temporary `npm install pnpm@10` fallback) instead of running `npm run build` inside a pnpm workspace.
122+</Step>
123+<Step title="Build Control UI">
124+Builds the gateway and the Control UI.
125+</Step>
126+<Step title="Run doctor">
127+`openclaw doctor` runs as the final safe-update check.
128+</Step>
129+<Step title="Sync plugins">
130+Syncs plugins to the active channel. Dev uses bundled plugins; stable and beta use npm. Updates npm-installed plugins.
131+</Step>
132+</Steps>
133+134+<Warning>
135+If an exact pinned npm plugin update resolves to an artifact whose integrity differs from the stored install record, `openclaw update` aborts that plugin artifact update instead of installing it. Reinstall or update the plugin explicitly only after verifying that you trust the new artifact.
136+</Warning>
137+138+<Note>
139+Post-update plugin sync failures fail the update result and stop restart follow-up work. Fix the plugin install or update error, then rerun `openclaw update`.
140+141+If pnpm bootstrap still fails, the updater stops early with a package-manager-specific error instead of trying `npm run build` inside the checkout.
142+</Note>
123143124144## `--update` shorthand
125145此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。