Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

De meeste plugin-workflows bestaan uit een paar opdrachten: zoeken, installeren, de Gateway herstarten, verifiëren en verwijderen wanneer je de plugin niet meer nodig hebt.

Plugins weergeven

openclaw plugins list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw plugins list --json
Gebruik --json voor scripts. Het bevat registerdiagnostiek en de statische dependencyStatus van elke plugin wanneer het pluginpakket dependencies of optionalDependencies declareert.
openclaw plugins list --json \
  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'
plugins list is een koude inventariscontrole. Het toont wat OpenClaw kan vinden via configuratie, manifests en het pluginregister; het bewijst niet dat een al draaiend Gateway-proces de plugin-runtime heeft geïmporteerd.

Plugins installeren

# Search ClawHub for plugin packages.
openclaw plugins search "calendar"

# Bare package specs try ClawHub first, then npm fallback.
openclaw plugins install <package>

# Force one source.
openclaw plugins install clawhub:<package>
openclaw plugins install npm:<package>

# Install a specific version or dist-tag.
openclaw plugins install clawhub:<package>@1.2.3
openclaw plugins install clawhub:<package>@beta
openclaw plugins install npm:@scope/openclaw-plugin@1.2.3
openclaw plugins install npm:@openclaw/codex

# Install from git or a local development checkout.
openclaw plugins install git:github.com/acme/openclaw-plugin@v1.0.0
openclaw plugins install ./my-plugin
openclaw plugins install --link ./my-plugin
Herstart na het installeren van plugincode de Gateway die je kanalen bedient:
openclaw gateway restart
openclaw plugins inspect <plugin-id> --runtime --json
Gebruik inspect --runtime wanneer je bewijs nodig hebt dat de plugin runtime-oppervlakken heeft geregistreerd, zoals tools, hooks, services, Gateway-methoden of CLI-opdrachten die eigendom zijn van de plugin.

Plugins bijwerken

openclaw plugins update <plugin-id>
openclaw plugins update <npm-package-or-spec>
openclaw plugins update --all
Als een plugin is geïnstalleerd vanaf een npm-dist-tag zoals @beta, gebruiken latere aanroepen van update <plugin-id> die vastgelegde tag opnieuw. Door een expliciete npm-specificatie door te geven, wordt de gevolgde installatie voor toekomstige updates naar die specificatie overgezet.
openclaw plugins update @scope/openclaw-plugin@beta
openclaw plugins update @scope/openclaw-plugin
De tweede opdracht verplaatst een plugin terug naar de standaardreleasereeks van het register wanneer deze eerder was vastgezet op een exacte versie of tag. Wanneer openclaw update op het bètakanaal draait, proberen npm- en ClawHub-pluginrecords op de standaardreeks eerst de overeenkomende @beta-release van de plugin. Als die bètarelease niet bestaat, valt OpenClaw terug op de vastgelegde standaard-/laatste specificatie. Voor npm-plugins valt OpenClaw ook terug wanneer het bètapakket bestaat maar niet door de installatievalidatie komt. Exacte versies en expliciete tags zoals @rc of @beta blijven behouden.

Plugins verwijderen

openclaw plugins uninstall <plugin-id> --dry-run
openclaw plugins uninstall <plugin-id>
openclaw plugins uninstall <plugin-id> --keep-files
openclaw gateway restart
Verwijderen haalt de configuratievermelding van de plugin, het pluginindexrecord, allow-/denylist- vermeldingen en gekoppelde laadpaden weg wanneer van toepassing. Beheerde installatiemappen worden verwijderd, tenzij je --keep-files doorgeeft. In Nix-modus (OPENCLAW_NIX_MODE=1) zijn opdrachten voor het installeren, bijwerken, verwijderen, inschakelen en uitschakelen van plugins uitgeschakeld. Beheer die keuzes in plaats daarvan in de Nix-bron voor de installatie; gebruik voor nix-openclaw de agent-first Snelstart.

Plugins publiceren

Je kunt externe plugins publiceren naar ClawHub, npmjs.com of beide.

Publiceren naar ClawHub

ClawHub is het primaire openbare ontdekkingsoppervlak voor OpenClaw-plugins. Het geeft gebruikers doorzoekbare metadata, versiegeschiedenis en resultaten van registerscans vóór installatie.
npm i -g clawhub
clawhub login
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/your-plugin@v1.0.0
Gebruikers installeren vanuit ClawHub met:
openclaw plugins install clawhub:<package>
openclaw plugins install <package>
De kale vorm controleert nog steeds eerst ClawHub.

Publiceren naar npmjs.com

Native npm-plugins moeten een pluginmanifest en OpenClaw-entrypointmetadata in package.json bevatten.
package.json
{
  "name": "@acme/openclaw-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./dist/index.js"]
  }
}
npm publish --access public
Gebruikers installeren npm-only met:
openclaw plugins install npm:@acme/openclaw-plugin
openclaw plugins install npm:@acme/openclaw-plugin@beta
openclaw plugins install npm:@acme/openclaw-plugin@1.0.0
Als hetzelfde pakket ook beschikbaar is op ClawHub, slaat npm: de ClawHub-lookup over en forceert het npm-resolutie.

Bronkeuze

  • ClawHub: gebruik dit wanneer je OpenClaw-native ontdekking, scansamenvattingen, versies en installatietips wilt.
  • npmjs.com: gebruik dit wanneer je al JavaScript-pakketten levert of npm- dist-tags/private-registerworkflows nodig hebt.
  • Git: gebruik dit wanneer je rechtstreeks vanaf een branch, tag of commit wilt installeren.
  • Lokaal pad: gebruik dit wanneer je een plugin op dezelfde machine ontwikkelt of test.

Gerelateerd