​

Skills (OpenClaw)

​

Speicherorte und Priorität

1. Zusätzliche Skill-Ordner: konfiguriert mit skills.load.extraDirs
2. Gebündelte Skills: mit der Installation ausgeliefert (npm-Paket oder OpenClaw.app)
3. Verwaltete/lokale Skills: ~/.openclaw/skills
4. Persönliche Agent-Skills: ~/.agents/skills
5. Projekt-Agent-Skills: <workspace>/.agents/skills
6. Workspace-Skills: <workspace>/skills

​

Skills pro Agent vs. gemeinsame Skills

• Skills pro Agent liegen in <workspace>/skills und gelten nur für diesen Agenten.
• Projekt-Agent-Skills liegen in <workspace>/.agents/skills und gelten für diesen Workspace vor dem normalen Ordner skills/ des Workspace.
• Persönliche Agent-Skills liegen in ~/.agents/skills und gelten workspaceübergreifend auf diesem Rechner.
• Gemeinsame Skills liegen in ~/.openclaw/skills (verwaltet/lokal) und sind für alle Agenten auf demselben Rechner sichtbar.
• Gemeinsame Ordner können auch über skills.load.extraDirs hinzugefügt werden (niedrigste Priorität), wenn Sie ein gemeinsames Skills-Paket für mehrere Agenten verwenden möchten.

​

Skill-Allowlists pro Agent

• Speicherort/Priorität entscheidet, welche Kopie eines gleichnamigen Skills gewinnt.
• Agent-Allowlists entscheiden, welche sichtbaren Skills ein Agent tatsächlich verwenden kann.

{
  agents: {
    defaults: {
      skills: ["github", "weather"],
    },
    list: [
      { id: "writer" }, // erbt github, weather
      { id: "docs", skills: ["docs-search"] }, // ersetzt Standards
      { id: "locked-down", skills: [] }, // keine Skills
    ],
  },
}

• agents.defaults.skills weglassen für standardmäßig uneingeschränkte Skills.
• agents.list[].skills weglassen, um agents.defaults.skills zu erben.
• agents.list[].skills: [] setzen für keine Skills.
• Eine nicht leere Liste in agents.list[].skills ist die endgültige Menge für diesen Agenten; sie wird nicht mit den Standards zusammengeführt.

​

Plugins + Skills

​

ClawHub (Installation + Synchronisierung)

• Einen Skill in Ihren Workspace installieren:
  • openclaw skills install <skill-slug>
• Alle installierten Skills aktualisieren:
  • openclaw skills update --all
• Synchronisieren (scannen + Updates veröffentlichen):
  • clawhub sync --all

​

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 Tools. Siehe Sandboxing.
• Die Erkennung von Workspace-Skills und Skills aus zusätzlichen Verzeichnissen akzeptiert nur Skill-Roots und SKILL.md-Dateien, deren aufgelöster realpath innerhalb der konfigurierten Root bleibt.
• Gateway-gestützte Installationen von Skill-Abhängigkeiten (skills.install, Onboarding und die UI für Skills-Einstellungen) führen den integrierten Scanner für gefährlichen Code aus, bevor Installer-Metadaten ausgeführt werden. Befunde mit critical blockieren standardmäßig, es sei denn, der Aufrufer setzt explizit den Override für gefährlichen Code; verdächtige Befunde führen weiterhin nur zu Warnungen.
• openclaw skills install <slug> ist etwas anderes: Es lädt einen ClawHub-Skill-Ordner in den Workspace herunter und verwendet nicht den oben beschriebenen Pfad mit Installer-Metadaten.
• 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 umfassenderes Bedrohungsmodell und Checklisten siehe Security.

​

Format (AgentSkills + Pi-kompatibel)

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

• Wir folgen der AgentSkills-Spezifikation für Layout/Absicht.
• Der Parser, der vom eingebetteten Agenten verwendet wird, unterstützt nur einzeilige Frontmatter-Schlüssel.
• metadata sollte ein einzeiliges JSON-Objekt sein.
• Verwenden Sie {baseDir} in Anweisungen, um auf den Pfad des Skill-Ordners zu verweisen.
• Optionale Frontmatter-Schlüssel:
  • homepage — URL, die in der macOS-UI für Skills als „Website“ angezeigt wird (auch unterstützt über metadata.openclaw.homepage).
  • user-invocable — true|false (Standard: true). Wenn true, wird der Skill als Slash-Command für Benutzer bereitgestellt.
  • disable-model-invocation — true|false (Standard: false). Wenn true, wird der Skill aus dem Model-Prompt ausgeschlossen (weiterhin über Benutzeraufruf verfügbar).
  • command-dispatch — tool (optional). Wenn auf tool gesetzt, umgeht der Slash-Command das Model und leitet direkt an ein Tool weiter.
  • command-tool — Name des Tools, das aufgerufen werden soll, wenn command-dispatch: tool gesetzt ist.
  • command-arg-mode — raw (Standard). Bei Tool-Dispatch wird die rohe Argumentzeichenfolge an das Tool weitergeleitet (kein Core-Parsing). Das Tool wird mit folgenden Parametern aufgerufen: { command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }.

​

