Atelier Skills

Skill Workshop est le parcours gouverné d’OpenClaw pour créer et mettre à jour les skills d’espace de travail.

Les agents et les opérateurs n’écrivent pas directement les fichiers SKILL.md actifs par ce parcours. Ils créent d’abord une proposition. Une proposition est un brouillon en attente contenant le contenu de skill proposé, la liaison de cible, l’état du scanner, les hachages, les métadonnées des fichiers de support et les métadonnées de rollback. Elle devient un skill actif uniquement une fois appliquée.

Skill Workshop écrit uniquement les skills d’espace de travail. Il ne modifie pas les skills groupés, de Plugin, ClawHub, de racine supplémentaire, administrés, d’agent personnel ou système.

Fonctionnement

• Proposition d’abord : le contenu de skill généré est stocké sous PROPOSAL.md, pas sous SKILL.md.
• Appliquer est la seule écriture active : créer, mettre à jour et réviser ne modifient pas les skills actifs.
• Portée limitée à l’espace de travail : les créations ciblent la racine skills/ de l’espace de travail. Les mises à jour sont autorisées uniquement pour les skills d’espace de travail inscriptibles.
• Aucun écrasement : la création échoue si le skill cible existe déjà.
• Lié au hachage : les propositions de mise à jour se lient au hachage actuel de la cible et deviennent obsolètes si le skill actif change avant l’application.
• Contrôlé par scanner : l’application relance le scan avant l’écriture.
• Récupérable : l’application écrit les métadonnées de rollback avant de modifier les fichiers actifs.
• Surfaces cohérentes : le chat, la CLI et le Gateway appellent tous le même service Skill Workshop.

Cycle de vie

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

Seules les propositions pending peuvent être révisées, appliquées, rejetées ou mises en quarantaine.

Chat

Demandez à l’agent le skill souhaité. L’agent appelle skill_workshop et renvoie un identifiant de proposition.

Créer :

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

Mettre à jour un skill d’espace de travail existant :

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

Itérer sur une proposition en attente :

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

Par défaut, les actions apply, reject et quarantine initiées par l’agent affichent une invite d’approbation avant leur exécution. Définissez skills.workshop.approvalPolicy sur "auto" pour ignorer l’invite dans les environnements de confiance.

CLI

Créer une nouvelle proposition de skill :

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

Créer une proposition de mise à jour pour un skill d’espace de travail existant :

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

Lister et inspecter :

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

Réviser avant approbation :

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

Clore la proposition :

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

Contenu de la proposition

Tant qu’elle est en attente, la proposition est stockée sous PROPOSAL.md avec un frontmatter propre aux propositions :

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

Lors de l’application, Skill Workshop écrit le SKILL.md actif et supprime les champs propres à la proposition : status, la version de proposition et la date de proposition.

Fichiers de support

Utilisez --proposal-dir lorsque le skill proposé a besoin de fichiers à côté de PROPOSAL.md :

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

Le répertoire doit contenir PROPOSAL.md. Les fichiers de support doivent se trouver sous :

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

Skill Workshop scanne, hache et stocke les fichiers de support avec la proposition. Ils sont écrits à côté du SKILL.md actif uniquement lors de l’application.

Les chemins de fichiers de support rejetés incluent les chemins absolus, les segments de chemin masqués, la traversée de chemins, les chemins qui se chevauchent, les fichiers exécutables issus de répertoires de proposition, le texte non UTF-8, les octets nuls et les fichiers hors des dossiers de support standard.

Outil d’agent

Le modèle utilise skill_workshop :

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

Les agents doivent utiliser skill_workshop pour le travail de skill généré. Ils ne doivent pas créer ni modifier les fichiers de proposition au moyen de write, edit, exec, de commandes shell ou d’opérations directes sur le système de fichiers.

Approbation et autonomie

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

• autonomous.enabled : autorise OpenClaw à créer des propositions en attente à partir de signaux de conversation durables après des tours réussis. Par défaut : false.
• allowSymlinkTargetWrites : autorise l’application à écrire à travers les liens symboliques de skills d’espace de travail dont la cible réelle est listée dans skills.load.allowSymlinkTargets. Par défaut : false.
• approvalPolicy: "pending" : exige une invite d’approbation avant une action apply, reject ou quarantine initiée par l’agent.
• approvalPolicy: "auto" : ignore cette invite d’approbation. L’agent doit tout de même appeler l’action.
• maxPending : limite les propositions en attente et mises en quarantaine par espace de travail.
• maxSkillBytes : limite la taille du corps de la proposition. Par défaut : 40000.

Les descriptions de proposition sont toujours limitées à 160 octets.

Méthodes Gateway

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

Les méthodes en lecture seule nécessitent operator.read. Les méthodes mutantes nécessitent operator.admin.

Stockage

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

Répertoire d’état par défaut : ~/.openclaw.

• proposal.json : enregistrement canonique de la proposition.
• proposals.json : index de listage rapide, reconstructible à partir des dossiers de proposition.
• PROPOSAL.md : proposition de skill en attente.
• rollback.json : métadonnées de récupération écrites avant que l’application ne modifie les fichiers actifs.

Limites

• Description : 160 octets.
• Corps de proposition : skills.workshop.maxSkillBytes (40 000 par défaut).
• Fichiers de support : 64 par proposition.
• Taille des fichiers de support : 256 Ko chacun, 2 Mo au total.
• Propositions en attente et mises en quarantaine : skills.workshop.maxPending par espace de travail (50 par défaut).

Dépannage

Connexe

• Skills pour l’ordre de chargement, la priorité et la visibilité
• Créer des skills pour les bases d’un SKILL.md écrit à la main
• Configuration des Skills pour le schéma complet skills.workshop
• CLI Skills pour les commandes openclaw skills