OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Skills

Skill Workshop

Skill Workshop is OpenClaw's governed path for creating and updating its own generated skills. Through this path, agents and operators create a proposal (pending draft with content, target binding, scanner state, hashes, and rollback metadata) that becomes a live skill only when applied.

Automatic background learning and weekly collection review instead maintain the Workshop directory with normal agent file tools. These direct edits do not create proposals or automatic rollback snapshots. Choose propose mode when each new skill change needs review before publication.

By default, Skill Workshop writes only under the active agent's <state-dir>/agents/<agentId>/agent/workshop-skills. When agents.entries.<id>.agentDir is configured, it writes under <agentDir>/workshop-skills instead. Operators edit bundled, plugin, ClawHub, extra-root, managed, personal-agent, project, and workspace skills through their owning tools or files. The same authoring tool also supports personal library skills when the Gateway supplies an authorized library target. Those operations publish managed revisions rather than Workshop proposals.

Workshop storage is installation-managed and separate from the session workspace and managed skill library. OPENCLAW_STATE_DIR selects the state directory. ~/.openclaw is the default.

This page is an index. Skill Workshop is documented on eight pages, one per reader job. Open the page that matches your task.

Page Read it when
Personal library authoring You are authoring a profile-owned personal skill on a shared Gateway.
How Skill Workshop works You need the proposal rules, the Control UI review surfaces, or the state diagram.
Collection review You are enabling weekly review, or recovering a skill from a retained backup.
Chat and CLI authoring You are creating, revising, or applying a proposal from chat or the CLI.
Proposal content, support files, and the agent tool You are writing PROPOSAL.md, adding support files, or calling skill_workshop.
Self-learning and approval settings You are configuring autonomy, approval policy, or Workshop size caps.
Gateway methods, storage, and limits You need the Gateway method list, the on-disk layout, or the hard limits.
Skill Workshop troubleshooting A proposal fails, does not appear, or the agent cannot call the tool.

Where each section moved

Every section heading id from the previous single-page version keeps its anchor here, so an existing link such as /tools/skill-workshop#collection-review still resolves. Each entry points at the page that now holds the content.

Was this useful?
On this page

On this page