Gating (Filter zur Ladezeit)

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

• always: true — Skill immer einschließen (andere Gates überspringen).
• emoji — optionales Emoji, das von der macOS-UI für Skills verwendet wird.
• homepage — optionale URL, die in der macOS-UI für Skills als „Website“ angezeigt wird.
• os — optionale Liste von Plattformen (darwin, linux, win32). Wenn gesetzt, ist der Skill nur auf diesen Betriebssystemen zulässig.
• requires.bins — Liste; jede Binärdatei muss auf PATH existieren.
• requires.anyBins — Liste; mindestens eine muss auf PATH existieren.
• requires.env — Liste; Umgebungsvariable muss existieren oder in der Konfiguration bereitgestellt werden.
• requires.config — Liste von openclaw.json-Pfaden, die truthy sein müssen.
• primaryEnv — Name der Umgebungsvariable, die skills.entries.<name>.apiKey zugeordnet ist.
• install — optionales Array von Installer-Spezifikationen, das von der macOS-UI für Skills verwendet wird (brew/node/go/uv/download).

• requires.bins wird zur Ladezeit des Skills auf dem Host geprüft.
• Wenn ein Agent sandboxed ist, muss die Binärdatei auch im Container 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 CLI summarize im Sandbox-Container, um dort ausgeführt zu werden.

---
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)",
            },
          ],
      },
  }
---

• Wenn mehrere Installer aufgelistet sind, wählt das Gateway eine einzige bevorzugte Option aus (brew, wenn verfügbar, sonst 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 respektieren skills.install.nodeManager in openclaw.json (Standard: npm; Optionen: npm/pnpm/yarn/bun). Dies betrifft nur Skill-Installationen; die Gateway-Runtime sollte weiterhin Node sein (Bun wird für WhatsApp/Telegram nicht empfohlen).
• Die Auswahl Gateway-gestützter Installer ist präferenzgesteuert, nicht nur node-basiert: Wenn Installationsspezifikationen verschiedene Arten mischen, bevorzugt OpenClaw Homebrew, wenn skills.install.preferBrew aktiviert ist und brew existiert, dann uv, dann den konfigurierten Node-Manager und dann andere Fallbacks wie go oder download.
• Wenn jede Installationsspezifikation download ist, zeigt OpenClaw alle Download-Optionen an, statt sie auf einen bevorzugten Installer zu reduzieren.
• Go-Installationen: Wenn go fehlt und brew verfügbar ist, installiert das Gateway Go zuerst über Homebrew und setzt GOBIN nach Möglichkeit auf das bin-Verzeichnis von Homebrew.
• Download-Installationen: url (erforderlich), archive (tar.gz | tar.bz2 | zip), extract (Standard: automatisch, wenn ein Archiv erkannt wird), stripComponents, targetDir (Standard: ~/.openclaw/tools/<skillKey>).

​

Konfigurations-Overrides (~/.openclaw/openclaw.json)

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

• enabled: false deaktiviert den Skill, auch wenn er gebündelt/installiert ist.
• env: wird nur dann injiziert, wenn die Variable nicht bereits im Prozess gesetzt ist.
• apiKey: Komfortfunktion für Skills, die metadata.openclaw.primaryEnv deklarieren. Unterstützt Klartext-String oder SecretRef-Objekt ({ source, provider, id }).
• config: optionaler Container für benutzerdefinierte Felder pro Skill; benutzerdefinierte Schlüssel müssen hier liegen.
• allowBundled: optionale Allowlist nur für gebündelte Skills. Wenn gesetzt, sind nur gebündelte Skills in der Liste zulässig (verwaltete/Workspace-Skills bleiben unberührt).

​

Environment-Injektion (pro Agent-Ausführung)

1. Skill-Metadaten lesen.
2. skills.entries.<key>.env oder skills.entries.<key>.apiKey auf process.env anwenden.
3. Den System-Prompt mit zulässigen Skills erstellen.
4. Die ursprüngliche Umgebung nach Ende der Ausführung wiederherstellen.

​

Sitzungs-Snapshot (Leistung)

​

Remote-macOS-Nodes (Linux-Gateway)

​

Skills-Watcher (automatische Aktualisierung)

{
  skills: {
    load: {
      watch: true,
      watchDebounceMs: 250,
    },
  },
}

​

Token-Auswirkung (Skills-Liste)

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

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

• XML-Escaping erweitert & < > " ' zu Entities (&, < usw.) und erhöht dadurch die Länge.
• Die Token-Zahl variiert je nach Tokenizer des Models. Eine grobe Schätzung im OpenAI-Stil ist ~4 Zeichen/Token, daher entsprechen 97 Zeichen ≈ 24 Tokens pro Skill zuzüglich Ihrer tatsächlichen Feldlängen.

​

Lebenszyklus verwalteter Skills

​

Konfigurationsreferenz

​

Suchen Sie nach weiteren Skills?

​

Verwandt

• Skills erstellen — benutzerdefinierte Skills erstellen
• Skills-Konfiguration — Referenz zur Skill-Konfiguration
• Slash Commands — alle verfügbaren Slash-Commands
• Plugins — Überblick über das Plugin-System