From cbe167d4fdd624467c7419789bba386f1afbe3ef Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Mon, 20 Apr 2026 16:48:56 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@47d42606ac5ae765944c1ecaaeced909ad6d7194 --- .openclaw-sync/source.json | 4 ++-- docs/gateway/doctor.md | 12 ++++++++---- docs/plugins/sdk-setup.md | 6 ++++++ docs/tools/plugin.md | 7 +++++++ 4 files changed, 23 insertions(+), 6 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 14a8c76db..35fd91544 100644 --- a/.openclaw-sync/source.json +++ b/.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" } diff --git a/docs/gateway/doctor.md b/docs/gateway/doctor.md index ef634739f..eb714d157 100644 --- a/docs/gateway/doctor.md +++ b/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 diff --git a/docs/plugins/sdk-setup.md b/docs/plugins/sdk-setup.md index 81ba55de3..291854318 100644 --- a/docs/plugins/sdk-setup.md +++ b/docs/plugins/sdk-setup.md @@ -529,6 +529,12 @@ openclaw plugins install trees pure JS/TS and avoid packages that require `postinstall` builds. +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` diff --git a/docs/tools/plugin.md b/docs/tools/plugin.md index d47cb8505..e6a4ac720 100644 --- a/docs/tools/plugin.md +++ b/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: