Skills

• Lassen Sie agents.defaults.skills weg, damit standardmäßig alle Skills uneingeschränkt verfügbar bleiben.
• Lassen Sie agents.entries.*.skills weg, um agents.defaults.skills zu übernehmen.
• Setzen Sie agents.entries.*.skills: [], damit für diesen Agenten keine Skills verfügbar sind.
• Eine nicht leere agents.entries.*.skills-Liste ist die endgültige Menge — sie wird nicht mit den Standardwerten zusammengeführt.
• Die wirksame Zulassungsliste gilt für die Prompt-Erstellung, die Erkennung 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- Isolierung, Ausführungs-Sperr-/Zulassungslisten 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 gemeinsam genutzte Verzeichnis ~/.openclaw/skills zu installieren, das für alle lokalen Agenten sichtbar ist, sofern Agenten- Zulassungslisten dies nicht einschränken.

Git- und lokale Installationen erwarten SKILL.md im Stammverzeichnis der Quelle. Der Slug stammt, sofern gültig, aus name im Frontmatter SKILL.md; andernfalls wird der Verzeichnis- oder Repository-Name verwendet. Verwenden Sie --as <slug>, um ihn zu überschreiben. openclaw skills update verfolgt ausschließlich 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 erfassten Version und Registry verifiziert. Reine Slugs werden für bereits installierte oder eindeutige Skills weiterhin akzeptiert, aber um den Eigentümer ergänzte Referenzen vermeiden Mehrdeutigkeiten beim Herausgeber.

ClawHub-Skill-Seiten zeigen vor der Installation den aktuellen Status des Sicherheitsscans sowie Detailseiten für VirusTotal, ClawScan und statische Analyse. Der Befehl wird mit einem von null verschiedenen Status beendet, wenn ClawHub die Verifizierung als fehlgeschlagen kennzeichnet. Herausgeber können Fehlalarme über das ClawHub-Dashboard oder 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 nie.

Bei der Skill-Erkennung für Workspace-, Projekt-Agenten- und zusätzliche Verzeichnisse werden nur Skill- Stammverzeichnisse akzeptiert, deren aufgelöster Realpath innerhalb des konfigurierten Stammverzeichnisses bleibt, sofern skills.load.allowSymlinkTargets einem Zielstammverzeichnis nicht ausdrücklich vertraut. Skill Workshop schreibt nur über diese vertrauenswürdigen Ziele, wenn skills.workshop.allowSymlinkTargetWrites aktiviert ist. Das verwaltete ~/.openclaw/skills und das persönliche ~/.agents/skills dürfen über symbolische Links eingebundene Skill-Ordner enthalten, aber jeder Realpath von SKILL.md 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, 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 ausschließlich für diesen Agentendurchlauf in den Host-Prozess — nicht in die Sandbox. Halten Sie Secrets aus Prompts und Protokollen heraus.

• Wenn mehrere Installationsprogramme aufgeführt sind, wählt das Gateway eine bevorzugte Option aus (brew, falls verfügbar, andernfalls node).
• Wenn alle Installationsprogramme download sind, 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 wirkt sich nur auf Skill- Installationen aus; die Gateway-Laufzeit sollte weiterhin Node sein.
• Installationspräferenz 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 Installationsprogramme, die ausschließlich brew unterstützen, 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 passwortloses sudo verwendet werden, wenn der aktualisierte golang-go- Kandidat die Mindestversion erfüllt. Das tatsächliche go install für die Abhängigkeit zielt immer auf ein dediziertes, von OpenClaw verwaltetes Binärdateiverzeichnis (bei einer Neuinstallation bin von Homebrew, andernfalls ~/.local/bin) statt auf Ihr konfiguriertes 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    },  },}

Watcher-Ereignisse verwenden eine integrierte Entprellzeit von 250 ms. Verwenden Sie allowSymlinkTargets für beabsichtigte Layouts mit symbolischen Links, bei denen ein symbolischer Link des Skill- Stammverzeichnisses außerhalb des konfigurierten Stammverzeichnisses liegt, beispielsweise <workspace>/skills/manager -> ~/Projects/manager/skills. Aktivieren Sie skills.workshop.allowSymlinkTargetWrites nur, wenn Skill Workshop Vorschläge ebenfalls über diese vertrauenswürdigen Pfade mit symbolischen Links anwenden soll.

Wenn das Gateway unter Linux ausgeführt wird, aber ein macOS-Node mit zugelassenem system.run verbunden ist, kann OpenClaw ausschließlich für macOS verfügbare Skills als zulässig betrachten, 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 Binärdateiabfragen antwortet, löscht OpenClaw die zwischengespeicherten Binärdateiübereinstimmungen dieses Nodes.