Skills

OpenClaw verwendet AgentSkills-kompatible Skill-Ordner, um dem Agenten beizubringen, wie er Tools verwendet. Jeder Skill ist ein Verzeichnis, das eine SKILL.md mit YAML-Frontmatter und Anweisungen enthält. OpenClaw lädt gebündelte Skills sowie optionale lokale Überschreibungen und filtert sie zur Ladezeit basierend auf Umgebung, Konfiguration und Vorhandensein von Binaries.

Speicherorte und Priorität

OpenClaw lädt Skills aus diesen Quellen, höchste Priorität zuerst:

Wenn ein Skill-Name kollidiert, gewinnt die Quelle mit der höchsten Priorität.

Das native Verzeichnis $CODEX_HOME/skills der Codex CLI gehört nicht zu diesen OpenClaw-Skill-Roots. Im Codex-Harness-Modus verwenden lokale App-Server-Starts isolierte Codex-Homes pro Agent, daher werden persönliche Codex CLI-Skills nicht implizit geladen. Verwenden Sie openclaw migrate codex --dry-run, um sie zu inventarisieren, und openclaw migrate codex, um Skill-Verzeichnisse über eine interaktive Checkbox-Eingabe auszuwählen, bevor sie in den aktuellen OpenClaw-Agent-Workspace kopiert werden. Für nicht interaktive Läufe wiederholen Sie --skill <name> für die exakt zu kopierenden Skills.

Agent-spezifische und gemeinsam genutzte Skills

In Multi-Agent-Setups hat jeder Agent seinen eigenen Workspace:

Gleicher Name an mehreren Stellen → Quelle mit der höchsten Priorität gewinnt. Workspace schlägt Projekt-Agent, schlägt persönlichen Agent, schlägt verwaltet/lokal, schlägt gebündelt, schlägt zusätzliche Verzeichnisse.

Agent-Skill-Allowlists

Skill-Speicherort und Skill-Sichtbarkeit sind getrennte Steuerungen. Speicherort/Priorität entscheidet, welche Kopie eines gleichnamigen Skills gewinnt; Agent-Allowlists entscheiden, welche Skills ein Agent tatsächlich verwenden kann.

