Skip to main content

​
CLI

CLI-pakket: clawhub, bin: clawhub. Installeer het globaal met npm of pnpm: 
npm i -g clawhub
# or
pnpm add -g clawhub
Verifieer het daarna: 
clawhub --help
clawhub login
clawhub whoami

​
Globale flags

  • --workdir <dir>: werkdirectory (standaard: cwd; valt terug op de Clawdbot-werkruimte als die is geconfigureerd)
  • --dir <dir>: installatiedirectory onder workdir (standaard: skills)
  • --site <url>: basis-URL voor browserlogin (standaard: https://clawhub.ai)
  • --registry <url>: API-basis-URL (standaard: gedetecteerd, anders https://clawhub.ai)
  • --no-input: prompts uitschakelen
Env-equivalenten:
  • CLAWHUB_SITE (legacy CLAWDHUB_SITE)
  • CLAWHUB_REGISTRY (legacy CLAWDHUB_REGISTRY)
  • CLAWHUB_WORKDIR (legacy CLAWDHUB_WORKDIR)

​
HTTP-proxy

De CLI respecteert standaard HTTP-proxy-omgevingsvariabelen voor systemen achter bedrijfsproxy’s of beperkte netwerken:
  • HTTPS_PROXY / https_proxy
  • HTTP_PROXY / http_proxy
  • NO_PROXY / no_proxy
Wanneer een van deze variabelen is ingesteld, routeert de CLI uitgaande verzoeken via de opgegeven proxy. HTTPS_PROXY wordt gebruikt voor HTTPS-verzoeken, HTTP_PROXY voor gewone HTTP. NO_PROXY / no_proxy wordt gerespecteerd om de proxy te omzeilen voor specifieke hosts of domeinen. Dit is vereist op systemen waar directe uitgaande verbindingen zijn geblokkeerd (bijv. Docker-containers, Hetzner VPS met alleen proxy-internet, bedrijfsfirewalls). Voorbeeld: 
export HTTPS_PROXY=http://proxy.example.com:3128
export NO_PROXY=localhost,127.0.0.1
clawhub search "my query"
Wanneer er geen proxyvariabele is ingesteld, blijft het gedrag ongewijzigd (directe verbindingen).

​
Configuratiebestand

Slaat je API-token + gecachete registry-URL op.
  • macOS: ~/Library/Application Support/clawhub/config.json
  • Linux/XDG: $XDG_CONFIG_HOME/clawhub/config.json of ~/.config/clawhub/config.json
  • Windows: %APPDATA%\\clawhub\\config.json
  • Legacy fallback: als clawhub/config.json nog niet bestaat maar clawdhub/config.json wel, hergebruikt de CLI het legacy pad
  • override: CLAWHUB_CONFIG_PATH (legacy CLAWDHUB_CONFIG_PATH)

​
Commando’s

​
login / auth login

  • Standaard: opent de browser naar <site>/cli/auth en voltooit via een loopback-callback.
  • Headless: clawhub login --token clh_...
  • Remote/headless interactief: clawhub login --device print een code en wacht terwijl je deze autoriseert op <site>/cli/device.

​
whoami

  • Verifieert het opgeslagen token via /api/v1/whoami.

​
token

  • Print het opgeslagen API-token naar stdout.
  • Handig om een lokaal logintoken door te sturen naar CI-secretconfiguratiecommando’s.

​
star <skill> / unstar <skill>

  • Voegt een skill toe aan of verwijdert deze uit je highlights.
  • Roept POST /api/v1/stars/<slug> en DELETE /api/v1/stars/<slug> aan.
  • --yes slaat bevestiging over.

​
search <query...>

  • Roept /api/v1/search?q=... aan.
  • Uitvoer bevat de skill-slug, owner-handle, weergavenaam en relevantiescore.
  • Zoeken geeft de voorkeur aan exacte slug-/naamtokenmatches boven downloadpopulariteit. Een zelfstandig slug-token zoals map matcht sterker met personal-map dan met de substring binnen amap.
  • Populariteit is een kleine rankingprior, geen garantie op toppositie.
  • Als een skill zou moeten verschijnen maar dat niet doet, voer dan clawhub inspect @owner/slug uit terwijl je bent ingelogd om owner-zichtbare moderatiediagnostiek te controleren voordat je metadata hernoemt.

​
explore

  • Toont nieuwste skills via /api/v1/skills?limit=...&sort=createdAt (gesorteerd op createdAt aflopend).
  • Flags:
    • --limit <n> (1-200, standaard: 25)
    • --sort newest|updated|rating|downloads|trending (standaard: newest). Legacy install-sortaliases blijven werken voor compatibiliteit.
    • --json (machineleesbare uitvoer)
  • Uitvoer: <slug> v<version> <age> <summary> (samenvatting afgekapt tot 50 tekens).

​
inspect @owner/slug

  • Haalt skillmetadata en versiebestanden op zonder te installeren.
  • --version <version>: inspecteer een specifieke versie (standaard: laatste).
  • --tag <tag>: inspecteer een getagde versie (bijv. latest).
  • --versions: toon versiegeschiedenis (eerste pagina).
  • --limit <n>: maximaal aantal te tonen versies (1-200).
  • --files: toon bestanden voor de geselecteerde versie.
  • --file <path>: haal ruwe bestandsinhoud op (alleen tekstbestanden; limiet 200 KB).
  • --json: machineleesbare uitvoer.

​
install @owner/slug

  • Bepaalt de laatste versie voor de genoemde owner en skill.
  • Downloadt zip via /api/v1/download.
  • Pakt uit naar <workdir>/<dir>/<slug>.
  • Weigert vastgezette skills te overschrijven; voer eerst clawhub unpin <skill> uit.
  • Schrijft:
    • <workdir>/.clawhub/lock.json (legacy .clawdhub)
    • <skill>/.clawhub/origin.json (legacy .clawdhub)

​
uninstall <skill>

  • Verwijdert <workdir>/<dir>/<slug> en verwijdert de lockfile-entry.
  • Verstuurt best-effort telemetrie terwijl je bent ingelogd, zodat huidige installatietellingen kunnen worden gedeactiveerd.
  • Interactief: vraagt om bevestiging.
  • Niet-interactief (--no-input): vereist --yes.

​
list

  • Leest <workdir>/.clawhub/lock.json (legacy .clawdhub).
  • Toont pinned naast skills die zijn bevroren met clawhub pin, inclusief de optionele reden.

​
pin <skill>

  • Markeert een geïnstalleerde skill als vastgezet in de lockfile.
  • --reason <text> registreert waarom de skill is bevroren.
  • Vastgezette skills worden overgeslagen door update --all en geweigerd door directe update <skill>.
  • Vastgezette skills weigeren ook install --force, zodat de lokale bytes niet per ongeluk kunnen worden vervangen.

​
unpin <skill>

  • Verwijdert de lockfile-pin van een geïnstalleerde skill zodat toekomstige updates deze kunnen wijzigen.

​
update [@owner/slug] / update --all

  • Berekent de fingerprint uit lokale bestanden.
  • Als de fingerprint overeenkomt met een bekende versie: geen prompt.
  • Als de fingerprint niet overeenkomt:
    • weigert standaard
    • overschrijft met --force (of prompt, indien interactief)
  • Vastgezette skills worden nooit bijgewerkt door --force.
  • update <skill> faalt snel voor vastgezette skills en zegt dat je eerst clawhub unpin <skill> moet uitvoeren.
  • update --all slaat vastgezette slugs over en print een samenvatting van wat bevroren bleef.

​
skill publish <path>

  • Vergelijkt de lokale bundelfingerprint met ClawHub en sluit succesvol af wanneer de inhoud al is gepubliceerd.
  • Nieuwe skills gebruiken standaard 1.0.0; gewijzigde skills gebruiken standaard de volgende patchversie.
  • --version <version> selecteert expliciet een versie en publiceert zelfs wanneer de inhoud overeenkomt met een bestaande versie.
  • --dry-run lost de publicatie op zonder te uploaden; --json print een machineleesbaar resultaat.
  • --owner <handle> publiceert onder een org-/user-publisherhandle wanneer de actor publishertoegang heeft.
  • --migrate-owner verplaatst een bestaande skill naar --owner terwijl een nieuwe versie wordt gepubliceerd. Vereist admin-/ownertoegang bij beide publishers.
  • Owner- en reviewgedrag wordt uitgelegd in docs/publishing.md.
  • Een skill publiceren betekent dat deze onder MIT-0 wordt uitgebracht op ClawHub.
  • Gepubliceerde skills zijn vrij te gebruiken, te wijzigen en opnieuw te distribueren zonder naamsvermelding.
  • ClawHub ondersteunt geen betaalde skills of prijzen per skill.
  • Legacy alias: publish <path>.
clawhub skill publish ./my-skill --dry-run
clawhub skill publish ./my-skill
clawhub skill publish ./my-skill --version 2.0.0

​
GitHub Actions

ClawHub’s herbruikbare skill-publish.yml workflow roept skill publish aan voor één skill_path, of voor elke directe skillmap onder root (standaard: skills). Het slaat ongewijzigde skills over en gebruikt hetzelfde automatische patchversiegedrag. Stel dry_run: true in om zonder token een preview te bekijken. Echte publicaties vereisen de clawhub_token secret.

​
sync

  • Scant de huidige workdir, de geconfigureerde skills-directory en eventuele --root <dir>-mappen op lokale skillmappen die SKILL.md of skill.md bevatten.
  • Vergelijkt elke lokale skillfingerprint met ClawHub en publiceert alleen nieuwe of gewijzigde skills.
  • Nieuwe skills worden gepubliceerd als 1.0.0; gewijzigde skills publiceren standaard de volgende patchversie. Gebruik --bump minor|major voor updatebatches die met een grotere semver-stap moeten opschuiven.
  • --dry-run toont het publicatieplan zonder te uploaden; --json print een machineleesbaar plan.
  • --all publiceert elke nieuwe of gewijzigde skill zonder prompt. Zonder --all laten interactieve terminals je de te publiceren skills selecteren.
  • --owner <handle> publiceert onder een org-/user-publisherhandle wanneer de actor publishertoegang heeft.
  • sync is alleen eenrichtingspublicatie. Het installeert, werkt bij, downloadt of rapporteert geen installatie-/downloadtelemetrie.
clawhub sync --all --dry-run
clawhub sync --all
clawhub sync --root ./skills --owner openclaw --bump minor

​
scan --slug <slug>

  • Vereist clawhub login.
  • Voert ClawHub ClawScan uit via POST /api/v1/skills/-/scan en pollt daarna totdat de scan terminaal is.
  • Scans zijn asynchroon en kunnen tijd kosten om te voltooien. Terwijl ze in de wachtrij staan, toont de terminalspinner de huidige geprioriteerde scanpositie en hoeveel scans ervoor staan.
  • Gepubliceerde scans vereisen ownership of publisherbeheertoegang. Moderators/admins kunnen dezelfde backend gebruiken via clawhub-admin.
  • --update is alleen geldig met --slug; het schrijft succesvolle gepubliceerde scanresultaten terug naar de geselecteerde versie.
  • --output <file.zip> downloadt het volledige rapportarchief met manifest.json, clawscan.json, skillspector.json, static-analysis.json, virustotal.json en README.md.
  • --json print de volledige pollrespons voor automatisering.
  • Lokale padscans worden niet meer ondersteund. Upload een nieuwe versie en gebruik daarna scan download om de opgeslagen scanresultaten voor die ingediende versie op te halen.
clawhub scan --slug gifgrep
clawhub scan --slug gifgrep --version 1.2.3
clawhub scan --slug gifgrep --update --output report.zip

​
scan download <name>

  • Vereist clawhub login.
  • Downloadt de opgeslagen scanrapport-ZIP voor een ingediende skill- of pluginversie, inclusief versies die door ClawHub-beveiligingscontroles zijn geblokkeerd of verborgen.
  • Skilldownloads gebruiken de skill-slug en gebruiken standaard --kind skill.
  • Plugindownloads gebruiken de pakketnaam en vereisen --kind plugin.
  • --version is vereist zodat auteurs de exacte ingediende versie inspecteren die ClawHub heeft geblokkeerd.
  • --output <file.zip> kiest het doelpad.
clawhub scan download gifgrep --version 1.2.3
clawhub scan download @scope/demo --version 2.0.0 --kind plugin --output report.zip

​
GitHub Actions

ClawHub levert een officiële herbruikbare workflow op /.github/workflows/skill-publish.yml voor skillrepo’s en catalogusrepo’s. Typische catalogusconfiguratie: 
name: Skill Publish

on:
  pull_request:
  workflow_dispatch:

jobs:
  dry-run:
    if: github.event_name == 'pull_request'
    uses: openclaw/clawhub/.github/workflows/skill-publish.yml@v1
    with:
      owner: nvidia
      dry_run: true

  publish:
    if: github.event_name == 'workflow_dispatch'
    uses: openclaw/clawhub/.github/workflows/skill-publish.yml@v1
    with:
      owner: nvidia
      dry_run: false
    secrets:
      clawhub_token: ${{ secrets.CLAWHUB_TOKEN }}
Opmerkingen:
  • root gebruikt standaard skills voor catalogusrepo’s.
  • Geef skill_path: skills/review-helper door om één skillmap te verwerken.
  • owner komt overeen met de CLI-flag --owner; laat deze weg om als de geauthenticeerde gebruiker te publiceren.
  • V1-skillpublicatie gebruikt clawhub_token; GitHub OIDC trusted publishing is voorlopig alleen voor pakketten.

​
delete <skill>

  • Zonder --version: markeer een skill als zacht verwijderd (eigenaar, moderator of admin).
  • Roept DELETE /api/v1/skills/{slug} aan.
  • Door de eigenaar gestarte zachte verwijderingen reserveren de slug 30 dagen; de opdracht drukt de vervaltijd af.
  • --version <version> verwijdert permanent één eigen niet-nieuwste versie via een bij fouten gesloten, versiespecifieke route. Verwijderde versies kunnen niet worden hersteld of opnieuw gepubliceerd. Publiceer een vervanging voordat je de huidige nieuwste versie verwijdert. Platformmedewerkers omzeilen eigendom niet voor deze versie-only flow.
  • --reason <text> registreert een moderatienotitie bij een zachte verwijdering van de hele skill en in het auditlog.
  • --note <text> is een alias voor --reason.
  • --yes slaat bevestiging over.

​
undelete <skill>

  • Herstel een verborgen skill (eigenaar, moderator of admin).
  • Er is geen versieherstel; permanent verwijderde versies kunnen niet worden hersteld.
  • Roept POST /api/v1/skills/{slug}/undelete aan.
  • --reason <text> registreert een moderatienotitie bij de skill en in het auditlog.
  • --note <text> is een alias voor --reason.
  • --yes slaat bevestiging over.

​
hide <skill>

  • Verberg een skill (eigenaar, moderator of admin).
  • Alias voor delete.

​
unhide <skill>

  • Maak een skill weer zichtbaar (eigenaar, moderator of admin).
  • Alias voor undelete.

​
skill rename <skill> <new-name>

  • Hernoem een eigen skill en behoud de vorige slug als omleidingsalias.
  • Roept POST /api/v1/skills/{slug}/rename aan.
  • --yes slaat bevestiging over.

​
skill merge <source> <target>

  • Voeg één eigen skill samen met een andere eigen skill.
  • De bronslug wordt niet meer publiek vermeld en wordt een omleidingsalias naar het doel.
  • Roept POST /api/v1/skills/{sourceSlug}/merge aan.
  • --yes slaat bevestiging over.

​
transfer

  • Workflow voor eigendomsoverdracht.
  • Overdrachten naar gebruikershandles maken een openstaand verzoek aan dat de ontvanger accepteert.
  • Overdrachten naar org-/publisherhandles worden alleen direct toegepast wanneer de actor admin-toegang heeft tot zowel de huidige eigenaar als de doelpublisher.
  • Subopdrachten:
    • transfer request <skill> <handle> [--message "..."] [--yes]
    • transfer list [--outgoing]
    • transfer accept <skill> [--yes]
    • transfer reject <skill> [--yes]
    • transfer cancel <skill> [--yes]
  • Endpoints:
    • POST /api/v1/skills/{slug}/transfer
    • POST /api/v1/skills/{slug}/transfer/accept
    • POST /api/v1/skills/{slug}/transfer/reject
    • POST /api/v1/skills/{slug}/transfer/cancel
    • GET /api/v1/transfers/incoming
    • GET /api/v1/transfers/outgoing

​
package explore [query...]

  • Bladert door of zoekt in de uniforme pakketcatalogus via GET /api/v1/packages en GET /api/v1/packages/search.
  • Gebruik dit voor plugins en andere vermeldingen uit pakketfamilies; search op topniveau blijft het zoekoppervlak voor skills.
  • Vlaggen:
    • --family skill|code-plugin|bundle-plugin
    • --official
    • --executes-code
    • --target <target>, --os <os>, --arch <arch>, --libc <libc>
    • --requires-browser, --requires-desktop, --requires-native-deps
    • --requires-external-service, --external-service <name>
    • --binary <name>, --os-permission <name>
    • --artifact-kind legacy-zip|npm-pack
    • --npm-mirror
    • --limit <n> (1-100, standaard: 25)
    • --json
Voorbeelden: 
clawhub package explore --family code-plugin
clawhub package explore --family code-plugin --os darwin --requires-desktop
clawhub package explore --family code-plugin --artifact-kind npm-pack
clawhub package explore --npm-mirror
clawhub package explore episodic-claw --family code-plugin

​
package inspect <name>

  • Haalt pakketmetadata op zonder te installeren.
  • Gebruik dit voor pluginmetadata, compatibiliteit, verificatie, bron en versie-/bestandsinspectie.
  • --version <version>: inspecteer een specifieke versie (standaard: nieuwste).
  • --tag <tag>: inspecteer een getagde versie (bijv. latest).
  • --versions: vermeld versiegeschiedenis (eerste pagina).
  • --limit <n>: maximaal aantal te vermelden versies (1-100).
  • --files: vermeld bestanden voor de geselecteerde versie.
  • --file <path>: haal ruwe bestandsinhoud op (alleen tekstbestanden; limiet van 200 KB).
  • --json: machineleesbare uitvoer.

​
package download <name>

  • Lost een pakketversie op via GET /api/v1/packages/{name}/versions/{version}/artifact.
  • Downloadt het artefact vanaf de downloadUrl van de resolver.
  • Verifieert ClawHub SHA-256 voor alle artefacten.
  • Voor ClawPack npm-pack-artefacten verifieert dit ook npm sha512-integriteit, npm shasum en de naam/versie in package.json van de tarball.
  • Legacy ZIP-versies worden gedownload via de legacy ZIP-route.
  • Vlaggen:
    • --version <version>: download een specifieke versie.
    • --tag <tag>: download een getagde versie (standaard: latest).
    • -o, --output <path>: uitvoerbestand of -map.
    • --force: overschrijf een bestaand uitvoerbestand.
    • --json: machineleesbare uitvoer.
Voorbeelden: 
clawhub package download @openclaw/example-plugin --tag latest
clawhub package download @openclaw/example-plugin --version 1.2.3 -o artifacts/

​
package verify <file>

  • Berekent ClawHub SHA-256, npm sha512-integriteit en npm shasum voor een lokaal artefact.
  • Met --package wordt verwachte metadata uit ClawHub opgelost en wordt het lokale bestand vergeleken met de gepubliceerde artefactmetadata.
  • Met directe digestvlaggen wordt geverifieerd zonder netwerkopzoeking.
  • Vlaggen:
    • --package <name>: pakketnaam om verwachte artefactmetadata op te lossen.
    • --version <version> of --tag <tag>: verwachte pakketversie.
    • --sha256 <hex>: verwachte ClawHub SHA-256.
    • --npm-integrity <sri>: verwachte npm-integriteit.
    • --npm-shasum <sha1>: verwachte npm shasum.
    • --json: machineleesbare uitvoer.
Voorbeelden: 
clawhub package verify ./example-plugin-1.2.3.tgz --package @openclaw/example-plugin --version 1.2.3
clawhub package verify ./example-plugin-1.2.3.tgz --sha256 <hex>

​
package validate <source>

  • Voert de gebundelde Plugin Inspector van de ClawHub CLI uit op een lokale pluginpakketmap.
  • Standaard wordt offline/statische validatie uitgevoerd, zonder een lokale OpenClaw-checkout te lokaliseren of importeren.
  • Harde compatibiliteitsfouten eindigen met een niet-nulstatus. Bevindingen met alleen waarschuwingen worden afgedrukt maar eindigen met nul.
  • Vlaggen:
    • --out <dir>: schrijf Plugin Inspector-rapporten naar deze map.
    • --openclaw <path>: inspecteer tegen een expliciete lokale OpenClaw-checkout.
    • --runtime: schakel runtime-vastlegging in; importeert plugincode.
    • --allow-execute: sta runtime-vastlegging toe in een geïsoleerde werkruimte.
    • --no-mock-sdk: schakel de gemockte OpenClaw SDK uit tijdens runtime-vastlegging.
    • --json: machineleesbare uitvoer.
Voorbeeld: 
clawhub package validate ./example-plugin
Als validatie een bevinding over een pakket, manifest, SDK-import of artefact rapporteert, zie Oplossingen voor pluginvalidatie en voer daarna de opdracht opnieuw uit.

​
package delete <name>

  • Zonder --version: markeert een pakket en alle releases als zacht verwijderd.
  • --version <version> verwijdert permanent één eigen niet-nieuwste release via een bij fouten gesloten, versiespecifieke route. Verwijderde versies kunnen niet worden hersteld of opnieuw gepubliceerd. Publiceer een vervanging voordat je de huidige nieuwste versie verwijdert. Deze versie-only flow vereist de pakketeigenaar of een admin van een org-publisher; platformmedewerkers omzeilen pakketeigendom niet.
  • Zachte verwijdering van het hele pakket vereist de pakketeigenaar, een eigenaar/admin van een org-publisher, platformmoderator of platformadmin.
  • Vlaggen:
    • --version <version>: verwijder permanent één niet-nieuwste versie.
    • --yes: sla bevestiging over.
    • --json: machineleesbare uitvoer.
Voorbeeld: 
clawhub package delete @openclaw/example-plugin --yes
clawhub package delete @openclaw/example-plugin --version 1.2.3 --yes

​
package undelete <name>

  • Herstelt een zacht verwijderd pakket en releases.
  • Er is geen versieherstel; permanent verwijderde versies kunnen niet worden hersteld.
  • Vereist de pakketeigenaar, een eigenaar/admin van een org-publisher, platformmoderator of platformadmin.
  • Roept POST /api/v1/packages/{name}/undelete aan.
  • Vlaggen:
    • --yes: sla bevestiging over.
    • --json: machineleesbare uitvoer.
Voorbeeld: 
clawhub package undelete @openclaw/example-plugin --yes

​
package transfer <name>

  • Draagt een pakket over aan een andere publisher.
  • Vereist admin-toegang tot zowel de huidige pakketeigenaar als de doelpublisher, tenzij uitgevoerd door een platformadmin.
  • Scoped pakketnamen moeten worden overgedragen aan de overeenkomende scope-eigenaar.
  • Roept POST /api/v1/packages/{name}/transfer aan.
  • Vlaggen:
    • --to <owner>: handle van de doelpublisher.
    • --reason <text>: optionele auditreden.
    • --json: machineleesbare uitvoer.
Voorbeeld: 
clawhub package transfer @openclaw/example-plugin --to openclaw

​
package report

  • Geauthenticeerde opdracht om een pakket aan moderators te melden.
  • Roept POST /api/v1/packages/{name}/report aan.
  • Meldingen zijn op pakketniveau, optioneel gekoppeld aan een versie, en worden zichtbaar voor moderators voor beoordeling.
  • Meldingen verbergen pakketten niet automatisch en blokkeren downloads niet op zichzelf.
  • Vlaggen:
    • --version <version>: optionele pakketversie om aan de melding te koppelen.
    • --reason <text>: vereiste meldingsreden.
    • --json: machineleesbare uitvoer.
Voorbeeld: 
clawhub package report @openclaw/example-plugin --version 1.2.3 --reason "suspicious native payload"

​
package moderation-status

  • Eigenaaropdracht om de moderatiezichtbaarheid van een pakket te controleren.
  • Roept GET /api/v1/packages/{name}/moderation aan.
  • Toont de huidige scansstatus van het pakket, het aantal open meldingen, de handmatige moderatiestatus van de nieuwste release, de downloadblokkeringsstatus en moderatieredenen.
  • Vlaggen:
    • --json: machineleesbare uitvoer.
Voorbeeld: 
clawhub package moderation-status @openclaw/example-plugin

​
package readiness <name>

  • Controleert of een pakket klaar is voor toekomstig gebruik door OpenClaw.
  • Roept GET /api/v1/packages/{name}/readiness aan.
  • Rapporteert blokkers voor officiële status, ClawPack-beschikbaarheid, artefactdigest, bronherkomst, OpenClaw-compatibiliteit, hostdoelen, omgevingsmetadata en scansstatus.
  • Vlaggen:
    • --json: machineleesbare uitvoer.
Voorbeeld: 
clawhub package readiness @openclaw/example-plugin

​
package migration-status <name>

  • Toont operatorgerichte migratiestatus voor een pakket dat een gebundelde OpenClaw-plugin kan vervangen.
  • Roept hetzelfde berekende readiness-endpoint aan als package readiness, maar drukt migratiegerichte status, nieuwste versie, officiële-pakketstatus, controles en blokkers af.
  • Vlaggen:
    • --json: machineleesbare uitvoer.
Voorbeeld: 
clawhub package migration-status @openclaw/example-plugin

​
publisher create <handle>

  • Maakt een org-publisher aan die eigendom is van de geauthenticeerde gebruiker.
  • De handle wordt genormaliseerd naar kleine letters en kan met of zonder @ worden doorgegeven.
  • Nieuw aangemaakte org-publishers zijn standaard niet vertrouwd/officieel.
  • Mislukt als de handle al wordt gebruikt door een bestaande publisher, gebruiker of gereserveerde route.
clawhub publisher create opik --display-name "Opik"

​
package publish <source>

  • Publiceert een codeplugin of bundelplugin via POST /api/v1/packages.
  • <source> accepteert:
    • Lokaal mappad: ./my-plugin
    • Lokale ClawPack npm-pack-tarball: ./my-plugin-1.2.3.tgz
    • GitHub-repo: owner/repo of owner/repo@ref
    • GitHub-URL: https://github.com/owner/repo
  • Metadata wordt automatisch gedetecteerd uit package.json, openclaw.plugin.json en echte OpenClaw-bundelmarkeringen zoals .codex-plugin/plugin.json, .claude-plugin/plugin.json en .cursor-plugin/plugin.json.
  • .tgz-bronnen worden behandeld als ClawPack. De CLI uploadt de exacte npm-pack- bytes en gebruikt de uitgepakte package/-inhoud alleen voor validatie en het vooraf invullen van metadata.
  • Codepluginmappen worden vóór upload verpakt in een ClawPack npm-tarball zodat OpenClaw-installaties het exacte artifact kunnen verifiëren. Bundelpluginmappen blijven het publicatiepad met uitgepakte bestanden gebruiken.
  • Voor GitHub-bronnen wordt bronattributie automatisch ingevuld vanuit de repo, opgeloste commit, ref en subpad.
  • Voor lokale mappen wordt bronattributie automatisch gedetecteerd uit lokale git wanneer de origin-remote naar GitHub wijst.
  • Externe codeplugins moeten openclaw.compat.pluginApi en openclaw.build.openclawVersion expliciet declareren. package.json.version op topniveau wordt niet gebruikt als fallback voor publicatievalidatie.
  • --dry-run toont een voorbeeld van de opgeloste publicatiepayload zonder te uploaden.
  • --json geeft machineleesbare uitvoer voor CI.
  • --owner <handle> publiceert onder een gebruikers- of organisatiepublisher-handle wanneer de actor publishertoegang heeft.
  • Scoped pakketnamen moeten overeenkomen met de geselecteerde eigenaar. Zie docs/publishing.md.
  • Bestaande flags (--family, --name, --version, --source-repo, --source-commit, --source-ref, --source-path) blijven werken als overschrijvingen.
  • Privé-GitHub-repo’s vereisen GITHUB_TOKEN.
clawhub package publish ./plugin.tgz --owner openclaw

​
Aanbevolen lokale flow

Gebruik eerst --dry-run zodat je de opgeloste pakketmetadata en bronattributie kunt bevestigen voordat je een live release maakt: 
npm pack
clawhub package publish ./my-plugin-1.2.3.tgz --family code-plugin --dry-run
clawhub package publish ./my-plugin-1.2.3.tgz --family code-plugin

​
Lokale mapflow

Voor codeplugins bouwt en uploadt publiceren vanuit een map een ClawPack-artifact uit de pakketmap: 
clawhub package publish ./my-plugin --family code-plugin --dry-run
clawhub package publish ./my-plugin --family code-plugin

​
Minimale package.json voor --family code-plugin

Externe codeplugins hebben een kleine hoeveelheid OpenClaw-metadata nodig in package.json. Dit minimale manifest is genoeg voor een succesvolle publicatie: 
{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./index.ts"],
    "compat": {
      "pluginApi": ">=2026.3.24-beta.2"
    },
    "build": {
      "openclawVersion": "2026.3.24-beta.2"
    }
  }
}
Vereiste velden:
  • openclaw.compat.pluginApi
  • openclaw.build.openclawVersion
Opmerkingen:
  • package.json.version is de releaseversie van je pakket, maar wordt niet gebruikt als fallback voor OpenClaw-compatibiliteits-/buildvalidatie.
  • openclaw.hostTargets en openclaw.environment zijn optionele metadata. ClawHub kan ze tonen wanneer ze aanwezig zijn, maar ze zijn niet vereist voor publicatie.
  • openclaw.compat.minGatewayVersion en openclaw.build.pluginSdkVersion zijn optionele extra’s als je meer gedetailleerde compatibiliteitsmetadata wilt publiceren.
  • Als je een oudere clawhub CLI-release gebruikt, upgrade dan vóór publicatie zodat de lokale preflightcontroles vóór upload worden uitgevoerd.
  • Als validatie een herstelcode rapporteert, zie Pluginvalidatiefixes.

​
GitHub Actions

ClawHub levert ook een officiële herbruikbare workflow op /.github/workflows/package-publish.yml voor pluginrepo’s. Typische caller-configuratie: 
name: Package Publish

on:
  pull_request:
  workflow_dispatch:
  push:
    tags:
      - "v*"

jobs:
  dry-run:
    if: github.event_name == 'pull_request'
    uses: openclaw/clawhub/.github/workflows/package-publish.yml@v0.12.0
    with:
      dry_run: true

  publish:
    if: github.event_name == 'workflow_dispatch' || startsWith(github.ref, 'refs/tags/')
    permissions:
      contents: read
      id-token: write
    uses: openclaw/clawhub/.github/workflows/package-publish.yml@v0.12.0
    with:
      dry_run: false
    secrets:
      clawhub_token: ${{ secrets.CLAWHUB_TOKEN }}
Opmerkingen:
  • De herbruikbare workflow stelt source standaard in op de caller-repo.
  • Geef voor monorepo’s source_path mee zodat de workflow de plugin- pakketmap publiceert, bijvoorbeeld source_path: extensions/codex.
  • Pin de herbruikbare workflow op een stabiele tag of volledige commit-SHA. Voer releasepublicatie niet uit vanaf @main.
  • pull_request moet dry_run: true gebruiken zodat CI niet-vervuilend blijft.
  • Echte publicaties moeten beperkt blijven tot vertrouwde events zoals workflow_dispatch of tag-pushes.
  • Vertrouwd publiceren zonder secret werkt alleen op workflow_dispatch; tag-pushes hebben nog steeds clawhub_token nodig.
  • Houd clawhub_token beschikbaar voor eerste publicatie, niet-vertrouwde pakketten of break-glass-publicaties.
  • De workflow uploadt het JSON-resultaat als artifact en stelt het beschikbaar als workflow-uitvoer.

​
package trusted-publisher get <name>

  • Toont de GitHub Actions-configuratie voor trusted publisher voor een pakket.
  • Gebruik dit na het instellen van de configuratie om de repository, workflowbestandsnaam en optionele omgevingpin te bevestigen.
  • Flags:
    • --json: machineleesbare uitvoer.
Voorbeeld: 
clawhub package trusted-publisher get @openclaw/example-plugin

​
package trusted-publisher set <name>

  • Koppelt of vervangt GitHub Actions-configuratie voor trusted publisher voor een bestaand pakket.
  • Het pakket moet eerst worden aangemaakt via normale handmatige of token-geauthenticeerde clawhub package publish.
  • Nadat de configuratie is ingesteld, kunnen toekomstige ondersteunde GitHub Actions-publicaties OIDC/trusted publishing gebruiken zonder langlevende ClawHub-token.
  • --repository <repo> moet owner/repo zijn.
  • --workflow-filename <file> moet overeenkomen met de workflowbestandsnaam in .github/workflows/.
  • --environment <name> is optioneel. Wanneer geconfigureerd moet de GitHub Actions- omgeving in de OIDC-claim exact overeenkomen.
  • ClawHub verifieert de geconfigureerde GitHub-repository wanneer deze opdracht wordt uitgevoerd. Publieke repositories kunnen worden geverifieerd via publieke GitHub-metadata. Privé- repositories vereisen dat ClawHub GitHub-toegang tot die repository heeft, bijvoorbeeld via een toekomstige ClawHub GitHub App-installatie of een andere geautoriseerde GitHub-integratie.
  • Flags:
    • --repository <repo>: GitHub-repository, bijvoorbeeld openclaw/example-plugin.
    • --workflow-filename <file>: workflowbestandsnaam, bijvoorbeeld package-publish.yml.
    • --environment <name>: optionele exact-overeenkomende GitHub Actions-omgeving.
    • --json: machineleesbare uitvoer.
Voorbeeld: 
clawhub package trusted-publisher set @openclaw/example-plugin \
  --repository openclaw/example-plugin \
  --workflow-filename package-publish.yml \
  --environment release

​
package trusted-publisher delete <name>

  • Verwijdert trusted publisher-configuratie uit een pakket.
  • Gebruik dit als rollback als de workflow, repository of omgevingpin moet worden uitgeschakeld of opnieuw aangemaakt.
  • Toekomstige echte publicaties moeten normale geauthenticeerde publicatie gebruiken totdat de configuratie opnieuw is ingesteld.
  • Flags:
    • --json: machineleesbare uitvoer.
Voorbeeld: 
clawhub package trusted-publisher delete @openclaw/example-plugin

​
Installatietelemetrie

  • Verzonden na clawhub install <slug> wanneer je bent ingelogd, tenzij CLAWHUB_DISABLE_TELEMETRY=1 is ingesteld.
  • Rapportage is best-effort. Installatieopdrachten mislukken niet als telemetrie niet beschikbaar is.
  • Details: docs/telemetry.md.