Skills

• Lassen Sie agents.defaults.skills weg, damit standardmäßig alle Skills uneingeschränkt bleiben.
• Lassen Sie agents.list[].skills weg, um agents.defaults.skills zu übernehmen.
• Legen Sie agents.list[].skills: [] fest, um für diesen Agent keine Skills bereitzustellen.
• Eine nicht leere Liste agents.list[].skills ist die endgültige Menge — sie wird nicht mit den Standardwerten zusammengeführt.
• Die resultierende Allowlist gilt für die Prompt-Erstellung, die Ermittlung von Slash-Befehlen, die Sandbox-Synchronisierung und Skill-Snapshots.
• Dies ist keine Autorisierungsgrenze für die Host-Shell. Wenn derselbe Agent exec verwenden kann, schränken Sie diese Shell separat durch Sandboxing, Betriebssystembenutzer-Isolation, Exec-Deny-/Allowlists und ressourcenspezifische Anmeldedaten ein.

openclaw skills install installiert standardmäßig in das Verzeichnis skills/ des aktiven Workspace. Fügen Sie --global hinzu, um in das gemeinsame Verzeichnis ~/.openclaw/skills zu installieren, das für alle lokalen Agenten sichtbar ist, sofern Agent-Zulassungslisten es nicht einschränken.

Git- und lokale Installationen erwarten SKILL.md im Stammverzeichnis der Quelle. Der Slug wird aus name im Frontmatter von SKILL.md übernommen, sofern dieser gültig ist, und andernfalls wird der Verzeichnis- oder Repository-Name verwendet. Verwenden Sie --as <slug>, um dies zu überschreiben. openclaw skills update verfolgt nur ClawHub-Installationen — installieren Sie Git- oder lokale Quellen erneut, um sie zu aktualisieren.

openclaw skills verify @owner/<slug> fragt bei ClawHub den clawhub.skill.verify.v1-Vertrauensrahmen des Skills ab. Installierte ClawHub-Skills werden anhand der in .clawhub/origin.json aufgezeichneten Version und Registry überprüft. Reine Slugs werden für bereits installierte oder eindeutige Skills weiterhin akzeptiert, aber Referenzen mit Eigentümerangabe vermeiden Mehrdeutigkeiten beim Herausgeber.

ClawHub-Skill-Seiten zeigen vor der Installation den aktuellen Status des Sicherheitsscans an, mit Detailseiten für VirusTotal, ClawScan und statische Analyse. Der Befehl wird mit einem von null verschiedenen Status beendet, wenn ClawHub die Überprüfung als fehlgeschlagen markiert. Herausgeber können Fehlalarme über das ClawHub-Dashboard oder mit clawhub skill rescan @owner/<slug> beheben.

Gateway-Clients, die eine Bereitstellung außerhalb von ClawHub benötigen, können ein ZIP-Skill-Archiv mit skills.upload.begin, skills.upload.chunk und skills.upload.commit bereitstellen und es anschließend mit skills.install({ source: "upload", ... }) installieren. Dieser Pfad ist standardmäßig deaktiviert und erfordert skills.install.allowUploadedArchives: true in openclaw.json. Normale ClawHub-Installationen benötigen diese Einstellung niemals.

Die Skill-Erkennung für Workspace, Projekt-Agenten und zusätzliche Verzeichnisse akzeptiert nur Skill- Stammverzeichnisse, deren aufgelöster Realpfad innerhalb des konfigurierten Stammverzeichnisses bleibt, sofern skills.load.allowSymlinkTargets nicht ausdrücklich einem Zielstammverzeichnis vertraut. Skill Workshop schreibt nur dann über diese vertrauenswürdigen Ziele, wenn skills.workshop.allowSymlinkTargetWrites aktiviert ist. Das verwaltete Verzeichnis ~/.openclaw/skills und das persönliche Verzeichnis ~/.agents/skills dürfen über symbolische Links eingebundene Skill-Ordner enthalten, aber der Realpfad jeder SKILL.md muss dennoch innerhalb ihres aufgelösten Skill-Verzeichnisses bleiben.

