fix(plugins): keep bare installs on npm for launch

This commit is contained in:
Vincent Koc
2026-05-02 11:57:07 -07:00
parent a7a6d24147
commit cf21bcf9bf
14 changed files with 64 additions and 286 deletions

View File

@@ -15,8 +15,8 @@ combination.
You do not need to add your plugin to the OpenClaw repository. Publish to
[ClawHub](/tools/clawhub) and users install with
`openclaw plugins install <package-name>`. OpenClaw tries ClawHub first and
falls back to npm automatically for packages that still use npm distribution.
`openclaw plugins install clawhub:<package-name>`. Bare package specs still
install from npm during the launch cutover.
## Prerequisites
@@ -141,9 +141,8 @@ and provider plugins have dedicated guides linked above.
openclaw plugins install clawhub:@myorg/openclaw-my-plugin
```
OpenClaw also checks ClawHub before npm for bare package specs like
`@myorg/openclaw-my-plugin`; npm remains a fallback for packages that have
not migrated to ClawHub yet.
Bare package specs like `@myorg/openclaw-my-plugin` install from npm during
the launch cutover. Use `clawhub:` when you want ClawHub resolution.
**In-repo plugins:** place under the bundled plugin workspace tree — automatically discovered.

View File

@@ -9,18 +9,18 @@ title: "Community plugins"
Community plugins are third-party packages that extend OpenClaw with new
channels, tools, providers, or other capabilities. They are built and maintained
by the community, usually published on [ClawHub](/tools/clawhub), and installable
with a single command. Npm remains a supported fallback for packages that have
not moved to ClawHub yet.
with a single command. Npm remains the launch default for bare package specs
while ClawHub pack installs roll out.
ClawHub is the canonical discovery surface for community plugins. Do not open
docs-only PRs just to add your plugin here for discoverability; publish it on
ClawHub instead.
```bash
openclaw plugins install <package-name>
openclaw plugins install clawhub:<package-name>
```
OpenClaw checks ClawHub first and falls back to npm automatically.
Use `openclaw plugins install <package-name>` for npm-hosted packages.
## Listed plugins

View File

@@ -495,12 +495,12 @@ The `ChannelSetupWizard` type supports `credentials`, `textInputs`, `dmPolicy`,
**External plugins:** publish to [ClawHub](/tools/clawhub), then install:
<Tabs>
<Tab title="Auto (ClawHub then npm)">
<Tab title="npm">
```bash
openclaw plugins install @myorg/openclaw-my-plugin
```
OpenClaw tries ClawHub first and falls back to npm automatically.
Bare package specs install from npm during the launch cutover.
</Tab>
<Tab title="ClawHub only">