Skill-Workshop

Skill Workshop ist OpenClaws geregelter Pfad zum Erstellen und Aktualisieren von Workspace-Skills.

Agents und Operators schreiben aktive SKILL.md-Dateien über diesen Pfad nicht direkt. Sie erstellen zuerst einen Vorschlag. Ein Vorschlag ist ein ausstehender Entwurf mit dem vorgeschlagenen Skill-Inhalt, der Zielbindung, dem Scanner-Status, Hashes, Supportdatei-Metadaten und Rollback-Metadaten. Er wird erst beim Anwenden zu einem Live-Skill.

Skill Workshop schreibt nur Workspace-Skills. Es verändert keine gebündelten Skills, Plugin-Skills, ClawHub-Skills, Extra-Root-Skills, verwalteten Skills, Personal-Agent-Skills oder System-Skills.

Funktionsweise

• Vorschlag zuerst: generierter Skill-Inhalt wird als PROPOSAL.md gespeichert, nicht als SKILL.md.
• Anwenden ist der einzige Live-Schreibvorgang: Erstellen, Aktualisieren und Überarbeiten ändern keine aktiven Skills.
• Workspace-begrenzt: Erstellungen zielen auf den Workspace-Root skills/. Aktualisierungen sind nur für schreibbare Workspace-Skills erlaubt.
• Kein Überschreiben: Erstellen schlägt fehl, wenn der Ziel-Skill bereits vorhanden ist.
• Hash-gebunden: Aktualisierungsvorschläge werden an den aktuellen Ziel-Hash gebunden und werden veraltet, wenn sich der Live-Skill vor dem Anwenden ändert.
• Scanner-gesteuert: Beim Anwenden wird vor dem Schreiben erneut gescannt.
• Wiederherstellbar: Beim Anwenden werden Rollback-Metadaten geschrieben, bevor Live-Dateien geändert werden.
• Konsistente Oberflächen: Chat, CLI und Gateway rufen alle denselben Skill-Workshop-Dienst auf.

Lebenszyklus

create/update -> pendingrevise        -> pendingapply         -> appliedreject        -> rejectedquarantine    -> quarantinedtarget change -> stale

Nur pending-Vorschläge können überarbeitet, angewendet, abgelehnt oder unter Quarantäne gestellt werden.

Chat

Fragen Sie den Agent nach dem gewünschten Skill. Der Agent ruft skill_workshop auf und gibt eine Vorschlags-ID zurück.

Erstellen:

Make a skill called morning-catchup that runs my Monday inbox routine.

Einen vorhandenen Workspace-Skill aktualisieren:

Update trip-planning to also check seat maps before booking.

Einen ausstehenden Vorschlag iterieren:

Show me the morning-catchup proposal.Revise it to also flag anything marked urgent.Apply the morning-catchup proposal.

Standardmäßig zeigen vom Agent initiiertes apply, reject und quarantine vor der Ausführung eine Genehmigungsaufforderung an. Setzen Sie skills.workshop.approvalPolicy auf "auto", um die Aufforderung in vertrauenswürdigen Umgebungen zu überspringen.

CLI

Einen neuen Skill-Vorschlag erstellen:

openclaw skills workshop propose-create \  --name morning-catchup \  --description "Daily inbox catch-up: triage, archive, surface, draft, plan" \  --proposal ./PROPOSAL.md

Einen Aktualisierungsvorschlag für einen vorhandenen Workspace-Skill erstellen:

openclaw skills workshop propose-update trip-planning --proposal ./PROPOSAL.md

Auflisten und prüfen:

openclaw skills workshop listopenclaw skills workshop inspect <proposal-id>

Vor der Genehmigung überarbeiten:

openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.md

Den Vorschlag abschließen:

openclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Duplicate"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"

Vorschlagsinhalt

Solange der Vorschlag ausstehend ist, wird er als PROPOSAL.md mit nur für Vorschläge vorgesehenem Frontmatter gespeichert:

---name: "morning-catchup"description: "Daily inbox catch-up: triage, archive, surface, draft, plan"status: proposalversion: "v1"date: "2026-05-30T00:00:00.000Z"---

Beim Anwenden schreibt Skill Workshop die aktive SKILL.md und entfernt nur für Vorschläge vorgesehene Felder: status, Vorschlags-version und Vorschlags-date.

