Warsztat umiejętności

Skill Workshop to zarządzana ścieżka OpenClaw do tworzenia i aktualizowania umiejętności obszaru roboczego.

Agenci i operatorzy nie zapisują aktywnych plików SKILL.md bezpośrednio tą ścieżką. Najpierw tworzą propozycję. Propozycja to oczekujący szkic zawierający proponowaną treść umiejętności, docelowe powiązanie, stan skanera, hashe, metadane plików pomocniczych oraz metadane wycofania. Staje się aktywną umiejętnością dopiero po zastosowaniu.

Skill Workshop zapisuje wyłącznie umiejętności obszaru roboczego. Nie modyfikuje umiejętności wbudowanych, pluginowych, ClawHub, dodatkowego katalogu głównego, zarządzanych, osobistego agenta ani systemowych.

Jak to działa

• Najpierw propozycja: wygenerowana treść umiejętności jest przechowywana jako PROPOSAL.md, a nie SKILL.md.
• Zastosowanie jest jedynym aktywnym zapisem: utworzenie, aktualizacja i rewizja nie zmieniają aktywnych umiejętności.
• Zakres obszaru roboczego: tworzenie wskazuje katalog główny skills/ obszaru roboczego. Aktualizacje są dozwolone tylko dla zapisywalnych umiejętności obszaru roboczego.
• Bez nadpisywania: tworzenie kończy się niepowodzeniem, jeśli docelowa umiejętność już istnieje.
• Powiązane hashem: propozycje aktualizacji wiążą się z bieżącym hashem celu i stają się nieaktualne, jeśli aktywna umiejętność zmieni się przed zastosowaniem.
• Bramkowane skanerem: zastosowanie ponownie uruchamia skanowanie przed zapisem.
• Odzyskiwalne: zastosowanie zapisuje metadane wycofania przed zmianą aktywnych plików.
• Spójne powierzchnie: czat, CLI i Gateway wywołują tę samą usługę Skill Workshop.

Cykl życia

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

Tylko propozycje pending można rewidować, stosować, odrzucać lub poddawać kwarantannie.

Czat

Poproś agenta o umiejętność, której potrzebujesz. Agent wywoła skill_workshop i zwróci identyfikator propozycji.

Tworzenie:

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

Aktualizacja istniejącej umiejętności obszaru roboczego:

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

Iteracja na oczekującej propozycji:

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

Domyślnie inicjowane przez agenta akcje apply, reject i quarantine wyświetlają monit o zatwierdzenie przed uruchomieniem. Ustaw skills.workshop.approvalPolicy na "auto", aby pominąć monit w zaufanych środowiskach.

CLI

Utwórz nową propozycję umiejętności:

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

Utwórz propozycję aktualizacji dla istniejącej umiejętności obszaru roboczego:

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

Wyświetlanie listy i inspekcja:

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

Rewizja przed zatwierdzeniem:

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

Zamknięcie propozycji:

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

Treść propozycji

Podczas oczekiwania propozycja jest przechowywana jako PROPOSAL.md z frontmatter przeznaczonym tylko dla propozycji:

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

Po zastosowaniu Skill Workshop zapisuje aktywny SKILL.md i usuwa pola przeznaczone tylko dla propozycji: status, version propozycji oraz date propozycji.

Pliki pomocnicze

Użyj --proposal-dir, gdy proponowana umiejętność wymaga plików obok 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

Katalog musi zawierać PROPOSAL.md. Pliki pomocnicze muszą znajdować się w:

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

Skill Workshop skanuje, hashuje i przechowuje pliki pomocnicze wraz z propozycją. Są one zapisywane obok aktywnego SKILL.md tylko przy zastosowaniu.

Odrzucane ścieżki plików pomocniczych obejmują ścieżki bezwzględne, ukryte segmenty ścieżki, przechodzenie po ścieżkach, nakładające się ścieżki, pliki wykonywalne z katalogów propozycji, tekst inny niż UTF-8, bajty null oraz pliki spoza standardowych folderów pomocniczych.

Narzędzie agenta

Model używa skill_workshop:

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

Agenci muszą używać skill_workshop do pracy nad generowanymi umiejętnościami. Nie mogą tworzyć ani zmieniać plików propozycji przez write, edit, exec, polecenia powłoki ani bezpośrednie operacje na systemie plików.

Zatwierdzanie i autonomia

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

• autonomous.enabled: pozwala OpenClaw tworzyć oczekujące propozycje na podstawie trwałych sygnałów z rozmowy po udanych turach. Wartość domyślna: false.
• allowSymlinkTargetWrites: pozwala zastosowaniu zapisywać przez dowiązania symboliczne umiejętności obszaru roboczego, których rzeczywisty cel znajduje się w skills.load.allowSymlinkTargets. Wartość domyślna: false.
• approvalPolicy: "pending": wymaga monitu o zatwierdzenie przed inicjowanymi przez agenta akcjami apply, reject lub quarantine.
• approvalPolicy: "auto": pomija ten monit o zatwierdzenie. Agent nadal musi wywołać akcję.
• maxPending: ogranicza liczbę oczekujących i poddanych kwarantannie propozycji na obszar roboczy.
• maxSkillBytes: ogranicza rozmiar treści propozycji. Wartość domyślna: 40000.

Opisy propozycji są zawsze ograniczone do 160 bajtów.

Metody Gateway

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

Metody tylko do odczytu wymagają operator.read. Metody modyfikujące wymagają operator.admin.

Przechowywanie

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

Domyślny katalog stanu: ~/.openclaw.

• proposal.json: kanoniczny rekord propozycji.
• proposals.json: szybki indeks listowania, odtwarzalny z folderów propozycji.
• PROPOSAL.md: oczekująca propozycja umiejętności.
• rollback.json: metadane odzyskiwania zapisywane przed zmianą aktywnych plików przez zastosowanie.

Limity

• Opis: 160 bajtów.
• Treść propozycji: skills.workshop.maxSkillBytes (domyślnie 40 000).
• Pliki pomocnicze: 64 na propozycję.
• Rozmiar pliku pomocniczego: 256 KB każdy, łącznie 2 MB.
• Oczekujące i poddane kwarantannie propozycje: skills.workshop.maxPending na obszar roboczy (domyślnie 50).

Rozwiązywanie problemów

Powiązane

• Skills dotyczące kolejności ładowania, pierwszeństwa i widoczności
• Tworzenie umiejętności dotyczące podstaw ręcznie pisanego SKILL.md
• Konfiguracja Skills dotycząca pełnego schematu skills.workshop
• CLI Skills dotyczące poleceń openclaw skills