Skip to main content
Die meiste Skills-Konfiguration befindet sich unter 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.
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.
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.
Die Richtlinie empfängt über stdin ein JSON-Objekt mit 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:
Minimaler Richtlinienbefehl:

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.
Agenten-Skill-Positivlisten dienen als Sichtbarkeits- und Ladefilter für die OpenClaw- Skill-Erkennung, Prompts, Slash-Befehlserkennung, Sandbox-Synchronisierung und Skill- Snapshots. Sie bilden keine Autorisierungsgrenze zur Shell-Laufzeit. Wenn ein Agent exec auf dem Host ausführen kann, kann diese Shell weiterhin externe Clients ausführen oder Hostdateien lesen, die für den ausführenden Benutzer sichtbar sind, einschließlich MCP-Client- Registrierungen wie ~/.openclaw/skills/config/mcporter.json. Kombinieren Sie für die agentenspezifische MCP-Isolierung Skill-Positivlisten mit einer Sandbox-/Betriebssystembenutzer- Isolierung, verweigern Sie die Host-Ausführung oder begrenzen Sie sie durch eine enge Positivliste und bevorzugen Sie agentenspezifische Anmeldedaten auf dem MCP-Server.

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.
Unter Selbstlernen finden Sie Informationen zu Eignung, Datenschutz, Kosten, Berechtigungen nur für Vorschläge und Fehlerbehebung.
"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.
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.
Unter Skill Workshop finden Sie Informationen zum Lebenszyklus von Vorschlägen, zu CLI- Befehlen, Parametern der Agentenwerkzeuge und Gateway-Methoden, die von dieser Konfiguration gesteuert werden. 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:
Mit dieser Konfiguration wird <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:
Verwaltete ~/.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

skills.entries.<skill>.env und apiKey gelten nur für Ausführungen auf dem Host. Innerhalb einer Sandbox haben sie keine Wirkung — ein Skill, der von GEMINI_API_KEY abhängt, schlägt mit apiKey not configured fehl, sofern die Variable der Sandbox nicht separat bereitgestellt wird.
Ü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

Änderungen an Skills und Konfiguration werden in der nächsten neuen Sitzung wirksam, wenn die Überwachung aktiviert ist, oder beim nächsten Agentendurchlauf, wenn die Überwachung eine Änderung erkennt.

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.