diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 83da1bee6..87f7acfdb 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "fa43cbfcba8c5c39ff98da751006d26dc75cb7e6",
-  "syncedAt": "2026-04-23T00:25:18.581Z"
+  "sha": "87a64a33f1671347945bf0cec7080acd35d9c23c",
+  "syncedAt": "2026-04-23T00:26:20.657Z"
 }
diff --git a/docs/cli/plugins.md b/docs/cli/plugins.md
index 7c164e578..f315fa274 100644
--- a/docs/cli/plugins.md
+++ b/docs/cli/plugins.md
@@ -76,6 +76,8 @@ bundled-plugin recovery path for plugins that explicitly opt into
 `--force` reuses the existing install target and overwrites an already-installed
 plugin or hook pack in place. Use it when you are intentionally reinstalling
 the same id from a new local path, archive, ClawHub package, or npm artifact.
+For routine upgrades of an already tracked npm plugin, prefer
+`openclaw plugins update <id-or-npm-spec>`.
 
 `--pin` applies to npm installs only. It is not supported with `--marketplace`,
 because marketplace installs persist marketplace source metadata instead of an