{  agents: {    defaults: {      skills: ["github", "weather"],    },    list: [      { id: "writer" }, // inherits github, weather      { id: "docs", skills: ["docs-search"] }, // replaces defaults      { id: "locked-down", skills: [] }, // no skills    ],  },}

Plugins und Skills

Plugins können eigene Skills mitliefern, indem sie skills-Verzeichnisse in openclaw.plugin.json aufführen (Pfade relativ zum Plugin-Root). Plugin-Skills werden geladen, wenn das Plugin aktiviert ist. Dies ist der richtige Ort für tool-spezifische Betriebsanleitungen, die zu lang für die Tool-Beschreibung sind, aber verfügbar sein sollten, wenn das Plugin installiert ist - zum Beispiel liefert das Browser-Plugin einen browser-automation-Skill für mehrstufige Browser-Steuerung mit.

Plugin-Skill-Verzeichnisse werden in denselben Pfad mit niedriger Priorität wie skills.load.extraDirs gemischt, sodass ein gleichnamiger gebündelter, verwalteter, Agent- oder Workspace-Skill sie überschreibt. Sie können sie über metadata.openclaw.requires.config im Konfigurationseintrag des Plugins sperren.

Siehe Plugins für Erkennung/Konfiguration und Tools für die Tool-Oberfläche, deren Verwendung diese Skills vermitteln.

Skill Workshop

Das optionale, experimentelle Skill Workshop-Plugin kann Workspace-Skills aus wiederverwendbaren Verfahren erstellen oder aktualisieren, die während der Agent-Arbeit beobachtet wurden. Es ist standardmäßig deaktiviert und muss explizit über plugins.entries.skill-workshop aktiviert werden.

Skill Workshop schreibt nur nach <workspace>/skills, scannt generierte Inhalte, unterstützt ausstehende Genehmigung oder automatische sichere Schreibvorgänge, quarantänisiert unsichere Vorschläge und aktualisiert den Skill-Snapshot nach erfolgreichen Schreibvorgängen, damit neue Skills ohne Gateway-Neustart verfügbar werden.

Verwenden Sie es für Korrekturen wie "beim nächsten Mal GIF-Attribution prüfen" oder hart erarbeitete Workflows wie Medien-QA-Checklisten. Beginnen Sie mit ausstehender Genehmigung; verwenden Sie automatische Schreibvorgänge nur in vertrauenswürdigen Workspaces, nachdem Sie seine Vorschläge geprüft haben. Vollständige Anleitung: Skill Workshop-Plugin.

ClawHub (Installieren und Synchronisieren)

ClawHub ist die öffentliche Skills-Registry für OpenClaw. Verwenden Sie native openclaw skills-Befehle für Suche/Installation/Aktualisierung oder die separate clawhub CLI für Veröffentlichungs-/Synchronisierungs-Workflows. Vollständige Anleitung: ClawHub.

Das native openclaw skills install installiert in das aktive Workspace-Verzeichnis skills/. Die separate clawhub CLI installiert ebenfalls in ./skills unter Ihrem aktuellen Arbeitsverzeichnis (oder fällt auf den konfigurierten OpenClaw-Workspace zurück). OpenClaw nimmt dies in der nächsten Sitzung als <workspace>/skills auf. Konfigurierte Skill-Roots unterstützen außerdem eine Gruppierungsebene, etwa skills/<group>/<skill>/SKILL.md, sodass verwandte Drittanbieter-Skills unter einem gemeinsamen Ordner gehalten werden können, ohne breit rekursiv zu scannen.

Gateway-Clients, die eine private, nicht über ClawHub laufende Bereitstellung benötigen, können ein ZIP-Skill-Archiv mit skills.upload.begin, skills.upload.chunk und skills.upload.commit bereitstellen und den abgeschlossenen Upload dann mit skills.install({ source: "upload", uploadId, slug, force?, sha256? }) installieren. Dies ist ein expliziter Admin-Upload-Pfad für vertrauenswürdige Clients, nicht der normale openclaw skills install <slug>- oder ClawHub-Installationsfluss. Er ist standardmäßig deaktiviert und funktioniert nur, wenn skills.install.allowUploadedArchives: true in openclaw.json gesetzt ist. Der Upload-Modus installiert weiterhin in das Standardverzeichnis skills/<slug> des Agent-Workspaces; der interne Ordnername des Archivs wird für das endgültige Installationsziel ignoriert.

ClawHub-Skill-Seiten zeigen vor der Installation den neuesten Sicherheits-Scan-Status an, mit Scanner-Detailseiten für VirusTotal, ClawScan und statische Analyse. openclaw skills install <slug> bleibt ausschließlich der Installationspfad; Publisher beheben falsch positive Ergebnisse über das ClawHub-Dashboard oder clawhub skill rescan <slug>.

Sicherheit

• Workspace- und Extra-Dir-Skill-Erkennung akzeptiert nur Skill-Roots und SKILL.md-Dateien, deren aufgelöster Realpath innerhalb des konfigurierten Roots bleibt.
• Private Gateway-Archivinstallationen sind standardmäßig deaktiviert. Wenn sie explizit aktiviert sind, erfordern sie einen abgeschlossenen ZIP-Upload mit SKILL.md und verwenden dieselben Archivextraktions-, Path-Traversal-, Symlink-, Force- und Rollback-Schutzmaßnahmen wie ClawHub-Skill-Installationen. Sie werden durch skills.install.allowUploadedArchives gesteuert; normale ClawHub-Installationen benötigen diese Einstellung nicht.
• Gateway-gestützte Skill-Abhängigkeitsinstallationen (skills.install, Onboarding und die Skills-Einstellungsoberfläche) führen den integrierten Scanner für gefährlichen Code aus, bevor Installer-Metadaten ausgeführt werden. critical-Befunde blockieren standardmäßig, sofern der Aufrufer nicht explizit die Dangerous-Override setzt; verdächtige Befunde warnen weiterhin nur.
• openclaw skills install <slug> ist anders - es lädt einen ClawHub-Skill-Ordner in den Workspace herunter und verwendet nicht den oben beschriebenen Installer-Metadatenpfad.
• skills.entries.*.env und skills.entries.*.apiKey injizieren Secrets in den Host-Prozess für diesen Agent-Turn (nicht in die Sandbox). Halten Sie Secrets aus Prompts und Logs heraus.

Für ein breiteres Bedrohungsmodell und Checklisten siehe Sicherheit.

SKILL.md-Format

SKILL.md muss mindestens Folgendes enthalten:

---name: image-labdescription: Generate or edit images via a provider-backed image workflow---

OpenClaw folgt der AgentSkills-Spezifikation für Layout/Intention. Der vom eingebetteten Agenten verwendete Parser unterstützt nur einzeilige Frontmatter-Schlüssel; metadata sollte ein einzeiliges JSON-Objekt sein. Verwenden Sie {baseDir} in Anweisungen, um auf den Skill-Ordnerpfad zu verweisen.

Optionale Frontmatter-Schlüssel

Gating (Ladezeitfilter)

OpenClaw filtert Skills zur Ladezeit mithilfe von metadata (einzeiliges JSON):

---name: image-labdescription: Generate or edit images via a provider-backed image workflowmetadata:  {    "openclaw":      {        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] },        "primaryEnv": "GEMINI_API_KEY",      },  }---

Felder unter metadata.openclaw:

Wenn kein metadata.openclaw vorhanden ist, ist der Skill immer geeignet (außer er ist in der Konfiguration deaktiviert oder durch skills.allowBundled für gebündelte Skills blockiert).

Sandbox-Hinweise

• requires.bins wird beim Laden des Skills auf dem Host geprüft.
• Wenn ein Agent in einer Sandbox ausgeführt wird, muss die Binärdatei auch innerhalb des Containers vorhanden sein. Installieren Sie sie über agents.defaults.sandbox.docker.setupCommand (oder ein benutzerdefiniertes Image). setupCommand wird einmal ausgeführt, nachdem der Container erstellt wurde. Paketinstallationen erfordern außerdem Netzwerk-Egress, ein beschreibbares Root-Dateisystem und einen Root-Benutzer in der Sandbox.
• Beispiel: Der Skill summarize (skills/summarize/SKILL.md) benötigt die summarize-CLI im Sandbox-Container, um dort ausgeführt zu werden.

Installer-Spezifikationen

---name: geminidescription: Use Gemini CLI for coding assistance and Google search lookups.metadata:  {    "openclaw":      {        "emoji": "♊️",        "requires": { "bins": ["gemini"] },        "install":          [            {              "id": "brew",              "kind": "brew",              "formula": "gemini-cli",              "bins": ["gemini"],              "label": "Install Gemini CLI (brew)",            },          ],      },  }---

Konfigurationsüberschreibungen

Gebündelte und verwaltete Skills können umgeschaltet und mit Umgebungswerten unter skills.entries in ~/.openclaw/openclaw.json versorgt werden:

{  skills: {    entries: {      "image-lab": {        enabled: true,        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string        env: {          GEMINI_API_KEY: "GEMINI_KEY_HERE",        },        config: {          endpoint: "https://example.invalid",          model: "nano-pro",        },      },      peekaboo: { enabled: true },      sag: { enabled: false },    },  },}

Wenn der Skill-Name Bindestriche enthält, setzen Sie den Schlüssel in Anführungszeichen (JSON5 erlaubt Schlüssel in Anführungszeichen). Konfigurationsschlüssel entsprechen standardmäßig dem Skill-Namen - wenn ein Skill metadata.openclaw.skillKey definiert, verwenden Sie diesen Schlüssel unter skills.entries.

Umgebungsinjektion

Wenn ein Agent-Lauf startet, führt OpenClaw Folgendes aus:

1. Liest Skill-Metadaten.
2. Wendet skills.entries.<key>.env und skills.entries.<key>.apiKey auf process.env an.
3. Erstellt den System-Prompt mit geeigneten Skills.
4. Stellt die ursprüngliche Umgebung wieder her, nachdem der Lauf endet.

Die Umgebungsinjektion ist auf den Agent-Lauf beschränkt, nicht auf eine globale Shell- Umgebung.

Für das gebündelte Backend claude-cli materialisiert OpenClaw außerdem denselben geeigneten Snapshot als temporäres Claude Code Plugin und übergibt ihn mit --plugin-dir. Claude Code kann dann seinen nativen Skill-Resolver verwenden, während OpenClaw weiterhin Vorrang, Agent-spezifische Zulassungslisten, Gating und skills.entries.*-Umgebungs-/API-Schlüssel-Injektion verwaltet. Andere CLI-Backends verwenden nur den Prompt-Katalog.

Snapshots und Aktualisierung

OpenClaw erstellt einen Snapshot der geeigneten Skills beim Start einer Sitzung und verwendet diese Liste für nachfolgende Turns in derselben Sitzung wieder. Änderungen an Skills oder Konfiguration werden in der nächsten neuen Sitzung wirksam.

Skills können in zwei Fällen während einer Sitzung aktualisiert werden:

• Der Skills-Watcher ist aktiviert.
• Ein neuer geeigneter Remote-Node erscheint.

Betrachten Sie dies als Hot Reload: Die aktualisierte Liste wird beim nächsten Agent-Turn übernommen. Wenn sich die effektive Skill-Zulassungsliste des Agenten für diese Sitzung ändert, aktualisiert OpenClaw den Snapshot, damit sichtbare Skills mit dem aktuellen Agenten synchron bleiben.

Skills-Watcher

Standardmäßig überwacht OpenClaw Skill-Ordner und erhöht den Skills-Snapshot, wenn sich SKILL.md-Dateien ändern. Konfigurieren Sie dies unter skills.load:

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true,      watchDebounceMs: 250,    },  },}

