> ## Documentation Index > Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt > Use this file to discover all available pages before exploring further. # Fähigkeiten # Fähigkeiten (OpenClaw) OpenClaw verwendet **[AgentSkills](https://agentskills.io)-kompatible** Skill-Ordner, um dem Agenten den Umgang mit Werkzeugen beizubringen. Jeder Skill ist ein Verzeichnis mit einer `SKILL.md` mit YAML-Frontmatter und Anweisungen. OpenClaw lädt **gebündelte Skills** sowie optionale lokale Overrides und filtert sie zur Ladezeit basierend auf Umgebung, Konfiguration und Vorhandensein von Binärdateien. ## Orte und Vorrangstellung Skills werden aus **drei** Orten geladen: 1. **Gebündelte Skills**: werden mit der Installation ausgeliefert (npm-Paket oder OpenClaw\.app) 2. **Verwaltete/lokale Skills**: `~/.openclaw/skills` 3. **Workspace-Skills**: `/skills` Bei Namenskonflikten gilt folgende Priorität: `/skills` (höchste) → `~/.openclaw/skills` → gebündelte Skills (niedrigste) Zusätzlich können Sie weitere Skill-Ordner (niedrigste Priorität) über `skills.load.extraDirs` in `~/.openclaw/openclaw.json` konfigurieren. ## Pro-Agent- vs. geteilte Skills In **Multi-Agent**-Setups hat jeder Agent seinen eigenen Workspace. Das bedeutet: * **Pro-Agent-Skills** befinden sich in `/skills` nur für diesen Agenten. * **Geteilte Skills** befinden sich in `~/.openclaw/skills` (verwaltet/lokal) und sind für **alle Agenten** auf derselben Maschine sichtbar. * **Geteilte Ordner** können auch über `skills.load.extraDirs` (niedrigste Priorität) hinzugefügt werden, wenn Sie ein gemeinsames Skill-Paket für mehrere Agenten verwenden möchten. Existiert derselbe Skillname an mehreren Orten, gilt die übliche Priorität: Workspace gewinnt, dann verwaltet/lokal, dann gebündelt. ## Plugins + Skills Plugins können eigene Skills mitliefern, indem sie `skills`-Verzeichnisse in `openclaw.plugin.json` auflisten (Pfade relativ zum Plugin-Root). Plugin-Skills werden geladen, wenn das Plugin aktiviert ist, und nehmen an den normalen Skill-Prioritätsregeln teil. Sie können sie über `metadata.openclaw.requires.config` im Konfigurationseintrag des Plugins gate’n. Siehe [Plugins](/tools/plugin) für Discovery/Konfiguration und [Tools](/tools) für die Werkzeugoberfläche, die diese Skills vermitteln. ## ClawHub (Installation + Sync) ClawHub ist das öffentliche Skills-Registry für OpenClaw. Stöbern Sie unter [https://clawhub.com](https://clawhub.com). Nutzen Sie es zum Entdecken, Installieren, Aktualisieren und Sichern von Skills. Vollständige Anleitung: [ClawHub](/tools/clawhub). Häufige Abläufe: * Einen Skill in Ihren Workspace installieren: * `clawhub install ` * Alle installierten Skills aktualisieren: * `clawhub update --all` * Synchronisieren (Scannen + Updates veröffentlichen): * `clawhub sync --all` Standardmäßig installiert `clawhub` in `./skills` unter Ihrem aktuellen Arbeitsverzeichnis (oder greift auf den konfigurierten OpenClaw-Workspace zurück). OpenClaw erkennt dies beim nächsten Start als `/skills`. ## Sicherheitshinweise * Behandeln Sie Skills von Drittanbietern als **nicht vertrauenswürdigen Code**. Lesen Sie sie vor dem Aktivieren. * Bevorzugen Sie sandboxed Ausführungen für nicht vertrauenswürdige Eingaben und riskante Werkzeuge. Siehe [Sandboxing](/gateway/sandboxing). * `skills.entries.*.env` und `skills.entries.*.apiKey` injizieren Geheimnisse in den **Host**-Prozess für diesen Agenten-Zug (nicht in die Sandbox). Halten Sie Geheimnisse aus Prompts und Logs heraus. * Für ein umfassenderes Bedrohungsmodell und Checklisten siehe [Security](/gateway/security). ## Format (AgentSkills + Pi-kompatibel) `SKILL.md` muss mindestens enthalten: ```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}} --- name: nano-banana-pro description: Generate or edit images via Gemini 3 Pro Image --- ``` Hinweise: * Wir folgen 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 den Anweisungen, um auf den Skill-Ordnerpfad zu verweisen. * Optionale Frontmatter-Schlüssel: * `homepage` — URL, die in der macOS-Skills-UI als „Website“ angezeigt wird (auch über `metadata.openclaw.homepage` unterstützt). * `user-invocable` — `true|false` (Standard: `true`). Wenn `true`, wird der Skill als Benutzer-Slash-Command bereitgestellt. * `disable-model-invocation` — `true|false` (Standard: `false`). Wenn `true`, wird der Skill aus dem Modell-Prompt ausgeschlossen (weiterhin per Benutzeraufruf verfügbar). * `command-dispatch` — `tool` (optional). Wenn auf `tool` gesetzt, umgeht der Slash-Command das Modell und wird direkt an ein Werkzeug dispatcht. * `command-tool` — Werkzeugname, der aufgerufen wird, wenn `command-dispatch: tool` gesetzt ist. * `command-arg-mode` — `raw` (Standard). Für Tool-Dispatch werden die Rohargumente an das Werkzeug weitergeleitet (keine Kern-Parsing). Das Werkzeug wird mit folgenden Parametern aufgerufen: `{ command: "", commandName: "", skillName: "" }`. ## Gating (Filter zur Ladezeit) OpenClaw **filtert Skills zur Ladezeit** mit `metadata` (einzeiliges JSON): ```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}} --- name: nano-banana-pro description: Generate or edit images via Gemini 3 Pro Image metadata: { "openclaw": { "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] }, "primaryEnv": "GEMINI_API_KEY", }, } --- ``` Felder unter `metadata.openclaw`: * `always: true` — Skill immer einschließen (andere Gates überspringen). * `emoji` — optionales Emoji, das von der macOS-Skills-UI verwendet wird. * `homepage` — optionale URL, die in der macOS-Skills-UI als „Website“ angezeigt wird. * `os` — optionale Liste von Plattformen (`darwin`, `linux`, `win32`). Falls gesetzt, ist der Skill nur auf diesen Betriebssystemen zulässig. * `requires.bins` — Liste; jede muss auf `PATH` existieren. * `requires.anyBins` — Liste; mindestens eine muss auf `PATH` existieren. * `requires.env` — Liste; die Umgebungsvariable muss existieren **oder** in der Konfiguration bereitgestellt werden. * `requires.config` — Liste von `openclaw.json`-Pfaden, die wahrheitsgemäß sein müssen. * `primaryEnv` — Name der Umgebungsvariable, die mit `skills.entries..apiKey` verknüpft ist. * `install` — optionales Array von Installer-Spezifikationen, die von der macOS-Skills-UI verwendet werden (brew/node/go/uv/download). Hinweis zu sandboxing: * `requires.bins` wird zur Ladezeit des Skills auf dem **Host** geprüft. * Wenn ein Agent sandboxed ist, muss die Binärdatei auch **innerhalb des Containers** existieren. 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-FS und einen Root-Benutzer in der Sandbox. Beispiel: Der `summarize`-Skill (`skills/summarize/SKILL.md`) benötigt die `summarize`-CLI im Sandbox-Container, um dort ausgeführt zu werden. Installer-Beispiel: ```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}} --- name: gemini description: 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)", }, ], }, } --- ``` Hinweise: * Wenn mehrere Installer aufgeführt sind, wählt das Gateway **eine** bevorzugte Option (brew, wenn verfügbar, andernfalls node). * Wenn alle Installer `download` sind, listet OpenClaw jeden Eintrag auf, damit Sie die verfügbaren Artefakte sehen können. * Installer-Spezifikationen können `os: ["darwin"|"linux"|"win32"]` enthalten, um Optionen nach Plattform zu filtern. * Node-Installationen berücksichtigen `skills.install.nodeManager` in `openclaw.json` (Standard: npm; Optionen: npm/pnpm/yarn/bun). Dies betrifft nur **Skill-Installationen**; die Gateway-Laufzeit sollte weiterhin Node sein (Bun wird für WhatsApp/Telegram nicht empfohlen). * Go-Installationen: Wenn `go` fehlt und `brew` verfügbar ist, installiert das Gateway Go zuerst über Homebrew und setzt `GOBIN` nach Möglichkeit auf Homebrews `bin`. * Download-Installationen: `url` (erforderlich), `archive` (`tar.gz` | `tar.bz2` | `zip`), `extract` (Standard: auto bei erkanntem Archiv), `stripComponents`, `targetDir` (Standard: `~/.openclaw/tools/`). Wenn kein `metadata.openclaw` vorhanden ist, ist der Skill immer zulässig (sofern nicht in der Konfiguration deaktiviert oder durch `skills.allowBundled` für gebündelte Skills blockiert). ## Konfigurations-Overrides (`~/.openclaw/openclaw.json`) Gebündelte/verwaltete Skills können umgeschaltet und mit Env-Werten versorgt werden: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { skills: { entries: { "nano-banana-pro": { enabled: true, apiKey: "GEMINI_KEY_HERE", env: { GEMINI_API_KEY: "GEMINI_KEY_HERE", }, config: { endpoint: "https://example.invalid", model: "nano-pro", }, }, peekaboo: { enabled: true }, sag: { enabled: false }, }, }, } ``` Hinweis: Wenn der Skillname Bindestriche enthält, setzen Sie den Schlüssel in Anführungszeichen (JSON5 erlaubt zitierte Schlüssel). Konfigurationsschlüssel entsprechen standardmäßig dem **Skillnamen**. Wenn ein Skill `metadata.openclaw.skillKey` definiert, verwenden Sie diesen Schlüssel unter `skills.entries`. Regeln: * `enabled: false` deaktiviert den Skill, selbst wenn er gebündelt/installiert ist. * `env`: wird **nur** injiziert, **wenn** die Variable im Prozess noch nicht gesetzt ist. * `apiKey`: Komfortfunktion für Skills, die `metadata.openclaw.primaryEnv` deklarieren. * `config`: optionaler Sammelbehälter für benutzerdefinierte, skill-spezifische Felder; benutzerdefinierte Schlüssel müssen hier liegen. * `allowBundled`: optionale Allowlist nur für **gebündelte** Skills. Wenn gesetzt, sind nur die in der Liste enthaltenen gebündelten Skills zulässig (verwaltete/Workspace-Skills bleiben unberührt). ## Umgebungsinjektion (pro Agentenlauf) Wenn ein Agentenlauf startet, führt OpenClaw Folgendes aus: 1. Liest Skill-Metadaten. 2. Wendet `skills.entries..env` oder `skills.entries..apiKey` auf `process.env` an. 3. Baut den System-Prompt mit **zulässigen** Skills. 4. Stellt die ursprüngliche Umgebung nach Ende des Laufs wieder her. Dies ist **auf den Agentenlauf beschränkt**, nicht auf eine globale Shell-Umgebung. ## Sitzungs-Snapshot (Performance) OpenClaw erstellt **beim Start einer Sitzung** einen Snapshot der zulässigen Skills und verwendet diese Liste für nachfolgende Züge in derselben Sitzung. Änderungen an Skills oder Konfiguration werden in der nächsten neuen Sitzung wirksam. Skills können sich auch während einer Sitzung aktualisieren, wenn der Skills-Watcher aktiviert ist oder wenn ein neuer zulässiger Remote-Node erscheint (siehe unten). Betrachten Sie dies als **Hot Reload**: Die aktualisierte Liste wird beim nächsten Agenten-Zug übernommen. ## Remote-macOS-Nodes (Linux-Gateway) Wenn das Gateway unter Linux läuft, aber ein **macOS-Node** verbunden ist **mit erlaubtem `system.run`** (Exec-Approval-Sicherheit nicht auf `deny` gesetzt), kann OpenClaw macOS-spezifische Skills als zulässig behandeln, wenn die erforderlichen Binärdateien auf diesem Node vorhanden sind. Der Agent sollte diese Skills über das Werkzeug `nodes` ausführen (typischerweise `nodes.run`). Dies beruht darauf, dass der Node seine Befehlsunterstützung meldet und auf einer Binärprüfung über `system.run`. Wenn der macOS-Node später offline geht, bleiben die Skills sichtbar; Aufrufe können fehlschlagen, bis der Node wieder verbunden ist. ## Skills-Watcher (Auto-Refresh) Standardmäßig überwacht OpenClaw Skill-Ordner und erhöht den Skills-Snapshot, wenn sich `SKILL.md`-Dateien ändern. Konfigurieren Sie dies unter `skills.load`: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { skills: { load: { watch: true, watchDebounceMs: 250, }, }, } ``` ## Token-Auswirkung (Skills-Liste) Wenn Skills zulässig 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 ``-, ``- und ``-Werte. Formel (Zeichen): ``` total = 195 + Σ (97 + len(name_escaped) + len(description_escaped) + len(location_escaped)) ``` Hinweise: * XML-Escaping erweitert `& < > " '` zu Entitäten (`&`, `<` usw.) und erhöht die Länge. * Token-Zahlen variieren je nach Tokenizer des Modells. Eine grobe OpenAI-ähnliche Schätzung liegt bei \~4 Zeichen/Token, also **97 Zeichen ≈ 24 Tokens** pro Skill plus die tatsächlichen Feldlängen. ## Lebenszyklus verwalteter Skills OpenClaw liefert eine Basismenge an Skills als **gebündelte Skills** als Teil der Installation (npm-Paket oder OpenClaw\.app). `~/.openclaw/skills` existiert für lokale Overrides (z. B. zum Pinnen/Patchen eines Skills ohne Änderung der gebündelten Kopie). Workspace-Skills sind benutzerverwaltet und überschreiben beide bei Namenskonflikten. ## Konfigurationsreferenz Siehe [Skills config](/tools/skills-config) für das vollständige Konfigurationsschema. ## Auf der Suche nach mehr Skills? Stöbern Sie unter [https://clawhub.com](https://clawhub.com). ***