Skip to content

Commit 1e2fda9

Browse files
steipetesteipete
committed
docs(plugins): clarify external plugin installs
1 parent 7d0347b commit 1e2fda9

9 files changed

Lines changed: 62 additions & 8 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ Docs: https://docs.openclaw.ai
1010

1111
### Fixes
1212

13+
- Plugins: make PixVerse external-plugin ClawHub metadata explicit and keep it out of bundled dist builds.
1314
- Providers: bound generated media downloads from OpenAI, Runway, xAI, MiniMax, BytePlus, DashScope-compatible, FAL, OpenRouter, Google, Vydra, and Comfy providers.
1415
- Cron: retry recurring jobs after transient model rate limits before waiting for the next scheduled slot.
1516

‎docs/plugins/plugin-inventory.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -167,7 +167,7 @@ commands.
167167
| [nextcloud-talk](/plugins/reference/nextcloud-talk) | OpenClaw Nextcloud Talk channel plugin for conversations. | `@openclaw/nextcloud-talk`<br />npm; ClawHub | channels: nextcloud-talk |
168168
| [nostr](/plugins/reference/nostr) | OpenClaw Nostr channel plugin for NIP-04 encrypted direct messages. | `@openclaw/nostr`<br />npm; ClawHub | channels: nostr |
169169
| [openshell](/plugins/reference/openshell) | OpenClaw sandbox backend for the NVIDIA OpenShell CLI with mirrored local workspaces and SSH command execution. | `@openclaw/openshell-sandbox`<br />npm; ClawHub | plugin |
170-
| [pixverse](/plugins/reference/pixverse) | OpenClaw PixVerse video generation provider plugin. | `@openclaw/pixverse-provider`<br />npm; ClawHub | contracts: videoGenerationProviders |
170+
| [pixverse](/plugins/reference/pixverse) | OpenClaw PixVerse video generation provider plugin. | `@openclaw/pixverse-provider`<br />npm; ClawHub: `clawhub:@openclaw/pixverse-provider` | contracts: videoGenerationProviders |
171171
| [qqbot](/plugins/reference/qqbot) | OpenClaw QQ Bot channel plugin for group and direct-message workflows. | `@openclaw/qqbot`<br />npm; ClawHub | channels: qqbot; contracts: tools; skills |
172172
| [slack](/plugins/reference/slack) | OpenClaw Slack channel plugin for channels, DMs, commands, and app events. | `@openclaw/slack`<br />npm; ClawHub | channels: slack |
173173
| [synology-chat](/plugins/reference/synology-chat) | Synology Chat channel plugin for OpenClaw channels and direct messages. | `@openclaw/synology-chat`<br />npm; ClawHub | channels: synology-chat |

‎docs/plugins/reference.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ pnpm plugins:inventory:gen
9999
| [openrouter](/plugins/reference/openrouter) | Adds OpenRouter model provider support to OpenClaw. | `@openclaw/openrouter-provider`<br />included in OpenClaw | providers: openrouter; contracts: imageGenerationProviders, mediaUnderstandingProviders, musicGenerationProviders, speechProviders, videoGenerationProviders |
100100
| [openshell](/plugins/reference/openshell) | OpenClaw sandbox backend for the NVIDIA OpenShell CLI with mirrored local workspaces and SSH command execution. | `@openclaw/openshell-sandbox`<br />npm; ClawHub | plugin |
101101
| [perplexity](/plugins/reference/perplexity) | Adds web search provider support. | `@openclaw/perplexity-plugin`<br />included in OpenClaw | contracts: webSearchProviders |
102-
| [pixverse](/plugins/reference/pixverse) | OpenClaw PixVerse video generation provider plugin. | `@openclaw/pixverse-provider`<br />npm; ClawHub | contracts: videoGenerationProviders |
102+
| [pixverse](/plugins/reference/pixverse) | OpenClaw PixVerse video generation provider plugin. | `@openclaw/pixverse-provider`<br />npm; ClawHub: `clawhub:@openclaw/pixverse-provider` | contracts: videoGenerationProviders |
103103
| [policy](/plugins/reference/policy) | Adds policy-backed doctor checks for workspace conformance. | `@openclaw/policy`<br />included in OpenClaw | plugin |
104104
| [qa-channel](/plugins/reference/qa-channel) | Adds the QA Channel surface for sending and receiving OpenClaw messages. | `@openclaw/qa-channel`<br />source checkout only | channels: qa-channel |
105105
| [qa-lab](/plugins/reference/qa-lab) | OpenClaw QA lab plugin with private debugger UI and scenario runner. | `@openclaw/qa-lab`<br />source checkout only | plugin |

‎docs/plugins/reference/pixverse.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ OpenClaw PixVerse video generation provider plugin.
1212
## Distribution
1313

1414
- Package: `@openclaw/pixverse-provider`
15-
- Install route: npm; ClawHub
15+
- Install route: npm; ClawHub: `clawhub:@openclaw/pixverse-provider`
1616

