From 1e2fda9e6886bbe09e034390dde6368210d7c4d5 Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Fri, 29 May 2026 20:43:38 +0100 Subject: [PATCH] docs(plugins): clarify external plugin installs --- CHANGELOG.md | 1 + docs/plugins/plugin-inventory.md | 2 +- docs/plugins/reference.md | 2 +- docs/plugins/reference/pixverse.md | 2 +- docs/providers/github-copilot.md | 37 ++++++++++++++++++- docs/providers/pixverse.md | 2 +- docs/tools/diffs.md | 2 +- extensions/pixverse/package.json | 4 +- .../lib/official-external-plugin-catalog.json | 18 +++++++++ 9 files changed, 62 insertions(+), 8 deletions(-) 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",