Supportdateien

Verwenden Sie --proposal-dir, wenn der vorgeschlagene Skill Dateien neben PROPOSAL.md benötigt:

openclaw skills workshop propose-create \  --name weekly-update \  --description "Friday wrap-up: stats, highlights, next week's top three" \  --proposal-dir ./weekly-update-proposal

Das Verzeichnis muss PROPOSAL.md enthalten. Supportdateien müssen unter folgenden Verzeichnissen liegen:

• assets/
• examples/
• references/
• scripts/
• templates/

Skill Workshop scannt, hasht und speichert Supportdateien mit dem Vorschlag. Sie werden erst beim Anwenden neben die Live-SKILL.md geschrieben.

Abgelehnte Supportdateipfade umfassen absolute Pfade, versteckte Pfadsegmente, Pfad-Traversal, überlappende Pfade, ausführbare Dateien aus Vorschlagsverzeichnissen, Nicht-UTF-8-Text, Nullbytes und Dateien außerhalb der Standard-Supportordner.

Agent-Tool

Das Modell verwendet skill_workshop:

action: create | update | revise | list | inspect | apply | reject | quarantine

Agents müssen skill_workshop für generierte Skill-Arbeiten verwenden. Sie dürfen Vorschlagsdateien nicht über write, edit, exec, Shell-Befehle oder direkte Dateisystemoperationen erstellen oder ändern.

Genehmigung und Autonomie

{  skills: {    workshop: {      autonomous: {        enabled: false,      },      allowSymlinkTargetWrites: false,      approvalPolicy: "pending",      maxPending: 50,      maxSkillBytes: 40000,    },  },}

• autonomous.enabled: erlaubt OpenClaw, nach erfolgreichen Durchläufen aus dauerhaften Konversationssignalen ausstehende Vorschläge zu erstellen. Standard: false.
• allowSymlinkTargetWrites: erlaubt dem Anwenden, durch Workspace-Skill-Symlinks zu schreiben, deren reales Ziel in skills.load.allowSymlinkTargets aufgeführt ist. Standard: false.
• approvalPolicy: "pending": erfordert vor vom Agent initiiertem apply, reject oder quarantine eine Genehmigungsaufforderung.
• approvalPolicy: "auto": überspringt diese Genehmigungsaufforderung. Der Agent muss die Aktion weiterhin aufrufen.
• maxPending: begrenzt ausstehende und quarantänisierte Vorschläge pro Workspace.
• maxSkillBytes: begrenzt die Größe des Vorschlagstexts. Standard: 40000.

Vorschlagsbeschreibungen sind immer auf 160 Byte begrenzt.

Gateway-Methoden

skills.proposals.listskills.proposals.inspectskills.proposals.createskills.proposals.updateskills.proposals.reviseskills.proposals.applyskills.proposals.rejectskills.proposals.quarantine

Schreibgeschützte Methoden erfordern operator.read. Ändernde Methoden erfordern operator.admin.

Speicherung

&lt;OPENCLAW_STATE_DIR&gt;/skill-workshop/  proposals.json  proposals/<proposal-id>/    proposal.json    PROPOSAL.md    rollback.json    assets/    examples/    references/    scripts/    templates/

Standard-Zustandsverzeichnis: ~/.openclaw.

• proposal.json: kanonischer Vorschlagsdatensatz.
• proposals.json: schneller Listenindex, aus Vorschlagsordnern wiederherstellbar.
• PROPOSAL.md: ausstehender Skill-Vorschlag.
• rollback.json: Wiederherstellungsmetadaten, die geschrieben werden, bevor Anwenden Live-Dateien ändert.

Limits

• Beschreibung: 160 Byte.
• Vorschlagstext: skills.workshop.maxSkillBytes (Standard 40.000).
• Supportdateien: 64 pro Vorschlag.
• Supportdateigröße: jeweils 256 KB, insgesamt 2 MB.
• Ausstehende und quarantänisierte Vorschläge: skills.workshop.maxPending pro Workspace (Standard 50).

Fehlerbehebung

Verwandte Themen

• Skills für Ladereihenfolge, Priorität und Sichtbarkeit
• Skills erstellen für handgeschriebene SKILL.md-Grundlagen
• Skills-Konfiguration für das vollständige skills.workshop-Schema
• Skills-CLI für openclaw skills-Befehle