OpenClaw 6.1 技能工坊实测:我花了一上午,总结出 5 个关键 Action

6.1 这次更新，技能工坊（Skill Workshop）是我最想搞明白的功能。

官方说：”Agent 可以自己提需求、自己改代码”——听着很玄乎。但实操下来发现，这玩意其实是一套“治理过的技能创建/更新路径”——和手动改 SKILL.md 完全不是一回事。

今天上午我自己从头跑了一遍，把踩过的坑全记下来。下面是 5 个关键 Action + 7 大避坑点，建议收藏。

一、先搞懂：技能工坊到底管什么？

技能工坊是工作区专属的——也就是 ~/.openclaw/workspace-*/skills/<name>/SKILL.md 这种。

它管不到这些：

• • ❌ Bundled skill（OpenClaw 自带的）
• • ❌ Plugin skill
• • ❌ ClawHub 上的社区 skill
• • ❌ 系统 skill

如果你想批量改多个 workspace，技能工坊也不行——一次只能管一个 target，跨 workspace 得自己手动 cp 同步。

二、生命周期：5 个 Action 怎么用？

技能工坊有 5 个 action，但核心是这一条铁律：

Apply 是唯一把 PROPOSAL.md 写入 SKILL.md 的动作。

其他 4 个（create / update / revise / reject / quarantine）都不直接改线上文件。

完整生命周期

create / update → pending（待审）       ↓    revise（继续 pending）       ↓   apply → applied ✓   reject → rejected ✗   quarantine → quarantined ⚠️   target 变了 → stale（需重新 revise）

只有 pending 状态才能继续操作。

5 个 Action 一览

三、实测踩坑：apply 时到底发生了什么？

我上午 apply 的时候，盯着看了一下日志，发现两个关键动作：

1. 1. 自动写 rollback.json（apply 前）
• • 备份当前 SKILL.md 的内容
• • 出问题可以手动 cp rollback.json SKILL.md 恢复
3. 2. 
4. 自动跑 scanner
5. （apply 前）
• • 检查路径、文件类型、编码、扫描器
• • 有问题会拒绝 apply
7. 3. 
8. 自动移除 proposal-only frontmatter
   • • 落地后 SKILL.md 会比 PROPOSAL.md 略小
   • • 因为 status、version、date 这些提案字段被自动删了

四、3 个最容易踩的坑

坑 1：以为”apply 后能改”——其实会变 stale

我一开始以为 apply 完随便改文件就行，结果发现update 类提案绑定了 target 现状的 hash。

场景：你 apply 完之后，又手动改了 SKILL.md——下次再 update 同一个 skill，proposal 变 stale，apply 会被拒。

正确做法：改完 target 之后，先 revise 再 apply。

坑 2：以为 revise 会保留历史——其实只留最新版

我 revise 了好几次同一个 proposal（v1 → v2 → v3），最后发现v1 和 v2 都被 v3 覆盖了。

要保留历史版本？ 只能新建 proposal（新 id）。

坑 3：用 create 但同名已存在——直接失败

我试着用 create 给一个已存在的 skill 做提案，apply 的时候直接报错”No clobber”。

正确做法：已有 skill 改用 update（不是 create）。

五、5 个 Action 误用避坑表

六、CLI 速查（等价命令）

如果你想用命令行操作（不跟 Agent 对话）：

openclaw skills workshop list                          # 列所有 proposalopenclaw skills workshop inspect <id>                  # 看详情openclaw skills workshop propose-create \  --name X --description "..." --proposal ./PROPOSAL.md   # createopenclaw skills workshop propose-update X --proposal ./PROPOSAL.md   # updateopenclaw skills workshop revise <id> --proposal ./PROPOSAL.md         # reviseopenclaw skills workshop apply <id>                                # 落地openclaw skills workshop reject <id> --reason "..."                 # 弃用openclaw skills workshop quarantine <id> --reason "..."             # 隔离

七、上手前必知的安全原则

1. 1. 必须用 skill_workshop 工具改 proposal（不要手动 write/edit/exec/shell）
2. 2. 改完不要忘记 apply（PROPOSAL 不会自动落地）
3. 3. apply 前会自动写 rollback.json，但只写一次 apply，revise 不写
4. 4. description 写简短（≤160 字节），别写太长摘要
5. 5. proposal body ≤ 40,000 字节（默认 maxSkillBytes）

写在最后

跑完一上午我最大的感受是：

技能工坊的核心不是”AI 帮你写 skill”，而是“AI 帮你写 skill，但每一步你都拍板”。

apply 之前的 scanner 扫描、rollback 自动备份、hash 绑定——这些”治理机制”才是 6.1 这次更新最值得用的部分。

不是让 Agent 放手干，而是让它在围栏里干。

你用过技能工坊吗？踩过什么坑？评论区聊聊 👇

#OpenClaw#6.1 更新#技能工坊#Skill Workshop#虾闯天下#AI Agent#踩坑实录