chore(sync): mirror docs from openclaw/openclaw@47d42606ac

.openclaw-sync/source.json

@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "97e79bb5f666a86d8df38f84411dba69791c4ba7",
-  "syncedAt": "2026-04-20T16:42:29.722Z"
+  "sha": "47d42606ac5ae765944c1ecaaeced909ad6d7194",
+  "syncedAt": "2026-04-20T16:48:56.152Z"
 }

docs/gateway/doctor.md

@@ -380,10 +380,14 @@ switch to legacy names if the current image is missing.
 
 ### 7b) Bundled plugin runtime deps
 
-Doctor verifies that bundled plugin runtime dependencies (for example the
-Discord plugin runtime packages) are present in the OpenClaw install root.
-If any are missing, doctor reports the packages and installs them in
-`openclaw doctor --fix` / `openclaw doctor --repair` mode.
+Doctor verifies runtime dependencies only for bundled plugins that are active in
+the current config or enabled by their bundled manifest default, for example
+`plugins.entries.discord.enabled: true`, legacy
+`channels.discord.enabled: true`, or a default-enabled bundled provider. If any
+are missing, doctor reports the packages and installs them in
+`openclaw doctor --fix` / `openclaw doctor --repair` mode. External plugins still
+use `openclaw plugins install` / `openclaw plugins update`; doctor does not
+install dependencies for arbitrary plugin paths.
 
 ### 8) Gateway service migrations and cleanup hints
 

docs/plugins/sdk-setup.md

@@ -529,6 +529,12 @@ openclaw plugins install <package-name>
   trees pure JS/TS and avoid packages that require `postinstall` builds.
 </Info>
 
+Bundled OpenClaw-owned plugins are the only startup repair exception: when a
+packaged install sees one enabled by plugin config, legacy channel config, or
+its bundled default-enabled manifest, startup installs that plugin's missing
+runtime dependencies before import. Third-party plugins should not rely on
+startup installs; keep using the explicit plugin installer.
+
 ## Related
 
 - [SDK Entry Points](/plugins/sdk-entrypoints) -- `definePluginEntry` and `defineChannelPluginEntry`

docs/tools/plugin.md

@@ -63,6 +63,13 @@ If config is invalid, install normally fails closed and points you at
 reinstall path for plugins that opt into
 `openclaw.install.allowInvalidConfigRecovery`.
 
+Packaged OpenClaw installs do not eagerly install every bundled plugin's
+runtime dependency tree. When a bundled OpenClaw-owned plugin is active from
+plugin config, legacy channel config, or a default-enabled manifest, startup
+repairs only that plugin's declared runtime dependencies before importing it.
+External plugins and custom load paths must still be installed through
+`openclaw plugins install`.
+
 ## Plugin types
 
 OpenClaw recognizes two plugin formats: