Caricamento in corso...
Caricamento in corso...
Last synced: Today, 22:00
Technical reference for the OpenClaw framework. Real-time synchronization with the official documentation engine.
Use this file to discover all available pages before exploring further.
ClawHub is the public registry for OpenClaw skills and plugins.
openclawclawhubSite: clawhub.ai
text```bash} npm i -g clawhub # or pnpm add -g clawhub ```
textNative `openclaw` commands install into your active workspace and persist source metadata so later `update` calls can stay on ClawHub.
textBare npm-safe plugin specs are also tried against ClawHub before npm: ```bash} openclaw plugins install openclaw-codex-app-server ``` Use `npm:<package>` when you want npm-only resolution without a ClawHub lookup: ```bash} openclaw plugins install npm:openclaw-codex-app-server ``` Plugin installs validate advertised `pluginApi` and `minGatewayVersion` compatibility before archive install runs, so incompatible hosts fail closed early instead of partially installing the package.
Anonymous ClawHub plugin installs also fail closed for private packages. Community or other non-official channels can still install, but OpenClaw warns so operators can review source and verification before enabling them.
A typical skill is a versioned bundle of files that includes:
SKILL.mdClawHub uses metadata to power discovery and safely expose skill capabilities. The registry tracks usage signals (stars, downloads) to improve ranking and visibility. Each publish creates a new semver version, and the registry keeps version history so users can audit changes.
The separate
clawhub./skillsclawhub--workdirCLAWHUB_WORKDIR<workspace>/skillsIf you already use
~/.openclaw/skills| Feature | Notes |
|---|---|
| Public browsing | Skills and their text SKILL.md |
| Search | Embedding-powered (vector search), not just keywords. |
| Versioning | Semver, changelogs, and tags (including text latest |
| Downloads | Zip per version. |
| Stars and comments | Community feedback. |
| Security scan summaries | Detail pages show the latest scan state before install or download. |
| Scanner detail pages | VirusTotal, ClawScan, and static-analysis results have deep links. |
| Owner recovery dashboard | Publishers can see scan-held owned content from text /dashboard |
| Owner-requested rescans | Owners can request limited rescans for false-positive recovery. |
| Moderation | Approvals and audits. |
| CLI-friendly API | Suitable for automation and scripting. |
ClawHub is open by default — anyone can upload skills, but a GitHub account must be at least one week old to publish. This slows down abuse without blocking legitimate contributors.
You only need this for registry-authenticated workflows such as publish/sync.
Code plugins must include the required OpenClaw metadata in
package.jsonjson{ "name": "@myorg/openclaw-my-plugin", "version": "1.0.0", "type": "module", "openclaw": { "extensions": ["./src/index.ts"], "runtimeExtensions": ["./dist/index.js"], "compat": { "pluginApi": ">=2026.3.24-beta.2", "minGatewayVersion": "2026.3.24-beta.2" }, "build": { "openclawVersion": "2026.3.24-beta.2", "pluginSdkVersion": "2026.3.24-beta.2" } } }
Published packages should ship built JavaScript and point
runtimeExtensions| Variable | Effect |
|---|---|
text CLAWHUB_SITE | Override the site URL. |
text CLAWHUB_REGISTRY | Override the registry API URL. |
text CLAWHUB_CONFIG_PATH | Override where the CLI stores the token/config. |
text CLAWHUB_WORKDIR | Override the default workdir. |
text CLAWHUB_DISABLE_TELEMETRY=1 | Disable telemetry on text sync |
© 2024 TaskFlow Mirror
Powered by TaskFlow Sync Engine