1717
## Surface
1818

‎docs/providers/github-copilot.md‎

Lines changed: 35 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,15 @@ summary: "Sign in to GitHub Copilot from OpenClaw using the device flow or non-i
33
read_when:
44
- You want to use GitHub Copilot as a model provider
55
- You need the `openclaw models auth login-github-copilot` flow
6+
- You are choosing between the built-in Copilot provider, Copilot SDK harness, and Copilot Proxy
67
title: "GitHub Copilot"
78
---
89

910
GitHub Copilot is GitHub's AI coding assistant. It provides access to Copilot
1011
models for your GitHub account and plan. OpenClaw can use Copilot as a model
11-
provider in two different ways.
12+
provider or agent runtime in three different ways.
1213

13-
## Two ways to use Copilot in OpenClaw
14+
## Three ways to use Copilot in OpenClaw
1415

1516
<Tabs>
1617
<Tab title="Built-in provider (github-copilot)">
@@ -46,6 +47,38 @@ provider in two different ways.
4647

4748
</Tab>
4849

50+
<Tab title="Copilot SDK harness plugin (copilot)">
51+
Install the external `@openclaw/copilot` plugin when you want GitHub's
52+
Copilot CLI and SDK to own the low-level agent loop for selected
53+
`github-copilot/*` models.
54+
55+
```bash
56+
openclaw plugins install clawhub:@openclaw/copilot
57+
```
58+
59+
Then opt a model or provider into the runtime:
60+
61+
```json5
62+
{
63+
agents: {
64+
defaults: {
65+
model: "github-copilot/gpt-5.5",
66+
models: {
67+
"github-copilot/gpt-5.5": {
68+
agentRuntime: { id: "copilot" },
69+
},
70+
},
71+
},
72+
},
73+
}
74+
```
75+
76+
Choose this when you want native Copilot CLI sessions, SDK-managed thread
77+
state, and Copilot-owned compaction for those agent turns. See
78+
[Copilot SDK harness](/plugins/copilot) for the full runtime contract.
79+
80+
</Tab>
81+
4982
<Tab title="Copilot Proxy plugin (copilot-proxy)">
5083
Use the **Copilot Proxy** VS Code extension as a local bridge. OpenClaw talks to
5184
the proxy's `/v1` endpoint and uses the model list you configure there.

‎docs/providers/pixverse.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ OpenClaw provides `pixverse` as an official external plugin for hosted PixVerse
2525
<Steps>
2626
<Step title="Install the plugin">
2727
```bash
28-
openclaw plugins install @openclaw/pixverse-provider
28+
openclaw plugins install clawhub:@openclaw/pixverse-provider
2929
openclaw gateway restart
3030
```
3131
</Step>

‎docs/tools/diffs.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -213,7 +213,7 @@ Common aliases such as `js`, `ts`, `bash`, `md`, `yml`, `c++`, `dockerfile`, `rb
213213
Install the Diff Viewer Language Pack plugin to highlight other languages:
214214

215215
```bash
216-
openclaw plugins install diffs-language-pack
216+
openclaw plugins install clawhub:@openclaw/diffs-language-pack
217217
```
218218

219219
With the language pack available, OpenClaw automatically uses it for languages outside the default list. Without it, those files stay readable as plain text.

‎extensions/pixverse/package.json‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@
2424
"./index.ts"
2525
],
2626
"install": {
27+
"clawhubSpec": "clawhub:@openclaw/pixverse-provider",
2728
"npmSpec": "@openclaw/pixverse-provider",
2829
"defaultChoice": "npm",
2930
"minHostVersion": ">=2026.5.26"
@@ -32,7 +33,8 @@
3233
"pluginApi": ">=2026.5.28"
3334
},
3435
"build": {
35-
"openclawVersion": "2026.5.28"
36+
"openclawVersion": "2026.5.28",
37+
"bundledDist": false
3638
},
3739
"release": {
3840
"publishToClawHub": true,

‎scripts/lib/official-external-plugin-catalog.json‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -207,6 +207,24 @@
207207
}
208208
}
209209
},
210+
{
211+
"name": "@openclaw/pixverse-provider",
212+
"description": "OpenClaw PixVerse video generation provider plugin",
213+
"source": "official",
214+
"kind": "plugin",
215+
"openclaw": {
216+
"plugin": {
217+
"id": "pixverse",
218+
"label": "PixVerse"
219+
},
220+
"install": {
221+
"clawhubSpec": "clawhub:@openclaw/pixverse-provider",
222+
"npmSpec": "@openclaw/pixverse-provider",
223+
"defaultChoice": "npm",
224+
"minHostVersion": ">=2026.5.26"
225+
}
226+
}
227+
},
210228
{
211229
"name": "@openclaw/voice-call",
212230
"description": "OpenClaw voice-call plugin",

0 commit comments

Comments
 (0)