Verwenden Sie allowSymlinkTargets für beabsichtigte Layouts mit benachbarten Repositories, bei denen ein integrierter Skill-Root einen Symlink enthält, zum Beispiel ~/.agents/skills/manager -> ~/Projects/manager/skills. Die Zielliste wird nach Realpath-Auflösung abgeglichen und sollte eng gefasst bleiben.

Remote-macOS-Nodes (Linux-Gateway)

Wenn der Gateway unter Linux läuft, aber ein macOS-Node mit erlaubtem system.run verbunden ist (Exec-Genehmigungssicherheit nicht auf deny gesetzt), kann OpenClaw macOS-exklusive Skills als geeignet behandeln, wenn die erforderlichen Binärdateien auf diesem Node vorhanden sind. Der Agent sollte diese Skills über das Werkzeug exec mit host=node ausführen.

Dies hängt davon ab, dass der Node seine Befehlsunterstützung meldet und ein Bin-Probe über system.which oder system.run möglich ist. Offline-Nodes machen Remote-exklusive Skills nicht sichtbar. Wenn ein verbundener Node nicht mehr auf Bin- Probes antwortet, löscht OpenClaw seine gecachten Bin-Treffer, sodass Agenten keine Skills mehr sehen, die dort derzeit nicht ausgeführt werden können.

