From 38990c0e0979d475d48f52dda6ddd6376d97a705 Mon Sep 17 00:00:00 2001 From: Vincent Koc Date: Sat, 2 May 2026 11:29:14 -0700 Subject: [PATCH] docs(plugins): clarify readiness-gated clawhub installs --- CHANGELOG.md | 1 + docs/tools/clawhub.md | 5 +++-- docs/tools/plugin.md | 2 +- 3 files changed, 5 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4dfc8633f90..42d44219bb7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -49,6 +49,7 @@ Docs: https://docs.openclaw.ai ### Fixes - Codex/app-server: resolve managed binaries from bundled `dist` chunks and from the `@openai/codex` package bin when installs do not provide a nearby `.bin/codex` shim, avoiding false missing-binary startup failures. +- Plugins/ClawHub: gate bare plugin specs on ClawHub readiness before preferring ClawHub, so packages without deployed ClawPack readiness keep the npm fallback path instead of failing through a half-ready registry route. Thanks @vincentkoc. - Plugins/source checkout: discover source-only plugins such as Codex from the `extensions/*` workspace while using npm package excludes as the packaged-core boundary, removing the stale core-bundle metadata path. - Plugins/ClawHub: install ClawPack artifacts from the explicit npm-pack `.tgz` resolver path and persist artifact kind, npm integrity, shasum, and tarball metadata for update and diagnostics flows. Thanks @vincentkoc. - Control UI: allow deployments to configure grouped chat message max-width with a validated `gateway.controlUi.chatMessageMaxWidth` setting instead of patching bundled CSS after upgrades. Fixes #67935. Thanks @xiew4589-lang. diff --git a/docs/tools/clawhub.md b/docs/tools/clawhub.md index 2b9fdbdebaa..f601a3dac3a 100644 --- a/docs/tools/clawhub.md +++ b/docs/tools/clawhub.md @@ -66,8 +66,9 @@ Site: [clawhub.ai](https://clawhub.ai) ``` `plugins search` queries the ClawHub plugin catalog and prints install-ready - package names. Bare npm-safe plugin specs are also tried against ClawHub - before npm: + package names. Bare npm-safe plugin specs use ClawHub only after package + readiness says the package is install-ready for OpenClaw; otherwise OpenClaw + preserves npm fallback: ```bash openclaw plugins install openclaw-codex-app-server diff --git a/docs/tools/plugin.md b/docs/tools/plugin.md index 2619bf30595..599f66d1b8e 100644 --- a/docs/tools/plugin.md +++ b/docs/tools/plugin.md @@ -465,7 +465,7 @@ openclaw plugins registry # inspect persisted registry state openclaw plugins registry --refresh # rebuild persisted registry openclaw doctor --fix # repair plugin registry state -openclaw plugins install # install (ClawHub first, then npm) +openclaw plugins install # install (readiness-gated ClawHub, then npm) openclaw plugins install clawhub: # install from ClawHub only openclaw plugins install npm: # install from npm only openclaw plugins install git: # install from git