Langsung ke konten utama
Skill Workshop adalah jalur tata kelola OpenClaw untuk membuat dan memperbarui skill workspace. Agen dan operator tidak menulis file SKILL.md aktif secara langsung melalui jalur ini. Mereka membuat proposal terlebih dahulu. Proposal adalah draf tertunda yang berisi konten skill yang diusulkan, pengikatan target, status pemindai, hash, metadata file pendukung, dan metadata rollback. Proposal menjadi skill aktif hanya ketika diterapkan. Skill Workshop hanya menulis skill workspace. Ini tidak mengubah skill bawaan, plugin, ClawHub, root tambahan, terkelola, agen pribadi, atau sistem.

​
Cara kerjanya

  • Proposal terlebih dahulu: konten skill yang dihasilkan disimpan sebagai PROPOSAL.md, bukan SKILL.md.
  • Apply adalah satu-satunya penulisan aktif: buat, perbarui, dan revisi tidak mengubah skill aktif.
  • Dicakup ke workspace: pembuatan menargetkan root skills/ workspace. Pembaruan hanya diizinkan untuk skill workspace yang dapat ditulis.
  • Tidak menimpa: pembuatan gagal jika skill target sudah ada.
  • Terikat hash: proposal pembaruan terikat ke hash target saat ini dan menjadi kedaluwarsa jika skill aktif berubah sebelum apply.
  • Dibatasi pemindai: apply menjalankan ulang pemindaian sebelum menulis.
  • Dapat dipulihkan: apply menulis metadata rollback sebelum mengubah file aktif.
  • Permukaan konsisten: chat, CLI, dan Gateway semuanya memanggil layanan Skill Workshop yang sama.

​
Siklus hidup

create/update -> pending
revise        -> pending
apply         -> applied
reject        -> rejected
quarantine    -> quarantined
target change -> stale
Hanya proposal pending yang dapat direvisi, diterapkan, ditolak, atau dikarantina.

​
Chat

Minta skill yang Anda inginkan kepada agen. Agen memanggil skill_workshop dan mengembalikan id proposal. Buat: 
Make a skill called morning-catchup that runs my Monday inbox routine.
Perbarui skill workspace yang sudah ada: 
Update trip-planning to also check seat maps before booking.
Iterasikan pada proposal tertunda: 
Show me the morning-catchup proposal.
Revise it to also flag anything marked urgent.
Apply the morning-catchup proposal.
Secara default, apply, reject, dan quarantine yang dimulai oleh agen menampilkan prompt persetujuan sebelum dijalankan. Atur skills.workshop.approvalPolicy ke "auto" untuk melewati prompt di lingkungan tepercaya.

​
CLI

Buat proposal skill baru: 
openclaw skills workshop propose-create \
  --name morning-catchup \
  --description "Daily inbox catch-up: triage, archive, surface, draft, plan" \
  --proposal ./PROPOSAL.md
Buat proposal pembaruan untuk skill workspace yang sudah ada: 
openclaw skills workshop propose-update trip-planning --proposal ./PROPOSAL.md
Daftar dan periksa: 
openclaw skills workshop list
openclaw skills workshop inspect <proposal-id>
Revisi sebelum persetujuan: 
openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.md
Tutup proposal: 
openclaw skills workshop apply <proposal-id>
openclaw skills workshop reject <proposal-id> --reason "Duplicate"
openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"

​
Konten proposal

Saat tertunda, proposal disimpan sebagai PROPOSAL.md dengan frontmatter khusus proposal: 
---
name: "morning-catchup"
description: "Daily inbox catch-up: triage, archive, surface, draft, plan"
status: proposal
version: "v1"
date: "2026-05-30T00:00:00.000Z"
---
Saat apply, Skill Workshop menulis SKILL.md aktif dan menghapus field khusus proposal: status, version proposal, dan date proposal.

​
File pendukung

Gunakan --proposal-dir ketika skill yang diusulkan memerlukan file di samping 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
Direktori harus berisi PROPOSAL.md. File pendukung harus berada di bawah:
  • assets/
  • examples/
  • references/
  • scripts/
  • templates/
Skill Workshop memindai, membuat hash, dan menyimpan file pendukung bersama proposal. File tersebut ditulis di samping SKILL.md aktif hanya saat apply. Path file pendukung yang ditolak mencakup path absolut, segmen path tersembunyi, traversal path, path yang tumpang tindih, file executable dari direktori proposal, teks non-UTF-8, byte null, dan file di luar folder pendukung standar.

