docs: record upgrade recovery fixes

This commit is contained in:
Peter Steinberger
2026-05-03 21:39:49 +01:00
parent 797d02497e
commit 3301760567
3 changed files with 12 additions and 6 deletions

View File

@@ -118,8 +118,11 @@ not a supported way to prepare bundled plugin dependencies.
Older OpenClaw versions generated bundled-plugin dependency roots at startup or
during doctor repair. Current doctor cleanup removes those stale directories and
symlinks when `--fix` is used, including old `plugin-runtime-deps` roots,
symlinks when `--fix` is used, including old `plugin-runtime-deps` roots, global
Node-prefix package symlinks that point at pruned `plugin-runtime-deps` targets,
`.openclaw-runtime-deps*` manifests, generated plugin `node_modules`, install
stage directories, and package-local pnpm stores.
stage directories, and package-local pnpm stores. Packaged postinstall also
removes those global symlinks before pruning the legacy target roots so upgrades
do not leave dangling ESM package imports.
These paths are legacy debris only. New installs should not create them.