OpenClaw Skill Workshop：把 Agent 工作变成可复用的技能，先审后用

> 来源: https://openclaw.ai/blog/openclaw-agent-skill-workshop

> 日期: 2026-06-04

> 作者: Gideon Adegbesan (OpenClaw Foundation)

一句话版本

Skill Workshop 是 OpenClaw 的一个"技能审核车间"——当 AI Agent 自动写出了一套操作手册（技能文件）时，不会直接生效，而是先变成一个待审核的草稿，你过目、修改、确认没问题了才正式启用。

这是什么

OpenClaw 的 Skills 系统是让 AI Agent 学会"怎么做某事"的一套机制——比如"每周五发周报"、"按某个流程审代码"、"按模板写文档"，都可以写成一个 SKILL.md 文件。

以前，Agent 可以直接创建和修改这些文件。但如果写的不对，可能会让后续所有工作都跑偏。

Skill Workshop 的核心变化：加了一道审查关卡。

Agent 写好技能后，不直接写入 SKILL.md，而是先生成一个"提案"（PROPOSAL.md）。这个提案就是一份草稿，你可以看、改、试，确认没问题了再让它生效。

核心设计

提案生命周期


create/update → pending
revise       → pending
apply        → applied
reject       → rejected
quarantine   → quarantined
target change → stale

关键点：

两种审核视图

视图用途
**Board view**完整看板，pending/applied/rejected/stale 分类，可搜索可检查
**Today view**快速模式，一次看一个提案，决定 Use / Tweak / Skip

Tweak 是最巧妙的设计——AI 生成的技能经常"差不多对"，措辞不对、步骤漏了、fallback 不够安全。Tweak 允许你直接指出问题，Agent 修订提案，你再回来审核同一个提案，历史不变。

技能可以带附件

好的技能不光有说明书，还常需要：模板、脚本、示例日志、参考代码。

Skill Workshop 支持 5 类支持文件：

路径安全规则严格：无绝对路径、无路径遍历、无隐藏路径段、不写到技能目录外。

配置选项


{
  skills: {
    workshop: {
      autonomous: { enabled: false },  // 自动创建提案（默认关闭）
      approvalPolicy: "pending",       // apply 前需要人工审批
      maxPending: 50,                  // 每 workspace 最多 50 个待审提案
      maxSkillBytes: 40000,            // 提案内容上限 40KB
    },
  },
}

CLI 速览


# 创建提案
openclaw skills workshop propose-create --name morning-catchup --proposal ./PROPOSAL.md

# 更新现有技能
openclaw skills workshop propose-update trip-planning --proposal ./PROPOSAL.md

# 操作提案
openclaw skills workshop list
openclaw skills workshop apply <proposal-id>
openclaw skills workshop reject <proposal-id> --reason "Duplicate"
openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"

技术细节

与现有生态的关系

对我们的意义

Jay 的 OpenClaw 目前跑在 researcher agent 上，skills 目录在 /home/jay/clawd/agents/researcher/skills/。Skill Workshop 如果能推广到日常使用，意味着：

1. 安全增量：新增技能有人审再生效，不会因技能写错导致行为异常

2. 迭代友好：AI 生成 → 人 tweak → 再审，比手写 SKILL.md 舒服很多

3. vs 当前流程：现在技能靠手动写（see skill-creator in available_skills），Skill Workshop 让 Agent 主动提案，人只需说了算

不过当前 workspace 里技能不多（主要是 skill-creator、follow-builders 等），autonomous 模式在这分量下用处有限。

评分

维度评分说明
创新性★★★★☆提案+审核+回滚的完整闭环，Tweak 流程很实用
实用性★★★★☆多人/多 agent 环境必备，单人小项目暂时需求不迫切
用户体验★★★★★Board/Today 双视图 + CLI + Chat 统一接口，设计成熟
安全性★★★★★Scanner + hash + rollback + 路径限制，安全设计全面
推荐程度★★★★☆值得开启，但当前 Jay 的单 agent 场景收益有限

相关报告

实操问答：如何启用和使用 Skill Workshop

> 以下内容来自 2026-06-04 与 Jay 的 Discord 对话

Q: 具体怎么启用？需要额外安装吗？

完全不需要。 Skill Workshop 是内建于当前 OpenClaw 的，你现在的版本已经自带。

Q: 需要配什么吗？

什么都不用改就能用。 默认配置已经合理：


{
  skills: {
    workshop: {
      autonomous: { enabled: false },  // 不自动提案，需要你主动说
      approvalPolicy: "pending",       // apply 前弹审批
      maxPending: 50,
      maxSkillBytes: 40000,
    },
  },
}

如果 ~/.openclaw/openclaw.json 里没有覆盖 skills.workshop，跑的就是这套默认配置。

Q: 怎么用？

两种方式：

方式一：聊天直接说（推荐）

在对话里直接说：

> "把每周五发周报的流程做成一个叫 weekly-report 的技能"

Agent 会自动调用 skill_workshop 创建提案，文件存为 PROPOSAL.md 而不是 SKILL.md。你可以继续：

> "加一个 checklist 步骤，确认 deploy 前先跑 lint"

Agent 会 revise 提案。然后你再说：

> "apply 这个 skill"

会弹审批 → 确认后正式写入 SKILL.md，生效。

方式二：CLI


# 查看现有提案
openclaw skills workshop list

# 创建提案（从文件）
openclaw skills workshop propose-create --name my-skill --proposal ./PROPOSAL.md

# 检查提案
openclaw skills workshop inspect <proposal-id>

# 生效
openclaw skills workshop apply <proposal-id>

Q: 要不要开 autonomous？

autonomous.enabled: true 的意思是：Agent 自己发现"这事儿你反复在做，我帮你做个技能吧"，然后自动提案等审核。

建议先不开。 你现在单 agent 场景，主动说"把这个做成技能"就够了，autonomous 在项目初期容易提案太积极。等人多了、技能多了再考虑开。

一句话总结

> 已经启用了，直接用。找我要个技能就行——我会走 Skill Workshop 流程，先出提案等你看，不直接写 SKILL.md。

报告生成时间: 2026-06-04 03:37 UTC | 实操问答更新: 2026-06-04 04:16 UTC