> ## 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. # Cli # CLI CLI-pakket: `clawhub`, bin: `clawhub`. Installeer het globaal met npm of pnpm: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} npm i -g clawhub # or pnpm add -g clawhub ``` Verifieer het daarna: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub --help clawhub login clawhub whoami ``` ## Globale flags * `--workdir `: werkdirectory (standaard: cwd; valt terug op de Clawdbot-werkruimte als die is geconfigureerd) * `--dir `: installatiedirectory onder workdir (standaard: `skills`) * `--site `: basis-URL voor browserlogin (standaard: `https://clawhub.ai`) * `--registry `: 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 `/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 `/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 ` / `unstar ` * Voegt een skill toe aan of verwijdert deze uit je highlights. * Roept `POST /api/v1/stars/` en `DELETE /api/v1/stars/` aan. * `--yes` slaat bevestiging over. ### `search ` * 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 ` (1-200, standaard: 25) * `--sort newest|updated|rating|downloads|trending` (standaard: newest). Legacy install-sortaliases blijven werken voor compatibiliteit. * `--json` (machineleesbare uitvoer) * Uitvoer: ` v ` (samenvatting afgekapt tot 50 tekens). ### `inspect @owner/slug` * Haalt skillmetadata en versiebestanden op zonder te installeren. * `--version `: inspecteer een specifieke versie (standaard: laatste). * `--tag `: inspecteer een getagde versie (bijv. `latest`). * `--versions`: toon versiegeschiedenis (eerste pagina). * `--limit `: maximaal aantal te tonen versies (1-200). * `--files`: toon bestanden voor de geselecteerde versie. * `--file `: 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 `//`. * Weigert vastgezette skills te overschrijven; voer eerst `clawhub unpin ` uit. * Schrijft: * `/.clawhub/lock.json` (legacy `.clawdhub`) * `/.clawhub/origin.json` (legacy `.clawdhub`) ### `uninstall ` * Verwijdert `//` 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 `/.clawhub/lock.json` (legacy `.clawdhub`). * Toont `pinned` naast skills die zijn bevroren met `clawhub pin`, inclusief de optionele reden. ### `pin ` * Markeert een geïnstalleerde skill als vastgezet in de lockfile. * `--reason ` registreert waarom de skill is bevroren. * Vastgezette skills worden overgeslagen door `update --all` en geweigerd door directe `update `. * Vastgezette skills weigeren ook `install --force`, zodat de lokale bytes niet per ongeluk kunnen worden vervangen. ### `unpin ` * 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 ` faalt snel voor vastgezette skills en zegt dat je eerst `clawhub unpin ` moet uitvoeren. * `update --all` slaat vastgezette slugs over en print een samenvatting van wat bevroren bleef. ### `skill publish ` * 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 ` 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 ` 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 `. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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`](https://github.com/openclaw/clawhub/blob/main/.github/workflows/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 `-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 ` 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. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub sync --all --dry-run clawhub sync --all clawhub sync --root ./skills --owner openclaw --bump minor ``` ### `scan --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 ` 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. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub scan --slug gifgrep clawhub scan --slug gifgrep --version 1.2.3 clawhub scan --slug gifgrep --update --output report.zip ``` ### `scan download ` * 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 ` kiest het doelpad. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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`](https://github.com/openclaw/clawhub/blob/76b4f36bb0f7409ed7cb9c6fd6f1ccf81396ee88/.github/workflows/skill-publish.yml) voor skillrepo's en catalogusrepo's. Typische catalogusconfiguratie: ```yaml theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 ` * 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 ` 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 ` registreert een moderatienotitie bij een zachte verwijdering van de hele skill en in het auditlog. * `--note ` is een alias voor `--reason`. * `--yes` slaat bevestiging over. ### `undelete ` * 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 ` registreert een moderatienotitie bij de skill en in het auditlog. * `--note ` is een alias voor `--reason`. * `--yes` slaat bevestiging over. ### `hide ` * Verberg een skill (eigenaar, moderator of admin). * Alias voor `delete`. ### `unhide ` * Maak een skill weer zichtbaar (eigenaar, moderator of admin). * Alias voor `undelete`. ### `skill rename ` * 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 ` * 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 [--message "..."] [--yes]` * `transfer list [--outgoing]` * `transfer accept [--yes]` * `transfer reject [--yes]` * `transfer cancel [--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 `, `--os `, `--arch `, `--libc ` * `--requires-browser`, `--requires-desktop`, `--requires-native-deps` * `--requires-external-service`, `--external-service ` * `--binary `, `--os-permission ` * `--artifact-kind legacy-zip|npm-pack` * `--npm-mirror` * `--limit ` (1-100, standaard: 25) * `--json` Voorbeelden: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 ` * Haalt pakketmetadata op zonder te installeren. * Gebruik dit voor pluginmetadata, compatibiliteit, verificatie, bron en versie-/bestandsinspectie. * `--version `: inspecteer een specifieke versie (standaard: nieuwste). * `--tag `: inspecteer een getagde versie (bijv. `latest`). * `--versions`: vermeld versiegeschiedenis (eerste pagina). * `--limit `: maximaal aantal te vermelden versies (1-100). * `--files`: vermeld bestanden voor de geselecteerde versie. * `--file `: haal ruwe bestandsinhoud op (alleen tekstbestanden; limiet van 200 KB). * `--json`: machineleesbare uitvoer. ### `package download ` * 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 `: download een specifieke versie. * `--tag `: download een getagde versie (standaard: `latest`). * `-o, --output `: uitvoerbestand of -map. * `--force`: overschrijf een bestaand uitvoerbestand. * `--json`: machineleesbare uitvoer. Voorbeelden: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package download @openclaw/example-plugin --tag latest clawhub package download @openclaw/example-plugin --version 1.2.3 -o artifacts/ ``` ### `package verify ` * 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 `: pakketnaam om verwachte artefactmetadata op te lossen. * `--version ` of `--tag `: verwachte pakketversie. * `--sha256 `: verwachte ClawHub SHA-256. * `--npm-integrity `: verwachte npm-integriteit. * `--npm-shasum `: verwachte npm shasum. * `--json`: machineleesbare uitvoer. Voorbeelden: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 ``` ### `package validate ` * 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 `: schrijf Plugin Inspector-rapporten naar deze map. * `--openclaw `: 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package validate ./example-plugin ``` Als validatie een bevinding over een pakket, manifest, SDK-import of artefact rapporteert, zie [Oplossingen voor pluginvalidatie](/clawhub/plugin-validation-fixes) en voer daarna de opdracht opnieuw uit. ### `package delete ` * Zonder `--version`: markeert een pakket en alle releases als zacht verwijderd. * `--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 `: verwijder permanent één niet-nieuwste versie. * `--yes`: sla bevestiging over. * `--json`: machineleesbare uitvoer. Voorbeeld: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package delete @openclaw/example-plugin --yes clawhub package delete @openclaw/example-plugin --version 1.2.3 --yes ``` ### `package undelete ` * 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package undelete @openclaw/example-plugin --yes ``` ### `package transfer ` * 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 `: handle van de doelpublisher. * `--reason `: optionele auditreden. * `--json`: machineleesbare uitvoer. Voorbeeld: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 `: optionele pakketversie om aan de melding te koppelen. * `--reason `: vereiste meldingsreden. * `--json`: machineleesbare uitvoer. Voorbeeld: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package moderation-status @openclaw/example-plugin ``` ### `package readiness ` * 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package readiness @openclaw/example-plugin ``` ### `package migration-status ` * 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package migration-status @openclaw/example-plugin ``` ### `publisher create ` * 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. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub publisher create opik --display-name "Opik" ``` ### `package publish ` * Publiceert een codeplugin of bundelplugin via `POST /api/v1/packages`. * `` 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 ` 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`. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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](/clawhub/plugin-validation-fixes). #### GitHub Actions ClawHub levert ook een officiële herbruikbare workflow op [`/.github/workflows/package-publish.yml`](https://github.com/openclaw/clawhub/blob/76b4f36bb0f7409ed7cb9c6fd6f1ccf81396ee88/.github/workflows/package-publish.yml) voor pluginrepo's. Typische caller-configuratie: ```yaml theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 ` * 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package trusted-publisher get @openclaw/example-plugin ``` ### `package trusted-publisher set ` * 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 ` moet `owner/repo` zijn. * `--workflow-filename ` moet overeenkomen met de workflowbestandsnaam in `.github/workflows/`. * `--environment ` 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 `: GitHub-repository, bijvoorbeeld `openclaw/example-plugin`. * `--workflow-filename `: workflowbestandsnaam, bijvoorbeeld `package-publish.yml`. * `--environment `: optionele exact-overeenkomende GitHub Actions-omgeving. * `--json`: machineleesbare uitvoer. Voorbeeld: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package trusted-publisher set @openclaw/example-plugin \ --repository openclaw/example-plugin \ --workflow-filename package-publish.yml \ --environment release ``` ### `package trusted-publisher delete ` * 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: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package trusted-publisher delete @openclaw/example-plugin ``` ### Installatietelemetrie * Verzonden na `clawhub install ` 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`.