Konfigurieren Sie security.installPolicy, um einen vertrauenswürdigen lokalen Richtlinienbefehl auszuführen, bevor Skill-Installationen fortgesetzt werden. Die Richtlinie erhält Metadaten und den Pfad zur bereitgestellten Quelle, gilt für ClawHub-, hochgeladene, Git- und lokale Quellen sowie für Aktualisierungs- und Abhängigkeitsinstallationspfade und verweigert den Vorgang, wenn der Befehl keine gültige Entscheidung zurückgeben kann.

skills.entries.*.env und skills.entries.*.apiKey injizieren Secrets nur für diesen Agent-Durchlauf in den Host-Prozess — nicht in die Sandbox. Halten Sie Secrets aus Prompts und Protokollen heraus.

• Wenn mehrere Installationsprogramme aufgeführt sind, wählt der Gateway eine bevorzugte Option aus (brew, falls verfügbar, andernfalls node).
• Wenn alle Installationsprogramme download verwenden, führt OpenClaw jeden Eintrag auf, damit Sie alle verfügbaren Artefakte sehen können.
• Spezifikationen können os: ["darwin"|"linux"|"win32"] enthalten, um 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.
• Bevorzugte Installationsprogramme des Gateways: Homebrew → uv → konfigurierter Node-Manager → go → download.

• Homebrew: OpenClaw installiert Homebrew nicht automatisch und übersetzt brew-Formeln nicht in Systempaketbefehle. In Linux-Containern ohne brew werden reine brew-Installationsprogramme ausgeblendet; verwenden Sie ein benutzerdefiniertes Image oder installieren Sie die Abhängigkeit manuell.
• Go: OpenClaw benötigt Go 1.21 oder neuer für automatische Skill-Installationen. Wenn go fehlt und Homebrew verfügbar ist, installiert OpenClaw zunächst Go über Homebrew; unter Linux ohne Homebrew kann stattdessen apt-get als Root oder über sudo ohne Passwort verwendet werden, wenn der aktualisierte golang-go-Kandidat die Mindestversion erfüllt. Der eigentliche Befehl go install für die Abhängigkeit verwendet immer ein dediziertes, von OpenClaw verwaltetes Binärverzeichnis (bei einer Neuinstallation bin von Homebrew, andernfalls ~/.local/bin) statt Ihres konfigurierten GOBIN — Ihre eigenen Umgebungsvariablen GOBIN, GOPATH und GOTOOLCHAIN werden gelesen, aber niemals überschrieben.
• Download: url (erforderlich), archive (tar.gz | tar.bz2 | zip), extract (Standard: automatisch, wenn ein Archiv erkannt wird), stripComponents, targetDir (Standard: ~/.openclaw/tools/<skillKey>).

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 nach der Containererstellung ausgeführt und erfordert ausgehenden Netzwerkzugriff, ein beschreibbares Root-Dateisystem und einen Root-Benutzer in der Sandbox.

Standardmäßig überwacht OpenClaw Skill-Ordner und aktualisiert den 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, // Standard      watchDebounceMs: 250, // Standard    },  },}

Verwenden Sie allowSymlinkTargets für beabsichtigte Layouts mit symbolischen Links, bei denen ein symbolischer Link des Skill-Stammverzeichnisses außerhalb des konfigurierten Stammverzeichnisses verweist, beispielsweise <workspace>/skills/manager -> ~/Projects/manager/skills. Aktivieren Sie skills.workshop.allowSymlinkTargetWrites nur, wenn Skill Workshop Vorschläge auch über diese vertrauenswürdigen Pfade mit symbolischen Links anwenden soll.

Wenn der Gateway unter Linux ausgeführt wird, aber ein macOS-Node mit zugelassenem system.run verbunden ist, kann OpenClaw ausschließlich für macOS vorgesehene Skills als zulässig behandeln, wenn die erforderlichen Binärdateien auf diesem Node vorhanden sind. Der Agent sollte diese Skills über das Tool exec mit host=node ausführen.

Offline-Nodes machen ausschließlich remote verfügbare Skills nicht sichtbar. Wenn ein Node nicht mehr auf Prüfungen von Binärdateien antwortet, löscht OpenClaw seine zwischengespeicherten Binärdateiübereinstimmungen.