​
Alat agen

Model menggunakan skill_workshop: 
action: create | update | revise | list | inspect | apply | reject | quarantine
Agen harus menggunakan skill_workshop untuk pekerjaan skill yang dihasilkan. Mereka tidak boleh membuat atau mengubah file proposal melalui write, edit, exec, perintah shell, atau operasi filesystem langsung.
skill_workshop adalah alat agen bawaan dan disertakan dalam tools.profile: "coding". Jika kebijakan yang lebih ketat menyembunyikannya, tambahkan skill_workshop ke daftar aktif tools.allow, atau gunakan tools.alsoAllow: ["skill_workshop"] ketika cakupan menggunakan profil tanpa tools.allow eksplisit. Proses sandbox tidak membangun alat Skill Workshop sisi host, jadi jalankan tindakan peninjauan proposal dari sesi agen sisi host normal atau CLI.

​
Persetujuan dan otonomi

{
  skills: {
    workshop: {
      autonomous: {
        enabled: false,
      },
      allowSymlinkTargetWrites: false,
      approvalPolicy: "pending",
      maxPending: 50,
      maxSkillBytes: 40000,
    },
  },
}
  • autonomous.enabled: mengizinkan OpenClaw membuat proposal tertunda dari sinyal percakapan yang tahan lama setelah giliran berhasil. Default: false.
  • allowSymlinkTargetWrites: mengizinkan apply menulis melalui symlink skill workspace yang target aslinya tercantum dalam skills.load.allowSymlinkTargets. Default: false.
  • approvalPolicy: "pending": memerlukan prompt persetujuan sebelum apply, reject, atau quarantine yang dimulai oleh agen.
  • approvalPolicy: "auto": melewati prompt persetujuan tersebut. Agen tetap harus memanggil tindakan.
  • maxPending: membatasi proposal tertunda dan dikarantina per workspace.
  • maxSkillBytes: membatasi ukuran isi proposal. Default: 40000.
Deskripsi proposal selalu dibatasi hingga 160 byte.

​
Metode Gateway

skills.proposals.list
skills.proposals.inspect
skills.proposals.create
skills.proposals.update
skills.proposals.revise
skills.proposals.apply
skills.proposals.reject
skills.proposals.quarantine
Metode hanya-baca memerlukan operator.read. Metode yang mengubah memerlukan operator.admin.

​
Penyimpanan

<OPENCLAW_STATE_DIR>/skill-workshop/
  proposals.json
  proposals/<proposal-id>/
    proposal.json
    PROPOSAL.md
    rollback.json
    assets/
    examples/
    references/
    scripts/
    templates/
Direktori status default: ~/.openclaw.
  • proposal.json: rekaman proposal kanonis.
  • proposals.json: indeks daftar cepat, dapat dibangun ulang dari folder proposal.
  • PROPOSAL.md: proposal skill tertunda.
  • rollback.json: metadata pemulihan yang ditulis sebelum apply mengubah file aktif.

​
Batas

  • Deskripsi: 160 byte.
  • Isi proposal: skills.workshop.maxSkillBytes (default 40.000).
  • File pendukung: 64 per proposal.
  • Ukuran file pendukung: masing-masing 256 KB, total 2 MB.
  • Proposal tertunda dan dikarantina: skills.workshop.maxPending per workspace (default 50).

​
Pemecahan masalah

MasalahResolusi
Skill proposal description is too largePersingkat description menjadi 160 byte atau kurang.
Skill proposal content is too largePersingkat isi proposal atau naikkan skills.workshop.maxSkillBytes.
Target skill changed after proposal creationRevisi proposal terhadap target saat ini, atau buat proposal baru.
Proposal scan failedPeriksa temuan pemindai, lalu revisi atau karantina proposal.
untrusted symlink targetKonfigurasikan skills.load.allowSymlinkTargets dan aktifkan skills.workshop.allowSymlinkTargetWrites hanya untuk root skill bersama yang disengaja.
Support file paths must be under one of...Pindahkan file pendukung ke bawah assets/, examples/, references/, scripts/, atau templates/.
Proposal tidak muncul dalam daftarPeriksa workspace --agent yang dipilih dan OPENCLAW_STATE_DIR.
Agen tidak dapat memanggil skill_workshopPeriksa kebijakan alat aktif dan mode jalan. coding menyertakan alat ini; kebijakan tools.allow yang restriktif harus mencantumkannya secara eksplisit, dan proses sandbox harus menggunakan sesi agen sisi host normal atau CLI.

​
Terkait