@@ -31,6 +31,8 @@ openclaw plugins inspect --all
3131openclaw plugins info <id>
3232openclaw plugins enable <id>
3333openclaw plugins disable <id>
34+openclaw plugins registry
35+openclaw plugins registry --refresh
3436openclaw plugins uninstall <id>
3537openclaw plugins doctor
3638openclaw plugins update <id-or-npm-spec>
@@ -195,18 +197,20 @@ openclaw plugins list --verbose
195197openclaw plugins list --json
196198```
197199198-Use `--enabled` to show only loaded plugins. Use `--verbose` to switch from the
200+Use `--enabled` to show only enabled plugins. Use `--verbose` to switch from the
199201table view to per-plugin detail lines with source/origin/version/activation
200202metadata. Use `--json` for machine-readable inventory plus registry
201203diagnostics.
202204203-`plugins list` runs discovery from the current CLI environment and config. It is
204-useful for checking whether a plugin is enabled/loadable, but it is not a live
205-runtime probe of an already-running Gateway process. After changing plugin code,
206-enablement, hook policy, or `plugins.load.paths`, restart the Gateway that
207-serves the channel before expecting new `register(api)` code or hooks to run.
208-For remote/container deployments, verify you are restarting the actual
209-`openclaw gateway run` child, not only a wrapper process.
205+`plugins list` reads the persisted local plugin registry first, with a
206+manifest-only derived fallback when the registry is missing or invalid. It is
207+useful for checking whether a plugin is installed, enabled, and visible to cold
208+startup planning, but it is not a live runtime probe of an already-running
209+Gateway process. After changing plugin code, enablement, hook policy, or
210+`plugins.load.paths`, restart the Gateway that serves the channel before
211+expecting new `register(api)` code or hooks to run. For remote/container
212+deployments, verify you are restarting the actual `openclaw gateway run` child,
213+not only a wrapper process.
210214211215For runtime hook debugging:
212216@@ -333,6 +337,24 @@ For module-shape failures such as missing `register`/`activate` exports, rerun
333337with `OPENCLAW_PLUGIN_LOAD_DEBUG=1` to include a compact export-shape summary in
334338the diagnostic output.
335339340+### Registry
341+342+```bash
343+openclaw plugins registry
344+openclaw plugins registry --refresh
345+openclaw plugins registry --json
346+```
347+348+The local plugin registry is OpenClaw's persisted cold read model for installed
349+plugin identity, enablement, source metadata, and contribution ownership.
350+Normal startup, provider owner lookup, channel setup classification, and plugin
351+inventory can read it without importing plugin runtime modules.
352+353+Use `plugins registry` to inspect whether the persisted registry is present,
354+current, or stale. Use `--refresh` to rebuild it from the durable install
355+ledger, config policy, and manifest/package metadata. This is a repair path, not
356+a runtime activation path.
357+336358### Marketplace
337359338360```bash
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。