skills in
~/.openclaw/openclaw.json. Die agentenspezifische Sichtbarkeit befindet sich unter
agents.defaults.skills und agents.entries.*.skills.
Verwenden Sie für die integrierte Bilderzeugung
agents.defaults.mediaModels.image
zusammen mit dem zentralen Tool image_generate anstelle von skills.entries. Skill-Einträge
sind ausschließlich für benutzerdefinierte oder Drittanbieter-Skill-Workflows vorgesehen.Laden (skills.load)
string[]
Zusätzliche zu durchsuchende Skill-Verzeichnisse mit der niedrigsten Priorität (unterhalb
gebündelter Skills und Plugin-Skills). Pfade werden mit Unterstützung für
~ erweitert.string[]
Vertrauenswürdige tatsächliche Zielverzeichnisse, in die über Symlinks eingebundene Skill-Ordner
aufgelöst werden dürfen, selbst wenn sich der Symlink außerhalb des konfigurierten Stammverzeichnisses
befindet. Verwenden Sie dies für beabsichtigte Layouts mit benachbarten Repositorys wie
<workspace>/skills/manager -> ~/Projects/manager/skills. Halten Sie diese Liste
eng begrenzt — verweisen Sie nicht auf weit gefasste Stammverzeichnisse wie ~ oder ~/Projects.boolean
Standard:"true"
Überwacht Skill-Ordner und aktualisiert den Skills-Snapshot, wenn sich
SKILL.md-Dateien
ändern. Dies umfasst verschachtelte Dateien unter gruppierten Skill-Stammverzeichnissen.Installation (skills.install)
boolean
Standard:"true"
Bevorzugt Homebrew-Installationsprogramme, wenn
brew verfügbar ist."npm" | "pnpm" | "yarn" | "bun"
Standard:"\"npm\""
Bevorzugter Node-Paketmanager für Skill-Installationen. Dies betrifft ausschließlich
Skill-Installationen – die OpenClaw-CLI und die Gateway-Laufzeit benötigen Node, da der
kanonische Zustandsspeicher
node:sqlite verwendet. openclaw setup --node-manager und
openclaw onboard --node-manager akzeptieren npm, pnpm oder bun; legen Sie
"yarn" für Yarn-basierte Skill-Installationen direkt in der Konfiguration fest.boolean
Standard:"false"
Erlaubt vertrauenswürdigen
operator.admin-Gateway-Clients, private ZIP-Archive zu installieren,
die über skills.upload.* bereitgestellt wurden. Normale ClawHub-Installationen benötigen
diese Einstellung nicht.Installationsrichtlinie für Betreiber (security.installPolicy)
Verwenden Sie security.installPolicy, wenn Betreiber einen vertrauenswürdigen lokalen Befehl benötigen,
um Skill- und Plugin-Installationen anhand hostspezifischer Richtlinien zu genehmigen oder zu blockieren. Die
Richtlinie wird ausgeführt, nachdem OpenClaw das Quellmaterial bereitgestellt hat und bevor die Installation
oder Aktualisierung fortgesetzt wird. Sie gilt für ClawHub-Skills, hochgeladene Skills, Git-/lokale
Skills, Installationsprogramme für Skill-Abhängigkeiten sowie Quellen für Plugin-Installationen und -Aktualisierungen.
boolean
Standard:"false"
Aktiviert die betreibereigene Installationsrichtlinie. Wenn sie ohne gültigen
exec-Befehl
aktiviert wird, werden Installationen standardmäßig blockiert.("skill" | "plugin")[]
Optionaler Zielfilter. Wenn er weggelassen wird, gilt die Richtlinie für jedes unterstützte
Ziel, damit neue Installationen nicht unerwartet standardmäßig zugelassen werden.
string
Absoluter Pfad zur vertrauenswürdigen ausführbaren Richtliniendatei. OpenClaw führt sie ohne
Shell aus und validiert den Pfad vor der Verwendung.
string[]
Statische Argumente, die nach
command übergeben werden.number
Standard:"10000"
Maximale Gesamtlaufzeit für eine Richtlinienentscheidung.
number
Standard:"timeoutMs"
Maximale Zeit ohne Ausgabe auf stdout oder stderr, bevor die Richtlinie
standardmäßig blockiert.
number
Standard:"1048576"
Maximale kombinierte Anzahl an stdout- und stderr-Bytes, die vom Richtlinienprozess akzeptiert wird.
Record<string, string>
Literale Umgebungsvariablen, die dem Richtlinienprozess bereitgestellt werden.
string[]
Namen von Umgebungsvariablen, die aus dem OpenClaw-Prozess in den
Richtlinienprozess kopiert werden. Nur benannte Variablen werden übergeben.
string[]
Optionale Positivliste von Verzeichnissen, die die ausführbare Richtliniendatei enthalten dürfen.
boolean
Standard:"false"
Umgeht Prüfungen der Eigentümerschaft und Berechtigungen des Befehlspfads. Verwenden Sie dies nur, wenn der
Pfad durch einen anderen Mechanismus geschützt ist.
boolean
Standard:"false"
Erlaubt, dass der konfigurierte Befehlspfad ein Symlink ist. Das aufgelöste Ziel
muss weiterhin die übrigen Pfadprüfungen erfüllen. Argumente für Interpreter-Skripte müssen
direkte reguläre Dateien und dürfen keine Symlinks sein.
protocolVersion: 1,
openclawVersion, targetType, targetName, sourcePath, sourcePathKind,
optionalem strukturiertem source, strukturiertem origin und request. Sie muss
über stdout ein JSON-Objekt ausgeben: { "protocolVersion": 1, "decision": "allow" }
oder { "protocolVersion": 1, "decision": "block", "reason": "..." }. Ein von null verschiedener
Exit-Code, eine Zeitüberschreitung, fehlerhaftes JSON, fehlende Felder oder nicht unterstützte Protokollversionen
führen zur standardmäßigen Blockierung.
OpenClaw führt die Installationsrichtlinie beim normalen Start des Gateways nicht aus.
Installationen und Aktualisierungen werden standardmäßig blockiert, wenn die Richtlinie aktiviert, aber nicht verfügbar ist.
openclaw doctor führt eine statische Validierung durch; openclaw doctor --deep
führt eine synthetische Installationsprüfung für den konfigurierten Befehl aus.
Bei Massenaktualisierungen wird die Richtlinie auf jedes Ziel einzeln angewendet: Eine blockierte Aktualisierung
eines Skills oder Plugins lässt dieses Ziel fehlschlagen, ohne die Richtlinie zu deaktivieren oder spätere Ziele
im Stapel zu überspringen.
Beispiel für stdin:
Positivliste gebündelter Skills
string[]
Optionale Positivliste ausschließlich für gebündelte Skills. Wenn sie festgelegt ist, kommen nur die
gebündelten Skills in der Liste infrage. Verwaltete Skills sowie Skills auf Agenten- und Workspace-Ebene
sind davon nicht betroffen.
Einträge pro Skill (skills.entries)
Schlüssel unter entries entsprechen standardmäßig der name des Skills. Wenn ein Skill
metadata.openclaw.skillKey definiert, verwenden Sie stattdessen diesen Schlüssel. Setzen Sie Namen mit Bindestrichen
in Anführungszeichen (JSON5 erlaubt Schlüssel in Anführungszeichen).
boolean
false deaktiviert den Skill, selbst wenn er gebündelt oder installiert ist. Der
gebündelte Skill coding-agent muss explizit aktiviert werden — setzen Sie ihn auf true und stellen Sie sicher, dass
claude, codex, opencode oder eine andere unterstützte CLI installiert und
authentifiziert ist.string | { source, provider, id }
Komfortfeld für Skills, die
metadata.openclaw.primaryEnv deklarieren.
Unterstützt eine Klartextzeichenfolge oder eine SecretRef: { source: "env", provider: "default", id: "VAR_NAME" }.Record<string, string>
Umgebungsvariablen, die für die Agentenausführung eingefügt werden. Sie werden nur eingefügt, wenn die
Variable im Prozess noch nicht festgelegt ist.
object
Optionales Objekt für benutzerdefinierte Konfigurationsfelder pro Skill.
Agenten-Positivlisten (agents)
Verwenden Sie die Agentenkonfiguration, wenn dieselben Skill-Stammverzeichnisse für Maschine und Workspace,
aber für jeden Agenten eine andere sichtbare Skill-Menge verwendet werden soll.
string[]
Gemeinsame Basis-Positivliste, die von Agenten übernommen wird, bei denen
agents.entries.*.skills fehlt. Lassen Sie sie vollständig weg, damit Skills standardmäßig
nicht eingeschränkt werden.string[]
Explizite endgültige Skill-Menge für diesen Agenten. Explizite Listen ersetzen
übernommene Standardwerte — sie werden nicht zusammengeführt. Setzen Sie sie auf
[], um für
diesen Agenten keine Skills bereitzustellen.Workshop (skills.workshop)
boolean
Standard:"false"
Wenn
true festgelegt ist, kann OpenClaw aus dauerhaften Korrekturen ausstehende Vorschläge erstellen
und erfolgreiche, umfangreiche abgeschlossene Arbeiten prüfen, nachdem das System
inaktiv geworden ist. Dadurch kann nach geeigneten Durchläufen ein Modellauslauf im Hintergrund
hinzukommen. Die vom Benutzer veranlasste Erstellung von Skills und /learn funktionieren weiterhin, wenn die Einstellung false ist."pending" | "auto"
Standard:"\"auto\""
auto ermöglicht das vom Agenten initiierte Anwenden, Ablehnen oder unter Quarantäne stellen ohne eine
zusätzliche Genehmigungsaufforderung. pending erfordert die Genehmigung durch den Betreiber.boolean
Standard:"false"
Ermöglicht Skill Workshop beim Anwenden, über Symlinks von Workspace-Skills zu schreiben, deren
tatsächliches Ziel bereits durch
skills.load.allowSymlinkTargets als vertrauenswürdig eingestuft ist. Lassen Sie
diese Option deaktiviert, sofern das Anwenden generierter Vorschläge nicht diesen gemeinsam genutzten
Skill-Stammordner verändern soll.number
Standard:"50"
Maximale Anzahl ausstehender und unter Quarantäne gestellter Vorschläge, die pro Workspace aufbewahrt werden (zulässiger
Bereich: 1-200).
number
Standard:"40000"
Maximale Größe des Vorschlagstexts in Byte (zulässiger Bereich: 1024-200000). Vorschlagsbeschreibungen
sind separat fest auf 160 Byte begrenzt, da sie in der Erkennungs- und Listenausgabe
erscheinen.
Über Symlinks eingebundene Skill-Stammordner
Standardmäßig sind Workspace-, Projektagenten-, Zusatzverzeichnis- und gebündelte Skill-Stammordner Begrenzungsgrenzen. Ein über Symlink eingebundener Skill-Ordner unter<workspace>/skills,
der auf ein Ziel außerhalb des Stammordners verweist, wird mit einer Protokollmeldung übersprungen.
Um ein beabsichtigtes Symlink-Layout zuzulassen, deklarieren Sie das vertrauenswürdige Ziel:
<workspace>/skills/manager -> ~/Projects/manager/skills
nach der Realpath-Auflösung akzeptiert. extraDirs durchsucht das benachbarte Repository
direkt; allowSymlinkTargets behält den über Symlink eingebundenen Pfad für bestehende
Layouts bei.
Beim Anwenden schreibt Skill Workshop standardmäßig nicht über diese Symlinks. Damit
Workshop beim Anwenden Skills unter bereits vertrauenswürdigen Symlink-Zielen verändern kann, aktivieren
Sie dies separat:
~/.openclaw/skills- und persönliche ~/.agents/skills-Verzeichnisse
akzeptieren Symlinks auf Skill-Verzeichnisse bereits uneingeschränkt (die Begrenzung von
SKILL.md pro Skill gilt weiterhin) — allowSymlinkTargets wird nur
für Workspace-, Zusatzverzeichnis- und Projektagenten-Stammordner (<workspace>/.agents/skills)
benötigt.
Skills in Sandboxes und Umgebungsvariablen
Übergeben Sie Geheimnisse wie folgt an eine Docker-Sandbox:Benutzer mit Zugriff auf den Docker-Daemon können
sandbox.docker.env-Werte
über Docker-Metadaten einsehen. Verwenden Sie eine eingebundene Geheimnisdatei, ein benutzerdefiniertes Image oder
einen anderen Bereitstellungsweg, wenn diese Offenlegung nicht akzeptabel ist.Erinnerung an die Ladereihenfolge
Verwandte Themen
Skills-Referenz
Was Skills sind, Ladereihenfolge, Zugriffssteuerung und SKILL.md-Format.
Skills erstellen
Erstellung benutzerdefinierter Workspace-Skills.
Skill Workshop
Vorschlagswarteschlange für vom Agenten entworfene Skills.
Selbstlernen
Konservative, freiwillig aktivierte Vorschläge aus abgeschlossenen Arbeiten.
Slash-Befehle
Nativer Katalog von Slash-Befehlen und Chat-Direktiven.