diff --git a/CHANGELOG.md b/CHANGELOG.md
index f57e87ca5a16..ff630f83f776 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -10,6 +10,7 @@ Docs: https://docs.openclaw.ai
### Fixes
+- Plugins: make PixVerse external-plugin ClawHub metadata explicit and keep it out of bundled dist builds.
- Providers: bound generated media downloads from OpenAI, Runway, xAI, MiniMax, BytePlus, DashScope-compatible, FAL, OpenRouter, Google, Vydra, and Comfy providers.
- Cron: retry recurring jobs after transient model rate limits before waiting for the next scheduled slot.
diff --git a/docs/plugins/plugin-inventory.md b/docs/plugins/plugin-inventory.md
index d0833774ecec..84c3168c12e0 100644
--- a/docs/plugins/plugin-inventory.md
+++ b/docs/plugins/plugin-inventory.md
@@ -167,7 +167,7 @@ commands.
| [nextcloud-talk](/plugins/reference/nextcloud-talk) | OpenClaw Nextcloud Talk channel plugin for conversations. | `@openclaw/nextcloud-talk`
npm; ClawHub | channels: nextcloud-talk |
| [nostr](/plugins/reference/nostr) | OpenClaw Nostr channel plugin for NIP-04 encrypted direct messages. | `@openclaw/nostr`
npm; ClawHub | channels: nostr |
| [openshell](/plugins/reference/openshell) | OpenClaw sandbox backend for the NVIDIA OpenShell CLI with mirrored local workspaces and SSH command execution. | `@openclaw/openshell-sandbox`
npm; ClawHub | plugin |
-| [pixverse](/plugins/reference/pixverse) | OpenClaw PixVerse video generation provider plugin. | `@openclaw/pixverse-provider`
npm; ClawHub | contracts: videoGenerationProviders |
+| [pixverse](/plugins/reference/pixverse) | OpenClaw PixVerse video generation provider plugin. | `@openclaw/pixverse-provider`
npm; ClawHub: `clawhub:@openclaw/pixverse-provider` | contracts: videoGenerationProviders |
| [qqbot](/plugins/reference/qqbot) | OpenClaw QQ Bot channel plugin for group and direct-message workflows. | `@openclaw/qqbot`
npm; ClawHub | channels: qqbot; contracts: tools; skills |
| [slack](/plugins/reference/slack) | OpenClaw Slack channel plugin for channels, DMs, commands, and app events. | `@openclaw/slack`
npm; ClawHub | channels: slack |
| [synology-chat](/plugins/reference/synology-chat) | Synology Chat channel plugin for OpenClaw channels and direct messages. | `@openclaw/synology-chat`
npm; ClawHub | channels: synology-chat |
diff --git a/docs/plugins/reference.md b/docs/plugins/reference.md
index b980a3e08418..3406e385069c 100644
--- a/docs/plugins/reference.md
+++ b/docs/plugins/reference.md
@@ -99,7 +99,7 @@ pnpm plugins:inventory:gen
| [openrouter](/plugins/reference/openrouter) | Adds OpenRouter model provider support to OpenClaw. | `@openclaw/openrouter-provider`
included in OpenClaw | providers: openrouter; contracts: imageGenerationProviders, mediaUnderstandingProviders, musicGenerationProviders, speechProviders, videoGenerationProviders |
| [openshell](/plugins/reference/openshell) | OpenClaw sandbox backend for the NVIDIA OpenShell CLI with mirrored local workspaces and SSH command execution. | `@openclaw/openshell-sandbox`
npm; ClawHub | plugin |
| [perplexity](/plugins/reference/perplexity) | Adds web search provider support. | `@openclaw/perplexity-plugin`
included in OpenClaw | contracts: webSearchProviders |
-| [pixverse](/plugins/reference/pixverse) | OpenClaw PixVerse video generation provider plugin. | `@openclaw/pixverse-provider`
npm; ClawHub | contracts: videoGenerationProviders |
+| [pixverse](/plugins/reference/pixverse) | OpenClaw PixVerse video generation provider plugin. | `@openclaw/pixverse-provider`
npm; ClawHub: `clawhub:@openclaw/pixverse-provider` | contracts: videoGenerationProviders |
| [policy](/plugins/reference/policy) | Adds policy-backed doctor checks for workspace conformance. | `@openclaw/policy`
included in OpenClaw | plugin |
| [qa-channel](/plugins/reference/qa-channel) | Adds the QA Channel surface for sending and receiving OpenClaw messages. | `@openclaw/qa-channel`
source checkout only | channels: qa-channel |
| [qa-lab](/plugins/reference/qa-lab) | OpenClaw QA lab plugin with private debugger UI and scenario runner. | `@openclaw/qa-lab`
source checkout only | plugin |
diff --git a/docs/plugins/reference/pixverse.md b/docs/plugins/reference/pixverse.md
index a29c29b06709..cd94ee29e05b 100644
--- a/docs/plugins/reference/pixverse.md
+++ b/docs/plugins/reference/pixverse.md
@@ -12,7 +12,7 @@ OpenClaw PixVerse video generation provider plugin.
## Distribution
- Package: `@openclaw/pixverse-provider`
-- Install route: npm; ClawHub
+- Install route: npm; ClawHub: `clawhub:@openclaw/pixverse-provider`
## Surface
diff --git a/docs/providers/github-copilot.md b/docs/providers/github-copilot.md
index 6623ce6dfb00..311065af9977 100644
--- a/docs/providers/github-copilot.md
+++ b/docs/providers/github-copilot.md
@@ -3,14 +3,15 @@ summary: "Sign in to GitHub Copilot from OpenClaw using the device flow or non-i
read_when:
- You want to use GitHub Copilot as a model provider
- You need the `openclaw models auth login-github-copilot` flow
+ - You are choosing between the built-in Copilot provider, Copilot SDK harness, and Copilot Proxy
title: "GitHub Copilot"
---
GitHub Copilot is GitHub's AI coding assistant. It provides access to Copilot
models for your GitHub account and plan. OpenClaw can use Copilot as a model
-provider in two different ways.
+provider or agent runtime in three different ways.
-## Two ways to use Copilot in OpenClaw
+## Three ways to use Copilot in OpenClaw
@@ -46,6 +47,38 @@ provider in two different ways.
+
+ Install the external `@openclaw/copilot` plugin when you want GitHub's
+ Copilot CLI and SDK to own the low-level agent loop for selected
+ `github-copilot/*` models.
+
+ ```bash
+ openclaw plugins install clawhub:@openclaw/copilot
+ ```
+
+ Then opt a model or provider into the runtime:
+
+ ```json5
+ {
+ agents: {
+ defaults: {
+ model: "github-copilot/gpt-5.5",
+ models: {
+ "github-copilot/gpt-5.5": {
+ agentRuntime: { id: "copilot" },
+ },
+ },
+ },
+ },
+ }
+ ```
+
+ Choose this when you want native Copilot CLI sessions, SDK-managed thread
+ state, and Copilot-owned compaction for those agent turns. See
+ [Copilot SDK harness](/plugins/copilot) for the full runtime contract.
+
+
+
Use the **Copilot Proxy** VS Code extension as a local bridge. OpenClaw talks to
the proxy's `/v1` endpoint and uses the model list you configure there.
diff --git a/docs/providers/pixverse.md b/docs/providers/pixverse.md
index 89918291fe06..c798a89c1388 100644
--- a/docs/providers/pixverse.md
+++ b/docs/providers/pixverse.md
@@ -25,7 +25,7 @@ OpenClaw provides `pixverse` as an official external plugin for hosted PixVerse
```bash
- openclaw plugins install @openclaw/pixverse-provider
+ openclaw plugins install clawhub:@openclaw/pixverse-provider
openclaw gateway restart
```
diff --git a/docs/tools/diffs.md b/docs/tools/diffs.md
index 4ca9605aec75..bf1687c90831 100644
--- a/docs/tools/diffs.md
+++ b/docs/tools/diffs.md
@@ -213,7 +213,7 @@ Common aliases such as `js`, `ts`, `bash`, `md`, `yml`, `c++`, `dockerfile`, `rb
Install the Diff Viewer Language Pack plugin to highlight other languages:
```bash
-openclaw plugins install diffs-language-pack
+openclaw plugins install clawhub:@openclaw/diffs-language-pack
```
With the language pack available, OpenClaw automatically uses it for languages outside the default list. Without it, those files stay readable as plain text.
diff --git a/extensions/pixverse/package.json b/extensions/pixverse/package.json
index 6d3ed045be85..7d8a356151ba 100644
--- a/extensions/pixverse/package.json
+++ b/extensions/pixverse/package.json
@@ -24,6 +24,7 @@
"./index.ts"
],
"install": {
+ "clawhubSpec": "clawhub:@openclaw/pixverse-provider",
"npmSpec": "@openclaw/pixverse-provider",
"defaultChoice": "npm",
"minHostVersion": ">=2026.5.26"
@@ -32,7 +33,8 @@
"pluginApi": ">=2026.5.28"
},
"build": {
- "openclawVersion": "2026.5.28"
+ "openclawVersion": "2026.5.28",
+ "bundledDist": false
},
"release": {
"publishToClawHub": true,
diff --git a/scripts/lib/official-external-plugin-catalog.json b/scripts/lib/official-external-plugin-catalog.json
index 835d0af70071..854e5bbf9866 100644
--- a/scripts/lib/official-external-plugin-catalog.json
+++ b/scripts/lib/official-external-plugin-catalog.json
@@ -207,6 +207,24 @@
}
}
},
+ {
+ "name": "@openclaw/pixverse-provider",
+ "description": "OpenClaw PixVerse video generation provider plugin",
+ "source": "official",
+ "kind": "plugin",
+ "openclaw": {
+ "plugin": {
+ "id": "pixverse",
+ "label": "PixVerse"
+ },
+ "install": {
+ "clawhubSpec": "clawhub:@openclaw/pixverse-provider",
+ "npmSpec": "@openclaw/pixverse-provider",
+ "defaultChoice": "npm",
+ "minHostVersion": ">=2026.5.26"
+ }
+ }
+ },
{
"name": "@openclaw/voice-call",
"description": "OpenClaw voice-call plugin",