Token-Auswirkung

Wenn Skills geeignet sind, injiziert OpenClaw eine kompakte XML-Liste verfügbarer Skills in den System-Prompt (über formatSkillsForPrompt in pi-coding-agent). Die Kosten sind deterministisch:

• Basis-Overhead (nur bei ≥1 Skill): 195 Zeichen.
• Pro Skill: 97 Zeichen + die Länge der XML-escaped Werte <name>, <description> und <location>.

Formel (Zeichen):

total = 195 + Σ (97 + len(name_escaped) + len(description_escaped) + len(location_escaped))

XML-Escaping erweitert & < > " ' zu Entitäten (&, < usw.) und erhöht dadurch die Länge. Token-Zahlen variieren je nach Modell-Tokenizer. Eine grobe Schätzung im OpenAI-Stil ist ~4 Zeichen/Token, also 97 Zeichen ≈ 24 Token pro Skill plus Ihre tatsächlichen Feldlängen.

Lebenszyklus verwalteter Skills

OpenClaw liefert eine Baseline-Menge von Skills als gebündelte Skills mit der Installation aus (npm-Paket oder OpenClaw.app). ~/.openclaw/skills ist für lokale Überschreibungen vorgesehen - zum Beispiel zum Pinning oder Patchen eines Skills, ohne die gebündelte Kopie zu ändern. Workspace-Skills gehören dem Benutzer und überschreiben beide bei Namenskonflikten.

Suchen Sie nach weiteren Skills?

Durchsuchen Sie https://clawhub.ai. Vollständiges Konfigurationsschema: Skills-Konfiguration.

Verwandt

• ClawHub - öffentliches Skills-Registry
• Skills erstellen - benutzerdefinierte Skills erstellen
• Plugins - Überblick über das Plugin-System
• Skill Workshop Plugin - Skills aus Agent-Arbeit generieren
• Skills-Konfiguration - Referenz zur Skill-Konfiguration
• Slash-Befehle - alle verfügbaren Slash-Befehle