--- read_when: - ClawHub-CLI verwenden - Installation, Aktualisierung oder Veröffentlichung debuggen summary: 'CLI-Referenz: Befehle, Flags, Konfiguration und Lockfile-Verhalten.' x-i18n: generated_at: "2026-07-03T15:22:31Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 23065775d74e7b52ed250051b8724b780c28dfdfc0adf9b8f115f7133fbdd77b source_path: clawhub/cli.md workflow: 16 --- # CLI CLI-Paket: `clawhub`, Binärdatei: `clawhub`. Installieren Sie es global mit npm oder pnpm: ```bash npm i -g clawhub # or pnpm add -g clawhub ``` Überprüfen Sie es anschließend: ```bash clawhub --help clawhub login clawhub whoami ``` ## Globale Flags - `--workdir `: Arbeitsverzeichnis (Standard: cwd; fällt auf den Clawdbot-Arbeitsbereich zurück, falls konfiguriert) - `--dir `: Installationsverzeichnis unterhalb von workdir (Standard: `skills`) - `--site `: Basis-URL für Browser-Login (Standard: `https://clawhub.ai`) - `--registry `: API-Basis-URL (Standard: erkannt, sonst `https://clawhub.ai`) - `--no-input`: Eingabeaufforderungen deaktivieren Env-Entsprechungen: - `CLAWHUB_SITE` (Legacy `CLAWDHUB_SITE`) - `CLAWHUB_REGISTRY` (Legacy `CLAWDHUB_REGISTRY`) - `CLAWHUB_WORKDIR` (Legacy `CLAWDHUB_WORKDIR`) ### HTTP-Proxy Die CLI berücksichtigt standardmäßige HTTP-Proxy-Umgebungsvariablen für Systeme hinter Unternehmens-Proxys oder eingeschränkten Netzwerken: - `HTTPS_PROXY` / `https_proxy` - `HTTP_PROXY` / `http_proxy` - `NO_PROXY` / `no_proxy` Wenn eine dieser Variablen gesetzt ist, leitet die CLI ausgehende Anfragen über den angegebenen Proxy. `HTTPS_PROXY` wird für HTTPS-Anfragen verwendet, `HTTP_PROXY` für einfaches HTTP. `NO_PROXY` / `no_proxy` wird berücksichtigt, um den Proxy für bestimmte Hosts oder Domains zu umgehen. Dies ist auf Systemen erforderlich, auf denen direkte ausgehende Verbindungen blockiert sind (z. B. Docker-Container, Hetzner-VPS mit Proxy-only-Internet, Unternehmens-Firewalls). Beispiel: ```bash export HTTPS_PROXY=http://proxy.example.com:3128 export NO_PROXY=localhost,127.0.0.1 clawhub search "my query" ``` Wenn keine Proxy-Variable gesetzt ist, bleibt das Verhalten unverändert (direkte Verbindungen). ## Konfigurationsdatei Speichert Ihr API-Token und die zwischengespeicherte Registry-URL. - macOS: `~/Library/Application Support/clawhub/config.json` - Linux/XDG: `$XDG_CONFIG_HOME/clawhub/config.json` oder `~/.config/clawhub/config.json` - Windows: `%APPDATA%\\clawhub\\config.json` - Legacy-Fallback: Wenn `clawhub/config.json` noch nicht vorhanden ist, aber `clawdhub/config.json` existiert, verwendet die CLI den Legacy-Pfad weiter - Überschreibung: `CLAWHUB_CONFIG_PATH` (Legacy `CLAWDHUB_CONFIG_PATH`) ## Befehle ### `login` / `auth login` - Standard: Öffnet den Browser unter `/cli/auth` und schließt über einen local loopback-Callback ab. - Headless: `clawhub login --token clh_...` - Remote/headless interaktiv: `clawhub login --device` gibt einen Code aus und wartet, während Sie ihn unter `/cli/device` autorisieren. ### `whoami` - Überprüft das gespeicherte Token über `/api/v1/whoami`. ### `token` - Gibt das gespeicherte API-Token auf stdout aus. - Nützlich, um ein lokales Login-Token per Pipe in CI-Secret-Einrichtungsbefehle zu übergeben. ### `star ` / `unstar ` - Fügt einen Skill zu Ihren Highlights hinzu oder entfernt ihn daraus. - Ruft `POST /api/v1/stars/` und `DELETE /api/v1/stars/` auf. - `--yes` überspringt die Bestätigung. ### `search ` - Ruft `/api/v1/search?q=...` auf. - Die Ausgabe enthält den Skill-Slug, den Owner-Handle, den Anzeigenamen und den Relevanzwert. - Die Suche bevorzugt exakte Slug-/Name-Token-Treffer vor Download-Popularität. Ein eigenständiges Slug-Token wie `map` passt stärker zu `personal-map` als zur Teilzeichenfolge in `amap`. - Popularität ist ein kleiner Ranking-Prior, keine Garantie für eine Spitzenplatzierung. - Wenn ein Skill erscheinen sollte, aber nicht erscheint, führen Sie angemeldet `clawhub inspect @owner/slug` aus, um owner-sichtbare Moderationsdiagnosen zu prüfen, bevor Sie Metadaten umbenennen. ### `explore` - Listet die neuesten Skills über `/api/v1/skills?limit=...&sort=createdAt` auf (absteigend nach `createdAt` sortiert). - Flags: - `--limit ` (1-200, Standard: 25) - `--sort newest|updated|rating|downloads|trending` (Standard: newest). Legacy-Installationssortier-Aliasse funktionieren aus Kompatibilitätsgründen weiterhin. - `--json` (maschinenlesbare Ausgabe) - Ausgabe: ` v ` (Zusammenfassung auf 50 Zeichen gekürzt). ### `inspect @owner/slug` - Ruft Skill-Metadaten und Versionsdateien ab, ohne zu installieren. - `--version `: Eine bestimmte Version prüfen (Standard: latest). - `--tag `: Eine getaggte Version prüfen (z. B. `latest`). - `--versions`: Versionsverlauf auflisten (erste Seite). - `--limit `: Maximale Anzahl aufzulistender Versionen (1-200). - `--files`: Dateien für die ausgewählte Version auflisten. - `--file `: Rohdateiinhalt abrufen (nur Textdateien; 200-KB-Limit). - `--json`: Maschinenlesbare Ausgabe. ### `install @owner/slug` - Ermittelt die neueste Version für den genannten Owner und Skill. - Lädt ZIP über `/api/v1/download` herunter. - Extrahiert nach `//`. - Verweigert das Überschreiben angepinnter Skills; führen Sie zuerst `clawhub unpin ` aus. - Schreibt: - `/.clawhub/lock.json` (Legacy `.clawdhub`) - `/.clawhub/origin.json` (Legacy `.clawdhub`) ### `uninstall ` - Entfernt `//` und löscht den Lockfile-Eintrag. - Sendet bestmögliche Telemetrie, während Sie angemeldet sind, damit aktuelle Installationszahlen deaktiviert werden können. - Interaktiv: fragt nach Bestätigung. - Nicht interaktiv (`--no-input`): erfordert `--yes`. ### `list` - Liest `/.clawhub/lock.json` (Legacy `.clawdhub`). - Zeigt `pinned` neben Skills an, die mit `clawhub pin` eingefroren wurden, einschließlich des optionalen Grundes. ### `pin ` - Markiert einen installierten Skill im Lockfile als angepinnt. - `--reason ` zeichnet auf, warum der Skill eingefroren ist. - Angepinnte Skills werden von `update --all` übersprungen und von direktem `update ` abgelehnt. - Angepinnte Skills lehnen außerdem `install --force` ab, damit die lokalen Bytes nicht versehentlich ersetzt werden können. ### `unpin ` - Entfernt den Lockfile-Pin von einem installierten Skill, damit künftige Updates ihn ändern können. ### `update [@owner/slug]` / `update --all` - Berechnet den Fingerprint aus lokalen Dateien. - Wenn der Fingerprint einer bekannten Version entspricht: keine Eingabeaufforderung. - Wenn der Fingerprint nicht übereinstimmt: - verweigert standardmäßig - überschreibt mit `--force` (oder Eingabeaufforderung, falls interaktiv) - Angepinnte Skills werden niemals durch `--force` aktualisiert. - `update ` schlägt bei angepinnten Skills schnell fehl und weist Sie an, zuerst `clawhub unpin ` auszuführen. - `update --all` überspringt angepinnte Slugs und gibt eine Zusammenfassung aus, was eingefroren blieb. ### `skill publish ` - Vergleicht den lokalen Bundle-Fingerprint mit ClawHub und beendet erfolgreich, wenn der Inhalt bereits veröffentlicht ist. - Neue Skills verwenden standardmäßig `1.0.0`; geänderte Skills verwenden standardmäßig die nächste Patch-Version. - `--version ` wählt explizit eine Version aus und veröffentlicht auch dann, wenn der Inhalt einer vorhandenen Version entspricht. - `--dry-run` löst die Veröffentlichung auf, ohne hochzuladen; `--json` gibt ein maschinenlesbares Ergebnis aus. - `--owner ` veröffentlicht unter einem Org-/User-Publisher-Handle, wenn der Akteur Publisher-Zugriff hat. - `--migrate-owner` verschiebt einen bestehenden Skill zu `--owner`, während eine neue Version veröffentlicht wird. Erfordert Admin-/Owner-Zugriff auf beide Publisher. - Owner- und Review-Verhalten wird in `docs/publishing.md` erläutert. - Das Veröffentlichen eines Skills bedeutet, dass er auf ClawHub unter `MIT-0` freigegeben wird. - Veröffentlichte Skills dürfen kostenlos genutzt, geändert und ohne Namensnennung weiterverbreitet werden. - ClawHub unterstützt keine kostenpflichtigen Skills oder Preise pro Skill. - Legacy-Alias: `publish `. ```bash clawhub skill publish ./my-skill --dry-run clawhub skill publish ./my-skill clawhub skill publish ./my-skill --version 2.0.0 ``` #### GitHub Actions Der wiederverwendbare ClawHub-Workflow [`skill-publish.yml`](https://github.com/openclaw/clawhub/blob/main/.github/workflows/skill-publish.yml) ruft `skill publish` für einen `skill_path` oder für jeden direkten Skill-Ordner unter `root` auf (Standard: `skills`). Er überspringt unveränderte Skills und verwendet dasselbe automatische Patch-Version-Verhalten. Setzen Sie `dry_run: true`, um ohne Token eine Vorschau zu erhalten. Echte Veröffentlichungen erfordern das Secret `clawhub_token`. ### `sync` - Durchsucht das aktuelle workdir, das konfigurierte Skills-Verzeichnis und alle `--root `-Ordner nach lokalen Skill-Ordnern, die `SKILL.md` oder `skill.md` enthalten. - Vergleicht jeden lokalen Skill-Fingerprint mit ClawHub und veröffentlicht nur neue oder geänderte Skills. - Neue Skills werden als `1.0.0` veröffentlicht; geänderte Skills veröffentlichen standardmäßig die nächste Patch-Version. Verwenden Sie `--bump minor|major` für Update-Batches, die um einen größeren Semver-Schritt erhöht werden sollen. - `--dry-run` zeigt den Veröffentlichungsplan ohne Upload; `--json` gibt einen maschinenlesbaren Plan aus. - `--all` veröffentlicht jeden neuen oder geänderten Skill ohne Nachfrage. Ohne `--all` lassen interaktive Terminals Sie die zu veröffentlichenden Skills auswählen. - `--owner ` veröffentlicht unter einem Org-/User-Publisher-Handle, wenn der Akteur Publisher-Zugriff hat. - `sync` ist ausschließlich eine einseitige Veröffentlichung. Es installiert, aktualisiert, lädt nicht herunter und meldet keine Installations-/Download-Telemetrie. ```bash clawhub sync --all --dry-run clawhub sync --all clawhub sync --root ./skills --owner openclaw --bump minor ``` ### `scan --slug ` - Erfordert `clawhub login`. - Führt ClawHub ClawScan über `POST /api/v1/skills/-/scan` aus und pollt anschließend, bis der Scan terminal ist. - Scans sind asynchron und können Zeit benötigen. Während der Scan in der Warteschlange steht, zeigt der Terminal-Spinner die aktuelle priorisierte Scan-Position und wie viele Scans voraus sind. - Veröffentlichte Scans erfordern Ownership oder Publisher-Management-Zugriff. Moderatoren/Admins können dasselbe Backend über `clawhub-admin` verwenden. - `--update` ist nur mit `--slug` gültig; es schreibt erfolgreiche veröffentlichte Scan-Ergebnisse in die ausgewählte Version zurück. - `--output ` lädt das vollständige Report-Archiv mit `manifest.json`, `clawscan.json`, `skillspector.json`, `static-analysis.json`, `virustotal.json` und `README.md` herunter. - `--json` gibt die vollständige Poll-Antwort für Automatisierung aus. - Lokale Pfad-Scans werden nicht mehr unterstützt. Laden Sie eine neue Version hoch und verwenden Sie anschließend `scan download`, um die gespeicherten Scan-Ergebnisse für diese eingereichte Version abzurufen. ```bash clawhub scan --slug gifgrep clawhub scan --slug gifgrep --version 1.2.3 clawhub scan --slug gifgrep --update --output report.zip ``` ### `scan download ` - Erfordert `clawhub login`. - Lädt das gespeicherte Scan-Report-ZIP für eine eingereichte Skill- oder Plugin-Version herunter, einschließlich Versionen, die durch ClawHub-Sicherheitsprüfungen blockiert oder ausgeblendet wurden. - Skill-Downloads verwenden den Skill-Slug und standardmäßig `--kind skill`. - Plugin-Downloads verwenden den Paketnamen und erfordern `--kind plugin`. - `--version` ist erforderlich, damit Autoren die exakt eingereichte Version prüfen, die ClawHub blockiert hat. - `--output ` wählt den Zielpfad aus. ```bash 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 liefert einen offiziellen wiederverwendbaren Workflow unter [`/.github/workflows/skill-publish.yml`](https://github.com/openclaw/clawhub/blob/76b4f36bb0f7409ed7cb9c6fd6f1ccf81396ee88/.github/workflows/skill-publish.yml) für Skill-Repos und Katalog-Repos. Typische Katalog-Einrichtung: ```yaml 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 }} ``` Hinweise: - `root` verwendet für Katalog-Repos standardmäßig `skills`. - Übergeben Sie `skill_path: skills/review-helper`, um einen Skill-Ordner zu verarbeiten. - `owner` wird dem CLI-Flag `--owner` zugeordnet; lassen Sie es weg, um als authentifizierter Benutzer zu veröffentlichen. - V1-Skill-Veröffentlichung verwendet `clawhub_token`; GitHub OIDC Trusted Publishing ist vorerst nur für Pakete verfügbar. ### `delete ` - Ohne `--version` wird ein Skill vorläufig gelöscht (Owner, Moderator oder Admin). - Ruft `DELETE /api/v1/skills/{slug}` auf. - Vom Owner ausgelöste vorläufige Löschungen reservieren den Slug für 30 Tage; der Befehl gibt den Ablaufzeitpunkt aus. - `--version ` löscht eine eigene, nicht neueste Version dauerhaft über eine fail-closed, versionsspezifische Route. Gelöschte Versionen können nicht wiederhergestellt oder erneut veröffentlicht werden. Veröffentlichen Sie einen Ersatz, bevor Sie die aktuell neueste Version löschen. Plattformmitarbeiter umgehen bei diesem reinen Versionsablauf nicht die Ownership-Prüfung. - `--reason ` zeichnet eine Moderationsnotiz für eine vorläufige Löschung des gesamten Skills und im Audit-Log auf. - `--note ` ist ein Alias für `--reason`. - `--yes` überspringt die Bestätigung. ### `undelete ` - Einen ausgeblendeten Skill wiederherstellen (Owner, Moderator oder Admin). - Es gibt keine Wiederherstellung für Versionen; dauerhaft gelöschte Versionen können nicht wiederhergestellt werden. - Ruft `POST /api/v1/skills/{slug}/undelete` auf. - `--reason ` zeichnet eine Moderationsnotiz für den Skill und im Audit-Log auf. - `--note ` ist ein Alias für `--reason`. - `--yes` überspringt die Bestätigung. ### `hide ` - Einen Skill ausblenden (Owner, Moderator oder Admin). - Alias für `delete`. ### `unhide ` - Einen Skill wieder einblenden (Owner, Moderator oder Admin). - Alias für `undelete`. ### `skill rename ` - Einen eigenen Skill umbenennen und den vorherigen Slug als Weiterleitungsalias behalten. - Ruft `POST /api/v1/skills/{slug}/rename` auf. - `--yes` überspringt die Bestätigung. ### `skill merge ` - Einen eigenen Skill mit einem anderen eigenen Skill zusammenführen. - Der Quell-Slug wird nicht mehr öffentlich gelistet und wird zu einem Weiterleitungsalias auf das Ziel. - Ruft `POST /api/v1/skills/{sourceSlug}/merge` auf. - `--yes` überspringt die Bestätigung. ### `transfer` - Workflow zur Ownership-Übertragung. - Übertragungen an Benutzer-Handles erstellen eine ausstehende Anfrage, die der Empfänger annimmt. - Übertragungen an Organisations-/Publisher-Handles werden nur sofort angewendet, wenn der Akteur Admin-Zugriff sowohl auf den aktuellen Owner als auch auf den Ziel-Publisher hat. - Unterbefehle: - `transfer request [--message "..."] [--yes]` - `transfer list [--outgoing]` - `transfer accept [--yes]` - `transfer reject [--yes]` - `transfer cancel [--yes]` - Endpunkte: - `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...]` - Durchsucht den vereinheitlichten Paketkatalog oder navigiert darin über `GET /api/v1/packages` und `GET /api/v1/packages/search`. - Verwenden Sie dies für Plugins und andere Einträge aus Paketfamilien; `search` auf oberster Ebene bleibt die Suchoberfläche für Skills. - Flags: - `--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, Standard: 25) - `--json` Beispiele: ```bash 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 ` - Ruft Paketmetadaten ab, ohne zu installieren. - Verwenden Sie dies für Plugin-Metadaten, Kompatibilität, Verifizierung, Quelle sowie Versions-/Datei-Inspektion. - `--version `: eine bestimmte Version inspizieren (Standard: neueste). - `--tag `: eine Version mit Tag inspizieren (z. B. `latest`). - `--versions`: Versionsverlauf auflisten (erste Seite). - `--limit `: maximale Anzahl der aufzulistenden Versionen (1-100). - `--files`: Dateien für die ausgewählte Version auflisten. - `--file `: rohen Dateiinhalt abrufen (nur Textdateien; Limit 200 KB). - `--json`: maschinenlesbare Ausgabe. ### `package download ` - Löst eine Paketversion über `GET /api/v1/packages/{name}/versions/{version}/artifact` auf. - Lädt das Artefakt über die `downloadUrl` des Resolvers herunter. - Verifiziert ClawHub SHA-256 für alle Artefakte. - Für ClawPack-npm-pack-Artefakte werden außerdem npm-`sha512`-Integrität, npm-shasum und Name/Version aus der `package.json` des Tarballs verifiziert. - Legacy-ZIP-Versionen werden über die Legacy-ZIP-Route heruntergeladen. - Flags: - `--version `: eine bestimmte Version herunterladen. - `--tag `: eine Version mit Tag herunterladen (Standard: `latest`). - `-o, --output `: Ausgabedatei oder -verzeichnis. - `--force`: eine vorhandene Ausgabedatei überschreiben. - `--json`: maschinenlesbare Ausgabe. Beispiele: ```bash clawhub package download @openclaw/example-plugin --tag latest clawhub package download @openclaw/example-plugin --version 1.2.3 -o artifacts/ ``` ### `package verify ` - Berechnet ClawHub SHA-256, npm-`sha512`-Integrität und npm-shasum für ein lokales Artefakt. - Mit `--package` werden erwartete Metadaten aus ClawHub aufgelöst und die lokale Datei mit den veröffentlichten Artefaktmetadaten verglichen. - Mit direkten Digest-Flags wird ohne Netzwerkabfrage verifiziert. - Flags: - `--package `: Paketname zum Auflösen der erwarteten Artefaktmetadaten. - `--version ` oder `--tag `: erwartete Paketversion. - `--sha256 `: erwarteter ClawHub SHA-256. - `--npm-integrity `: erwartete npm-Integrität. - `--npm-shasum `: erwarteter npm-shasum. - `--json`: maschinenlesbare Ausgabe. Beispiele: ```bash 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 ` - Führt den gebündelten Plugin Inspector der ClawHub-CLI gegen einen lokalen Plugin-Paketordner aus. - Standardmäßig erfolgt eine Offline-/statische Validierung, ohne einen lokalen OpenClaw-Checkout zu suchen oder zu importieren. - Harte Kompatibilitätsfehler beenden mit einem von null verschiedenen Status. Reine Warnbefunde werden ausgegeben, aber beenden mit null. - Flags: - `--out `: Plugin-Inspector-Berichte in dieses Verzeichnis schreiben. - `--openclaw `: gegen einen expliziten lokalen OpenClaw-Checkout inspizieren. - `--runtime`: Runtime-Erfassung aktivieren; importiert Plugin-Code. - `--allow-execute`: Runtime-Erfassung in einem isolierten Arbeitsbereich erlauben. - `--no-mock-sdk`: gemocktes OpenClaw-SDK während der Runtime-Erfassung deaktivieren. - `--json`: maschinenlesbare Ausgabe. Beispiel: ```bash clawhub package validate ./example-plugin ``` Wenn die Validierung einen Befund zu Paket, Manifest, SDK-Import oder Artefakt meldet, siehe [Plugin-Validierungsfixes](/de/clawhub/plugin-validation-fixes), und führen Sie den Befehl anschließend erneut aus. ### `package delete ` - Ohne `--version` werden ein Paket und alle Releases vorläufig gelöscht. - `--version ` löscht ein eigenes, nicht neuestes Release dauerhaft über eine fail-closed, versionsspezifische Route. Gelöschte Versionen können nicht wiederhergestellt oder erneut veröffentlicht werden. Veröffentlichen Sie einen Ersatz, bevor Sie die aktuell neueste Version löschen. Dieser reine Versionsablauf erfordert den Paket-Owner oder einen Organisations-Publisher- Admin; Plattformmitarbeiter umgehen die Paket-Ownership nicht. - Das vorläufige Löschen des gesamten Pakets erfordert den Paket-Owner, einen Organisations-Publisher-Owner/-Admin, Plattform- Moderator oder Plattform-Admin. - Flags: - `--version `: eine nicht neueste Version dauerhaft löschen. - `--yes`: Bestätigung überspringen. - `--json`: maschinenlesbare Ausgabe. Beispiel: ```bash clawhub package delete @openclaw/example-plugin --yes clawhub package delete @openclaw/example-plugin --version 1.2.3 --yes ``` ### `package undelete ` - Stellt ein vorläufig gelöschtes Paket und Releases wieder her. - Es gibt keine Wiederherstellung für Versionen; dauerhaft gelöschte Versionen können nicht wiederhergestellt werden. - Erfordert den Paket-Owner, einen Organisations-Publisher-Owner/-Admin, Plattform-Moderator oder Plattform-Admin. - Ruft `POST /api/v1/packages/{name}/undelete` auf. - Flags: - `--yes`: Bestätigung überspringen. - `--json`: maschinenlesbare Ausgabe. Beispiel: ```bash clawhub package undelete @openclaw/example-plugin --yes ``` ### `package transfer ` - Überträgt ein Paket an einen anderen Publisher. - Erfordert Admin-Zugriff sowohl auf den aktuellen Paket-Owner als auch auf den Ziel- Publisher, sofern dies nicht von einem Plattform-Admin ausgeführt wird. - Scoped-Paketnamen müssen an den passenden Scope-Owner übertragen werden. - Ruft `POST /api/v1/packages/{name}/transfer` auf. - Flags: - `--to `: Handle des Ziel-Publishers. - `--reason `: optionaler Audit-Grund. - `--json`: maschinenlesbare Ausgabe. Beispiel: ```bash clawhub package transfer @openclaw/example-plugin --to openclaw ``` ### `package report` - Authentifizierter Befehl zum Melden eines Pakets an Moderatoren. - Ruft `POST /api/v1/packages/{name}/report` auf. - Meldungen gelten auf Paketebene, können optional mit einer Version verknüpft sein und werden für Moderatoren zur Prüfung sichtbar. - Meldungen blenden Pakete nicht automatisch aus und blockieren nicht eigenständig Downloads. - Flags: - `--version `: optionale Paketversion, die der Meldung zugeordnet wird. - `--reason `: erforderlicher Meldegrund. - `--json`: maschinenlesbare Ausgabe. Beispiel: ```bash clawhub package report @openclaw/example-plugin --version 1.2.3 --reason "suspicious native payload" ``` ### `package moderation-status` - Owner-Befehl zum Prüfen der Moderationssichtbarkeit eines Pakets. - Ruft `GET /api/v1/packages/{name}/moderation` auf. - Zeigt den aktuellen Scanstatus des Pakets, die Anzahl offener Meldungen, den manuellen Moderationsstatus des neuesten Releases, den Download-Blockierungsstatus und Moderationsgründe. - Flags: - `--json`: maschinenlesbare Ausgabe. Beispiel: ```bash clawhub package moderation-status @openclaw/example-plugin ``` ### `package readiness ` - Prüft, ob ein Paket für die zukünftige Nutzung durch OpenClaw bereit ist. - Ruft `GET /api/v1/packages/{name}/readiness` auf. - Meldet Blocker für offiziellen Status, ClawPack-Verfügbarkeit, Artefakt-Digest, Quellenherkunft, OpenClaw-Kompatibilität, Host-Ziele, Umgebungsmetadaten und Scanstatus. - Flags: - `--json`: maschinenlesbare Ausgabe. Beispiel: ```bash clawhub package readiness @openclaw/example-plugin ``` ### `package migration-status ` - Zeigt einen operatororientierten Migrationsstatus für ein Paket, das ein gebündeltes OpenClaw-Plugin ersetzen kann. - Ruft denselben berechneten Readiness-Endpunkt wie `package readiness` auf, gibt jedoch migrationsfokussierten Status, neueste Version, Status als offizielles Paket, Prüfungen und Blocker aus. - Flags: - `--json`: maschinenlesbare Ausgabe. Beispiel: ```bash clawhub package migration-status @openclaw/example-plugin ``` ### `publisher create ` - Erstellt einen Organisations-Publisher, der dem authentifizierten Benutzer gehört. - Das Handle wird in Kleinschreibung normalisiert und kann mit oder ohne `@` übergeben werden. - Neu erstellte Organisations-Publisher sind standardmäßig nicht vertrauenswürdig/offiziell. - Schlägt fehl, wenn das Handle bereits von einem bestehenden Publisher, Benutzer oder einer reservierten Route verwendet wird. ```bash clawhub publisher create opik --display-name "Opik" ``` ### `package publish ` - Veröffentlicht ein Code-Plugin oder Bundle-Plugin über `POST /api/v1/packages`. - `` akzeptiert: - Lokaler Ordnerpfad: `./my-plugin` - Lokaler ClawPack-npm-pack-Tarball: `./my-plugin-1.2.3.tgz` - GitHub-Repository: `owner/repo` oder `owner/repo@ref` - GitHub-URL: `https://github.com/owner/repo` - Metadaten werden automatisch aus `package.json`, `openclaw.plugin.json` und echten OpenClaw-Bundle-Markern wie `.codex-plugin/plugin.json`, `.claude-plugin/plugin.json` und `.cursor-plugin/plugin.json` erkannt. - `.tgz`-Quellen werden als ClawPack behandelt. Die CLI lädt die exakten npm-pack- Bytes hoch und verwendet die extrahierten `package/`-Inhalte nur für Validierung und Metadaten-Vorbefüllung. - Code-Plugin-Ordner werden vor dem Upload in einen ClawPack-npm-Tarball gepackt, damit OpenClaw-Installationen das exakte Artefakt verifizieren können. Bundle-Plugin-Ordner verwenden weiterhin den Veröffentlichungspfad für extrahierte Dateien. - Bei GitHub-Quellen wird die Quellenzuordnung automatisch aus Repository, aufgelöstem Commit, Ref und Unterpfad befüllt. - Bei lokalen Ordnern wird die Quellenzuordnung automatisch aus lokalem Git erkannt, wenn der origin-Remote auf GitHub verweist. - Externe Code-Plugins müssen `openclaw.compat.pluginApi` und `openclaw.build.openclawVersion` explizit deklarieren. `package.json.version` auf oberster Ebene wird nicht als Fallback für die Veröffentlichungsvalidierung verwendet. - `--dry-run` zeigt eine Vorschau der aufgelösten Veröffentlichungslast, ohne hochzuladen. - `--json` gibt maschinenlesbare Ausgabe für CI aus. - `--owner ` veröffentlicht unter einem Benutzer- oder Organisations-Publisher-Handle, wenn der Akteur Publisher-Zugriff hat. - Namen von Scoped Packages müssen zum ausgewählten Owner passen. Siehe `docs/publishing.md`. - Vorhandene Flags (`--family`, `--name`, `--version`, `--source-repo`, `--source-commit`, `--source-ref`, `--source-path`) funktionieren weiterhin als Überschreibungen. - Private GitHub-Repositorys erfordern `GITHUB_TOKEN`. ```bash clawhub package publish ./plugin.tgz --owner openclaw ``` #### Empfohlener lokaler Ablauf Verwenden Sie zuerst `--dry-run`, damit Sie die aufgelösten Paketmetadaten und die Quellenzuordnung bestätigen können, bevor Sie ein Live-Release erstellen: ```bash 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 ``` #### Ablauf für lokale Ordner Für Code-Plugins erstellt und lädt die Ordnerveröffentlichung ein ClawPack-Artefakt aus dem Paketordner hoch: ```bash clawhub package publish ./my-plugin --family code-plugin --dry-run clawhub package publish ./my-plugin --family code-plugin ``` #### Minimales `package.json` für `--family code-plugin` Externe Code-Plugins benötigen eine kleine Menge OpenClaw-Metadaten in `package.json`. Dieses minimale Manifest reicht für eine erfolgreiche Veröffentlichung aus: ```json { "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" } } } ``` Erforderliche Felder: - `openclaw.compat.pluginApi` - `openclaw.build.openclawVersion` Hinweise: - `package.json.version` ist Ihre Paket-Release-Version, wird aber nicht als Fallback für die OpenClaw-Kompatibilitäts-/Build-Validierung verwendet. - `openclaw.hostTargets` und `openclaw.environment` sind optionale Metadaten. ClawHub kann sie anzeigen, wenn sie vorhanden sind, sie sind aber für die Veröffentlichung nicht erforderlich. - `openclaw.compat.minGatewayVersion` und `openclaw.build.pluginSdkVersion` sind optionale Extras, wenn Sie detailliertere Kompatibilitätsmetadaten veröffentlichen möchten. - Wenn Sie ein älteres `clawhub`-CLI-Release verwenden, aktualisieren Sie vor der Veröffentlichung, damit die lokalen Preflight-Prüfungen vor dem Upload ausgeführt werden. - Wenn die Validierung einen Remediation-Code meldet, siehe [Plugin-Validierungskorrekturen](/de/clawhub/plugin-validation-fixes). #### GitHub Actions ClawHub liefert außerdem einen offiziellen wiederverwendbaren Workflow unter [`/.github/workflows/package-publish.yml`](https://github.com/openclaw/clawhub/blob/76b4f36bb0f7409ed7cb9c6fd6f1ccf81396ee88/.github/workflows/package-publish.yml) für Plugin-Repositorys aus. Typische Caller-Konfiguration: ```yaml 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 }} ``` Hinweise: - Der wiederverwendbare Workflow setzt `source` standardmäßig auf das Caller-Repository. - Für Monorepos übergeben Sie `source_path`, damit der Workflow den Plugin- Paketordner veröffentlicht, zum Beispiel `source_path: extensions/codex`. - Pinnen Sie den wiederverwendbaren Workflow auf einen stabilen Tag oder vollständigen Commit-SHA. Führen Sie Release-Veröffentlichungen nicht von `@main` aus. - `pull_request` sollte `dry_run: true` verwenden, damit CI keine Daten verändert. - Echte Veröffentlichungen sollten auf vertrauenswürdige Ereignisse wie `workflow_dispatch` oder Tag-Pushes beschränkt werden. - Vertrauenswürdige Veröffentlichung ohne Secret funktioniert nur mit `workflow_dispatch`; Tag-Pushes benötigen weiterhin `clawhub_token`. - Halten Sie `clawhub_token` für die erste Veröffentlichung, nicht vertrauenswürdige Pakete oder Break-Glass-Veröffentlichungen verfügbar. - Der Workflow lädt das JSON-Ergebnis als Artefakt hoch und stellt es als Workflow-Ausgaben bereit. ### `package trusted-publisher get ` - Zeigt die GitHub Actions-Konfiguration für vertrauenswürdige Publisher für ein Paket an. - Verwenden Sie dies nach dem Festlegen der Konfiguration, um Repository, Workflow-Dateiname und optionalen Environment-Pin zu bestätigen. - Flags: - `--json`: maschinenlesbare Ausgabe. Beispiel: ```bash clawhub package trusted-publisher get @openclaw/example-plugin ``` ### `package trusted-publisher set ` - Hängt die GitHub Actions-Konfiguration für vertrauenswürdige Publisher an ein vorhandenes Paket an oder ersetzt sie. - Das Paket muss zuerst über eine normale manuelle oder tokenauthentifizierte `clawhub package publish` erstellt werden. - Nachdem die Konfiguration festgelegt wurde, können zukünftige unterstützte GitHub Actions-Veröffentlichungen OIDC/vertrauenswürdige Veröffentlichung ohne langlebiges ClawHub-Token verwenden. - `--repository ` muss `owner/repo` sein. - `--workflow-filename ` muss dem Workflow-Dateinamen in `.github/workflows/` entsprechen. - `--environment ` ist optional. Wenn konfiguriert, muss die GitHub Actions- Environment im OIDC-Claim exakt übereinstimmen. - ClawHub verifiziert das konfigurierte GitHub-Repository, wenn dieser Befehl ausgeführt wird. Öffentliche Repositorys können über öffentliche GitHub-Metadaten verifiziert werden. Private Repositorys erfordern, dass ClawHub GitHub-Zugriff auf dieses Repository hat, zum Beispiel über eine zukünftige ClawHub-GitHub-App-Installation oder eine andere autorisierte GitHub-Integration. - Flags: - `--repository `: GitHub-Repository, zum Beispiel `openclaw/example-plugin`. - `--workflow-filename `: Workflow-Dateiname, zum Beispiel `package-publish.yml`. - `--environment `: optionale GitHub Actions-Environment mit exakter Übereinstimmung. - `--json`: maschinenlesbare Ausgabe. Beispiel: ```bash clawhub package trusted-publisher set @openclaw/example-plugin \ --repository openclaw/example-plugin \ --workflow-filename package-publish.yml \ --environment release ``` ### `package trusted-publisher delete ` - Entfernt die Konfiguration für vertrauenswürdige Publisher aus einem Paket. - Verwenden Sie dies als Rollback, wenn Workflow, Repository oder Environment-Pin deaktiviert oder neu erstellt werden müssen. - Zukünftige echte Veröffentlichungen müssen normale authentifizierte Veröffentlichung verwenden, bis die Konfiguration erneut festgelegt ist. - Flags: - `--json`: maschinenlesbare Ausgabe. Beispiel: ```bash clawhub package trusted-publisher delete @openclaw/example-plugin ``` ### Installations-Telemetrie - Wird nach `clawhub install ` gesendet, wenn Sie angemeldet sind, sofern `CLAWHUB_DISABLE_TELEMETRY=1` nicht gesetzt ist. - Reporting erfolgt nach bestem Aufwand. Installationsbefehle schlagen nicht fehl, wenn Telemetrie nicht verfügbar ist. - Details: `docs/telemetry.md`.