CLI commands
Skills
openclaw skills
Lokale Skills prüfen, ClawHub durchsuchen, Skills aus ClawHub/Git/lokalen Verzeichnissen installieren, ClawHub-Skills verifizieren und von ClawHub nachverfolgte Installationen aktualisieren.
Verwandte Themen:
- Skills-System: Skills
- Skill Workshop: Skill Workshop
- Skills-Konfiguration: Skills-Konfiguration
- ClawHub-Installationen: ClawHub
Befehle
openclaw skills search "calendar"openclaw skills search --limit 20 --jsonopenclaw skills install @owner/<slug>openclaw skills install @owner/<slug> --version <version>openclaw skills install git:owner/repoopenclaw skills install git:owner/repo@mainopenclaw skills install ./path/to/skill --as custom-nameopenclaw skills install @owner/<slug> --forceopenclaw skills install @owner/<slug> --force-installopenclaw skills install @owner/<slug> --acknowledge-clawhub-riskopenclaw skills install @owner/<slug> --agent <id>openclaw skills install @owner/<slug> --globalopenclaw skills update @owner/<slug>openclaw skills update @owner/<slug> --force-installopenclaw skills update @owner/<slug> --acknowledge-clawhub-riskopenclaw skills update @owner/<slug> --globalopenclaw skills update --allopenclaw skills update --all --agent <id>openclaw skills update --all --globalopenclaw skills verify @owner/<slug>openclaw skills verify @owner/<slug> --version <version>openclaw skills verify @owner/<slug> --tag <tag>openclaw skills verify @owner/<slug> --cardopenclaw skills verify @owner/<slug> --globalopenclaw skills listopenclaw skills list --eligibleopenclaw skills list --jsonopenclaw skills list --verboseopenclaw skills list --agent <id>openclaw skills info <name>openclaw skills info <name> --jsonopenclaw skills info <name> --agent <id>openclaw skills checkopenclaw skills check --agent <id>openclaw skills check --jsonopenclaw skills workshop propose-create --name "qa-check" --description "QA checklist" --proposal ./PROPOSAL.mdopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Not reusable"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"search, update und verify verwenden ClawHub direkt. install @owner/<slug>
installiert einen ClawHub-Skill, install git:owner/repo[@ref] klont einen Git-Skill
und install ./path kopiert ein lokales Skill-Verzeichnis. Standardmäßig zielen install,
update und verify auf das Verzeichnis skills/ des aktiven Workspace; mit
--global zielen sie auf das gemeinsame verwaltete Skills-Verzeichnis. list/info/check
prüfen weiterhin die lokalen Skills, die für den aktuellen Workspace und die aktuelle Konfiguration sichtbar sind.
Workspace-basierte Befehle ermitteln den Ziel-Workspace zunächst aus --agent <id>,
anschließend aus dem aktuellen Arbeitsverzeichnis, wenn es sich innerhalb eines konfigurierten Agenten-Workspace
befindet, und schließlich aus dem Standard-Agenten.
Git- und lokale Verzeichnisinstallationen erwarten SKILL.md im Quellstammverzeichnis. Der
Installations-Slug stammt aus dem SKILL.md-Frontmatter name, wenn dieser gültig ist, und andernfalls
aus dem Namen des Quellverzeichnisses oder Repositorys; mit --as <slug> kann er überschrieben werden.
--version gilt nur für ClawHub. Skill-Installationen unterstützen keine npm-Paketspezifikationen
oder ZIP-/Archivpfade, und openclaw skills update aktualisiert nur von ClawHub nachverfolgte
Installationen.
Gateway-basierte Installationen von Skill-Abhängigkeiten, die durch das Onboarding oder die Skills-
Einstellungen ausgelöst werden, verwenden stattdessen den separaten Anfragepfad skills.install.
Hinweise:
| Flag/Verhalten | Beschreibung |
|---|---|
search [query...] |
Optionale Abfrage; lassen Sie sie weg, um den standardmäßigen ClawHub-Suchfeed zu durchsuchen. |
search --limit <n> |
Begrenzt die Anzahl der zurückgegebenen Ergebnisse. |
install git:owner/repo[@ref] |
Installiert einen Git-Skill. Branch-Referenzen dürfen Schrägstriche enthalten, beispielsweise git:owner/repo@feature/foo. |
install ./path/to/skill |
Installiert ein lokales Verzeichnis, dessen Stammverzeichnis SKILL.md enthält. |
install --as <slug> |
Überschreibt den abgeleiteten Slug für Git- und lokale Verzeichnisinstallationen. |
install --version <version> |
Gilt nur für ClawHub-Skill-Referenzen. |
install --force |
Überschreibt einen vorhandenen Workspace-Skill-Ordner mit demselben Slug. |
install/update --force-install |
Installiert einen ausstehenden GitHub-basierten ClawHub-Skill, bevor der Scan von ClawHub abgeschlossen ist. |
--global |
Zielt auf das gemeinsame verwaltete Skills-Verzeichnis; kann nicht mit --agent <id> kombiniert werden. |
--agent <id> |
Zielt auf einen konfigurierten Agenten-Workspace; überschreibt die Ableitung aus dem aktuellen Arbeitsverzeichnis. |
update @owner/<slug> |
Aktualisiert einen einzelnen nachverfolgten Skill. Fügen Sie --global hinzu, um statt des Workspace das gemeinsame verwaltete Skills-Verzeichnis als Ziel zu verwenden. |
update --all |
Aktualisiert nachverfolgte ClawHub-Installationen im ausgewählten Workspace oder mit --global im gemeinsamen verwalteten Skills-Verzeichnis. |
verify @owner/<slug> |
Gibt standardmäßig den JSON-Umschlag clawhub.skill.verify.v1 von ClawHub aus. Es gibt kein Flag --json, da JSON bereits die Standardeinstellung ist. Reine Slugs werden aus Kompatibilitätsgründen akzeptiert, wenn der Skill bereits installiert oder eindeutig ist; durch den Besitzer qualifizierte Referenzen vermeiden Mehrdeutigkeiten beim Herausgeber. |
verify-Provenienz |
Wenn ClawHub serverseitig aufgelöste Quellprovenienz zurückgibt, enthält das Verifizierungs-JSON auch einen an einen Commit gebundenen openclaw.verifiedSourceUrl. Nicht verfügbare oder selbst deklarierte Quell-URLs verbleiben nur im Roh-Provenienzumschlag und werden nicht hochgestuft. |
verify-Versionsauswahl |
verify verwendet .clawhub/origin.json für installierte ClawHub-Skills und verifiziert daher die installierte Version gegen die Registry, aus der sie stammt. --version und --tag überschreiben die Versionsauswahl, behalten jedoch diese installierte Registry bei, wenn Ursprungsmetadaten vorhanden sind. |
verify --card |
Gibt das generierte Skill-Card-Markdown anstelle von JSON aus. Wird mit einem von null verschiedenen Status beendet, wenn ClawHub ok: false oder decision: "fail" zurückgibt; nicht signierte Signaturen dienen nur zur Information, sofern sich die ClawHub-Richtlinie nicht ändert. |
| Skill-Card-Fingerabdruck | Installierte ClawHub-Bundles können eine generierte skill-card.md enthalten. OpenClaw behandelt die Verifizierung als Entscheidung des ClawHub-Servers und lehnt einen installierten Skill nicht allein deshalb ab, weil diese generierte Karte den Bundle-Fingerabdruck ändert. |
check --agent <id> |
Prüft den Workspace des ausgewählten Agenten und meldet, welche einsatzbereiten Skills tatsächlich für die Prompt- oder Befehlsoberfläche dieses Agenten sichtbar sind. |
list |
Standardaktion, wenn kein Unterbefehl angegeben wird. |
Ausgabe von list/info/check |
Die gerenderte Ausgabe wird an stdout gesendet. Mit --json verbleibt die maschinenlesbare Nutzlast für Pipes und Skripte auf stdout. |
Bei Installationen und Aktualisierungen von Community-ClawHub-Skills wird vor dem Herunterladen die Vertrauenswürdigkeit
geprüft. Versionierte Community-Archivveröffentlichungen verwenden Vertrauensmetadaten für die exakte Veröffentlichung.
Resolver-basierte GitHub-Skills stützen sich auf den Installations-Resolver von ClawHub, um
Scan- und erzwungene Installationsrichtlinien durchzusetzen, bevor er einen festgeschriebenen Commit zurückgibt; verwenden Sie
--force-install, um einen ausstehenden GitHub-basierten Skill zu installieren, bevor dieser Scan
abgeschlossen ist. Schädliche oder blockierte Community-Veröffentlichungen werden abgelehnt. Riskante
Community-Veröffentlichungen erfordern eine Prüfung und --acknowledge-clawhub-risk, wenn ein
nicht interaktiver Befehl nach dieser Prüfung fortgesetzt werden soll. Offizielle ClawHub-
Skill-Herausgeber und gebündelte OpenClaw-Skill-Quellen umgehen diese Aufforderung zur Prüfung der Veröffentlichungsvertrauenswürdigkeit.
Skill Workshop
openclaw skills workshop verwaltet ausstehende Skill-Vorschläge im ausgewählten
Workspace. Vorschläge sind erst nach ihrer Anwendung aktive Skills. Informationen zur
Speicherung von Vorschlägen, zu Schutzmaßnahmen für unterstützende Dateien, zu Gateway-Methoden und zu Genehmigungsrichtlinien finden Sie unter
Skill Workshop.
openclaw skills workshop propose-create \ --name "qa-check" \ --description "Wiederholbare QA-Checkliste" \ --proposal ./PROPOSAL.mdopenclaw skills workshop propose-create \ --name "qa-check" \ --description "Wiederholbare QA-Checkliste" \ --proposal-dir ./qa-check-proposalopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Duplikat"openclaw skills workshop quarantine <proposal-id> --reason "Sicherheitsprüfung erforderlich"propose-create, propose-update und revise akzeptieren außerdem --goal <text>
und --evidence <text>, um die Motivation des Vorschlags und unterstützende
Hinweise zusammen mit dem Inhalt von --proposal/--proposal-dir zu erfassen.
