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 erben.
• Setzen Sie agents.list[].skills: [], um für diesen Agenten keine Skills bereitzustellen.
• Eine nicht leere agents.list[].skills-Liste ist die endgültige Menge — sie wird nicht mit den Defaults zusammengeführt.
• Die effektive Allowlist gilt für Prompt-Erstellung, Slash-Befehls-Erkennung, Sandbox-Synchronisierung und Skill-Snapshots.
• Dies ist keine Autorisierungsgrenze für die Host-Shell. Wenn derselbe Agent exec verwenden kann, beschränken Sie diese Shell separat mit Sandboxing, OS-Benutzer-Isolation, Exec-Deny-/Allowlists und ressourcenspezifischen Anmeldedaten.

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

Git- und lokale Installationen erwarten SKILL.md an der Quellwurzel. Der Slug stammt aus dem name-Frontmatter von SKILL.md, wenn gültig, und fällt sonst auf den Verzeichnis- oder Repository-Namen zurück. Verwenden Sie --as <slug>, um ihn 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 ClawHub nach dem clawhub.skill.verify.v1 Trust Envelope des Skills. Installierte ClawHub-Skills werden gegen die Version und Registry geprüft, die in .clawhub/origin.json aufgezeichnet sind. Bloße Slugs bleiben für bestehende installierte oder eindeutige Skills akzeptiert, aber owner-qualifizierte Refs vermeiden Publisher-Mehrdeutigkeit.

ClawHub-Skill-Seiten zeigen vor der Installation den neuesten Sicherheits-Scanstatus mit Detailseiten für VirusTotal, ClawScan und statische Analyse. Der Befehl beendet sich mit einem Wert ungleich null, wenn ClawHub die Verifizierung als fehlgeschlagen markiert. Publisher beheben False Positives über das ClawHub-Dashboard oder clawhub skill rescan @owner/<slug>.

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 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 nie.

Die Skill-Erkennung für Workspace-, Projekt-Agent- und Zusatzverzeichnis-Skills akzeptiert nur Skill-Wurzeln, deren aufgelöster Realpath innerhalb der konfigurierten Wurzel bleibt, es sei denn, skills.load.allowSymlinkTargets vertraut explizit einer Zielwurzel. Skill-Workshop schreibt nur dann über diese vertrauenswürdigen Ziele, wenn skills.workshop.allowSymlinkTargetWrites aktiviert ist. Verwaltete ~/.openclaw/skills und persönliche ~/.agents/skills dürfen symlinkte Skill-Ordner enthalten, aber jeder SKILL.md-Realpath muss weiterhin innerhalb seines 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 bereitgestellten Quellpfad, gilt für ClawHub-, Upload-, Git-, lokale, Update- und Dependency-Installer-Pfade und schlägt geschlossen fehl, wenn der Befehl keine gültige Entscheidung zurückgeben kann.

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

• Wenn mehrere Installationsprogramme aufgeführt sind, wählt der Gateway eine bevorzugte Option (brew, wenn verfügbar, andernfalls node).
• Wenn alle Installationsprogramme download sind, listet 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 wirkt sich nur auf Skill-Installationen aus; die Gateway-Laufzeit sollte weiterhin Node sein.
• Gateway-Präferenz für Installationsprogramme: 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 nur-brew-Installationsprogramme ausgeblendet; verwenden Sie ein eigenes Image oder installieren Sie die Abhängigkeit manuell.
• Go: OpenClaw erfordert Go 1.21 oder neuer für automatische Skill-Installationen und bewahrt die vorhandenen Einstellungen GOBIN, GOPATH und GOTOOLCHAIN. Wenn die konfigurierte Toolchain die erforderliche Go-Version eines Moduls nicht erfüllen kann, gruppiert das Onboarding den Skill nach dem Installationsversuch mit manuellen Go-Voraussetzungen. Wenn go fehlt und Homebrew verfügbar ist, installiert OpenClaw zuerst Go über Homebrew und setzt GOBIN auf das bin von Homebrew. Unter Linux kann OpenClaw stattdessen apt-get als root oder über passwortloses sudo verwenden, wenn der aktualisierte golang-go-Kandidat die Mindestversion erfüllt.
• Download: url (erforderlich), archive (tar.gz | tar.bz2 | zip), extract (Standard: auto, wenn Archiv erkannt), stripComponents, targetDir (Standard: ~/.openclaw/tools/<skillKey>).

requires.bins wird beim Laden des Skills auf dem Host geprüft. Wenn ein Agent in einer Sandbox läuft, muss die Binärdatei auch innerhalb des Containers vorhanden sein. Installieren Sie sie über agents.defaults.sandbox.docker.setupCommand oder ein eigenes Image. setupCommand läuft einmal nach der Containererstellung und erfordert ausgehenden Netzwerkzugriff, ein beschreibbares Root-Dateisystem und einen root-Benutzer in der Sandbox.

Standardmäßig überwacht OpenClaw Skill-Ordner und erhöht 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,      watchDebounceMs: 250,    },  },}

Verwenden Sie allowSymlinkTargets für absichtlich per Symlink verknüpfte Layouts, bei denen ein Skill-Root-Symlink außerhalb des konfigurierten Roots zeigt, zum Beispiel <workspace>/skills/manager -> ~/Projects/manager/skills. Aktivieren Sie skills.workshop.allowSymlinkTargetWrites nur, wenn Skill Workshop Vorschläge auch über diese vertrauenswürdigen Symlink-Pfade anwenden soll.

Wenn der Gateway unter Linux läuft, aber ein macOS-Knoten mit erlaubtem system.run verbunden ist, kann OpenClaw macOS-only Skills als zulässig behandeln, wenn die erforderlichen Binärdateien auf diesem Knoten vorhanden sind. Der Agent sollte diese Skills über das Tool exec mit host=node ausführen.

Offline-Knoten machen remote-only Skills nicht sichtbar. Wenn ein Knoten nicht mehr auf Binärdatei-Probes antwortet, löscht OpenClaw seine gecachten Binärdatei-Treffer.