Skills

ClawHub

ClawHub ist das öffentliche Registry für OpenClaw-Skills und -Plugins.

  • Verwenden Sie native openclaw-Befehle, um Skills zu suchen, zu installieren und zu aktualisieren sowie Plugins aus ClawHub zu installieren.
  • Verwenden Sie die separate clawhub-CLI für Workflows zu Registry-Authentifizierung, Veröffentlichen, Löschen/Wiederherstellen und Synchronisieren.

Website: clawhub.ai

Schnellstart

  • Search

    openclaw skills search "calendar"
    
  • Install

    openclaw skills install <skill-slug>
    
  • Use

    Starten Sie eine neue OpenClaw-Sitzung - sie erkennt den neuen Skill.

  • Publish (optional)

    Für Registry-authentifizierte Workflows (Veröffentlichen, Synchronisieren, Verwalten) installieren Sie die separate clawhub-CLI:

    npm i -g clawhub
    # or
    pnpm add -g clawhub
    
  • Native OpenClaw-Abläufe

    Skills

    openclaw skills search "calendar"
    openclaw skills install <skill-slug>
    openclaw skills update --all
    

    Native openclaw-Befehle installieren in Ihren aktiven Workspace und speichern Quellmetadaten dauerhaft, sodass spätere update-Aufrufe bei ClawHub bleiben können.

    Plugins

    openclaw plugins search "calendar"
    openclaw plugins install clawhub:<package>
    openclaw plugins update --all
    

    plugins search fragt den ClawHub-Plugin-Katalog ab und gibt installationsbereite Paketnamen aus. Verwenden Sie clawhub:<package>, wenn Sie die ClawHub-Auflösung möchten. Reine npm-sichere Plugin-Spezifikationen installieren während der Launch-Umstellung aus npm:

    openclaw plugins install openclaw-codex-app-server
    

    npm:<package> ist ebenfalls nur npm und ist nützlich, wenn eine Spezifikation andernfalls mehrdeutig sein könnte:

    openclaw plugins install npm:openclaw-codex-app-server
    

    Plugin-Installationen validieren die beworbene Kompatibilität von pluginApi und minGatewayVersion, bevor die Archivinstallation ausgeführt wird, sodass inkompatible Hosts früh geschlossen fehlschlagen, statt das Paket teilweise zu installieren. Wenn eine Paketversion ein ClawPack-Artefakt veröffentlicht, bevorzugt OpenClaw das exakt hochgeladene npm-Pack-.tgz, verifiziert den ClawHub- Digest-Header und die heruntergeladenen Bytes und zeichnet Artefakttyp, npm- Integrität, npm-shasum, Tarball-Namen und ClawPack-Digest-Metadaten für spätere Aktualisierungen auf. Ältere Paketversionen ohne ClawPack-Metadaten verwenden weiterhin den bisherigen Verifizierungspfad für Paketarchive.

    Was ClawHub ist

    • Ein öffentliches Registry für OpenClaw-Skills und -Plugins.
    • Ein versionierter Speicher für Skill-Bundles und Metadaten.
    • Eine Discovery-Oberfläche für Suche, Tags und Nutzungssignale.

    Ein typischer Skill ist ein versioniertes Bundle aus Dateien, das Folgendes enthält:

    • Eine SKILL.md-Datei mit der primären Beschreibung und Verwendung.
    • Optionale Konfigurationen, Skripte oder unterstützende Dateien, die vom Skill verwendet werden.
    • Metadaten wie Tags, Zusammenfassung und Installationsanforderungen.

    ClawHub verwendet Metadaten, um Discovery zu unterstützen und Skill- Fähigkeiten sicher offenzulegen. Das Registry verfolgt Nutzungssignale (Sterne, Downloads), um Ranking und Sichtbarkeit zu verbessern. Jede Veröffentlichung erstellt eine neue semver- Version, und das Registry behält den Versionsverlauf bei, damit Benutzer Änderungen prüfen können.

    Workspace und Laden von Skills

    Die separate clawhub-CLI installiert Skills ebenfalls in ./skills unter Ihrem aktuellen Arbeitsverzeichnis. Wenn ein OpenClaw-Workspace konfiguriert ist, fällt clawhub auf diesen Workspace zurück, sofern Sie --workdir (oder CLAWHUB_WORKDIR) nicht überschreiben. OpenClaw lädt Workspace-Skills aus <workspace>/skills und erkennt sie in der nächsten Sitzung.

    Wenn Sie bereits ~/.openclaw/skills oder gebündelte Skills verwenden, haben Workspace- Skills Vorrang. Weitere Details dazu, wie Skills geladen, geteilt und per Gate gesteuert werden, finden Sie unter Skills.

    Servicefunktionen

    Funktion Hinweise
    Öffentliches Browsing Skills und ihre SKILL.md-Inhalte sind öffentlich sichtbar.
    Suche Embedding-gestützt (Vektorsuche), nicht nur Schlüsselwörter.
    Versionierung Semver, Changelogs und Tags (einschließlich latest).
    Downloads ZIP pro Version.
    Sterne und Kommentare Community-Feedback.
    Sicherheits-Scan-Zusammenfassungen Detailseiten zeigen vor Installation oder Download den neuesten Scan-Status.
    Scanner-Detailseiten VirusTotal-, ClawScan- und statische Analyseergebnisse haben Deep Links.
    Dashboard zur Owner-Wiederherstellung Publisher können scan-zurückgehaltene eigene Inhalte unter /dashboard sehen.
    Vom Owner angeforderte erneute Scans Owner können begrenzte erneute Scans zur Wiederherstellung bei False Positives anfordern.
    Moderation Freigaben und Audits.
    CLI-freundliche API Geeignet für Automatisierung und Skripting.

    Sicherheit und Moderation

    ClawHub ist standardmäßig offen - jeder kann Skills hochladen, aber ein GitHub- Konto muss mindestens eine Woche alt sein, um zu veröffentlichen. Das verlangsamt Missbrauch, ohne legitime Beitragende zu blockieren.

    Security scans

    ClawHub führt automatisierte Sicherheitsprüfungen für veröffentlichte Skills und Plugin- Releases aus. Öffentliche Detailseiten fassen das aktuelle Ergebnis zusammen, und Scanner- Zeilen verlinken auf eigene Detailseiten für VirusTotal, ClawScan und statische Analyse.

    Scan-zurückgehaltene oder blockierte Releases können im öffentlichen Katalog und auf Installationsoberflächen nicht verfügbar sein, während sie für ihren Owner in /dashboard weiterhin sichtbar sind.

    Reporting
    • Jeder angemeldete Benutzer kann einen Skill melden.
    • Meldegründe sind erforderlich und werden aufgezeichnet.
    • Jeder Benutzer kann gleichzeitig bis zu 20 aktive Meldungen haben.
    • Skills mit mehr als 3 eindeutigen Meldungen werden standardmäßig automatisch ausgeblendet.
    Moderation
    • Moderatoren können ausgeblendete Skills anzeigen, wieder einblenden, löschen oder Benutzer sperren.
    • Missbrauch der Meldefunktion kann zu Kontosperren führen.
    • Möchten Sie Moderator werden? Fragen Sie im OpenClaw Discord und kontaktieren Sie einen Moderator oder Maintainer.

    ClawHub-CLI

    Sie benötigen dies nur für Registry-authentifizierte Workflows wie Veröffentlichen/Synchronisieren.

    Globale Optionen

    "--workdir
    "--dir
    "--site
    "--registry
    --no-inputboolean

    Eingabeaufforderungen deaktivieren (nicht interaktiv).

    -V, --cli-versionboolean

    CLI-Version ausgeben.

    Befehle

    Auth (login / logout / whoami)
    clawhub login              # browser flow
    clawhub login --token <token>
    clawhub logout
    clawhub whoami
    

    Anmeldeoptionen:

    • --token <token> - API-Token einfügen.
    • --label <label> - Label, das für Browser-Anmeldetoken gespeichert wird (Standard: CLI token).
    • --no-browser - keinen Browser öffnen (erfordert --token).
    Search
    clawhub search "query"
    

    Durchsucht Skills. Verwenden Sie für Plugin-/Paket-Discovery clawhub package explore.

    • --limit <n> - maximale Ergebnisse.
    Browse / inspect plugins
    clawhub package explore --family code-plugin
    clawhub package explore "episodic-claw" --family code-plugin
    clawhub package inspect episodic-claw
    

    package explore und package inspect sind die ClawHub-CLI-Oberflächen für Plugin-/Paket-Discovery und Metadatenprüfung. Native OpenClaw-Installationen verwenden weiterhin openclaw plugins install clawhub:<package>.

    Optionen:

    • --family skill|code-plugin|bundle-plugin - Paketfamilie filtern.
    • --official - nur offizielle Pakete anzeigen.
    • --executes-code - nur Pakete anzeigen, die Code ausführen.
    • --version <version> / --tag <tag> - eine bestimmte Paketversion prüfen.
    • --versions, --files, --file <path> - Paketverlauf und Dateien prüfen.
    • --json - maschinenlesbare Ausgabe.
    Install / update / list
    clawhub install <slug>
    clawhub update <slug>
    clawhub update --all
    clawhub list
    

    Optionen:

    • --version <version> - eine bestimmte Version installieren oder darauf aktualisieren (bei update nur ein einzelner Slug).
    • --force - überschreiben, wenn der Ordner bereits vorhanden ist oder wenn lokale Dateien keiner veröffentlichten Version entsprechen.
    • clawhub list liest .clawhub/lock.json.
    Publish skills
    clawhub skill publish <path>
    

    Optionen:

    • --slug <slug> - Skill-Slug.
    • --name <name> - Anzeigename.
    • --version <version> - semver-Version.
    • --changelog <text> - Changelog-Text (kann leer sein).
    • --tags <tags> - kommagetrennte Tags (Standard: latest).
    Publish plugins
    clawhub package publish <source>
    

    <source> kann ein lokaler Ordner, owner/repo, owner/repo@ref oder eine GitHub-URL sein.

    Optionen:

    • --dry-run - den exakten Veröffentlichungsplan erstellen, ohne etwas hochzuladen.
    • --json - maschinenlesbare Ausgabe für CI ausgeben.
    • --source-repo, --source-commit, --source-ref - optionale Überschreibungen, wenn die automatische Erkennung nicht ausreicht.
    Request rescans
    clawhub skill rescan <slug>
    clawhub skill rescan <slug> --yes --json
    
    clawhub package rescan <name>
    clawhub package rescan <name> --yes --json
    

    Befehle für erneute Scans erfordern ein angemeldetes Owner-Token und zielen auf die neueste veröffentlichte Skill-Version oder das neueste Plugin-Release. Übergeben Sie bei nicht interaktiven Läufen --yes.

    JSON-Antworten enthalten Zieltyp, Namen, Version, Status des erneuten Scans und verbleibende/maximale Anfragezahlen für diese Version oder dieses Release.

    Delete / undelete (owner or admin)
    clawhub delete <slug> --yes
    clawhub undelete <slug> --yes
    
    Sync (scan local + publish new or updated)
    clawhub sync
    

    Optionen:

    • --root <dir...> - zusätzliche Scan-Roots.
    • --all - alles ohne Eingabeaufforderungen hochladen.
    • --dry-run - anzeigen, was hochgeladen würde.
    • --bump <type> - patch|minor|major für Aktualisierungen (Standard: patch).
    • --changelog <text> - Changelog für nicht interaktive Aktualisierungen.
    • --tags <tags> - kommagetrennte Tags (Standard: latest).
    • --concurrency <n> - Registry-Prüfungen (Standard: 4).

    Häufige Workflows

    Suche

    clawhub search "postgres backups"
    

    Plugin finden

    clawhub package explore --family code-plugin
    clawhub package explore "memory" --family code-plugin
    clawhub package inspect episodic-claw
    

    Installieren

    clawhub install my-skill-pack
    

    Alle aktualisieren

    clawhub update --all
    

    Einzelnes Skill veröffentlichen

    clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
    

    Viele Skills synchronisieren

    clawhub sync --all
    

    Plugin von GitHub veröffentlichen

    clawhub package publish your-org/your-plugin --dry-run
    clawhub package publish your-org/your-plugin
    clawhub package publish your-org/[email protected]
    clawhub package publish https://github.com/your-org/your-plugin
    

    Plugin-Paketmetadaten

    Code-Plugins müssen die erforderlichen OpenClaw-Metadaten in package.json enthalten:

    {
      "name": "@myorg/openclaw-my-plugin",
      "version": "1.0.0",
      "type": "module",
      "openclaw": {
        "extensions": ["./src/index.ts"],
        "runtimeExtensions": ["./dist/index.js"],
        "compat": {
          "pluginApi": ">=2026.3.24-beta.2",
          "minGatewayVersion": "2026.3.24-beta.2"
        },
        "build": {
          "openclawVersion": "2026.3.24-beta.2",
          "pluginSdkVersion": "2026.3.24-beta.2"
        }
      }
    }
    

    Veröffentlichte Pakete sollten gebautes JavaScript ausliefern und runtimeExtensions auf diese Ausgabe verweisen. Installationen aus Git-Checkouts können weiterhin auf TypeScript-Quellcode zurückfallen, wenn keine gebauten Dateien vorhanden sind, aber gebaute Runtime-Einträge vermeiden die TypeScript-Kompilierung zur Laufzeit in Start-, Doctor- und Plugin-Ladepfaden.

    Versionierung, Lockfile und Telemetrie

    Versionierung und Tags
    • Jede Veröffentlichung erstellt eine neue semver-SkillVersion.
    • Tags (wie latest) zeigen auf eine Version; durch das Verschieben von Tags können Sie zurückrollen.
    • Changelogs werden pro Version angehängt und können beim Synchronisieren oder Veröffentlichen von Updates leer sein.
    Lokale Änderungen gegenüber Registry-Versionen

    Updates vergleichen die lokalen Skill-Inhalte über einen Inhalts-Hash mit Registry-Versionen. Wenn lokale Dateien keiner veröffentlichten Version entsprechen, fragt die CLI vor dem Überschreiben nach (oder erfordert --force in nicht interaktiven Läufen).

    Sync-Scan und Fallback-Stammverzeichnisse

    clawhub sync scannt zuerst Ihr aktuelles Arbeitsverzeichnis. Wenn keine Skills gefunden werden, wird auf bekannte Legacy-Speicherorte zurückgegriffen (zum Beispiel ~/openclaw/skills und ~/.openclaw/skills). Dies ist darauf ausgelegt, ältere Skill-Installationen ohne zusätzliche Flags zu finden.

    Speicher und Lockfile
    • Installierte Skills werden in .clawhub/lock.json unter Ihrem Arbeitsverzeichnis erfasst.
    • Authentifizierungstokens werden in der Konfigurationsdatei der ClawHub CLI gespeichert (überschreibbar über CLAWHUB_CONFIG_PATH).
    Telemetrie (Installationszahlen)

    Wenn Sie clawhub sync ausführen, während Sie angemeldet sind, sendet die CLI einen minimalen Snapshot, um Installationszahlen zu berechnen. Sie können dies vollständig deaktivieren:

    export CLAWHUB_DISABLE_TELEMETRY=1
    

    Umgebungsvariablen

    Variable Wirkung
    CLAWHUB_SITE Überschreibt die Site-URL.
    CLAWHUB_REGISTRY Überschreibt die Registry-API-URL.
    CLAWHUB_CONFIG_PATH Überschreibt, wo die CLI Token/Konfiguration speichert.
    CLAWHUB_WORKDIR Überschreibt das Standardarbeitsverzeichnis.
    CLAWHUB_DISABLE_TELEMETRY=1 Deaktiviert Telemetrie bei sync.

    Verwandt