本页内容
本页内容
技能
技能工作坊
技能工坊拥有代理为自己编写的技能,称为 学习技能。代理在经过多步艰苦的工作后保存了一个程序,并修复了误导它的学到的技能; 30 天内无人使用的技能将被存档。每个更改都会立即应用,首先保存以前的版本,并且可以撤消。
学到的技能是程序,而不是记忆:用户重复执行任务的方法,因此代理不会每次都重新计算出来。关于用户或世界的事实属于内存。有关一个代码库的知识(例如其约定、构建命令或体系结构)属于该存储库的文档或 AGENTS.md,在那里工作的每个代理都会读取它,因此代理不会将其保存为学习的技能。
学到的技能属于一个代理,并且始终对其可见:它们绕过 agents.defaults.skills 和 agents.entries.<id>.skills 允许列表。要隐藏一个,请将其存档。
您自己编写的技能(工作区、项目、托管、ClawHub、插件和捆绑技能)不是 Workshop 技能。在源头编辑它们;参见创作技巧。有关共享网关上的配置文件拥有的技能,请参阅 个人库创作。
智能体如何学习
- 在回合期间: 当代理使用的已学技能结果错误或不完整时,它会查看该技能并修补误导步骤。在您可能会重复进行艰苦的多步骤工作之后,它可以节省工作流程,修补涵盖此类任务的技能,或者在没有技能时创建一项技能。
- **后台审查:**在对话中累积10次模型迭代后,后台运行对其进行审查并保存任何值得保留的内容。参见自学。
/learn [request]: 要求客服人员立即从当前对话或您指定的来源保存技能。参见/learn。- 从历史记录中学习: Control UI 按钮可打开正常聊天,客服人员可在其中查看之前的对话并保存找到的内容。
- **未使用的技能清理:**学习的技能30天无人使用被存档。请参见 未使用技能清理 。
新会话中的技能负载发生了变化。正在运行的会话会保留其开始时的技能快照。
撤消
当后台运行更改技能时,Control UI 聊天会显示紧凑的 Learned 行;每个技能名称都会在创意工坊中打开该技能。频道消息默认关闭。设置 skills.workshop.autonomous.channelNotices: true 将通知发布到触发审核的对话;该会话的 Control UI 聊天然后将其显示为纯文本:
在对话中说“撤消”,无论通道通知打开还是关闭,代理都会使用 skill_workshop 恢复之前的版本。当评论没有改变时,什么也不会出现。 Slack 永远不会收到频道消息;它的会话仍然获得 Control UI 行。
要在不询问代理的情况下恢复一条评论更改的所有内容:
- 按通知上的 撤消。带按钮的通道将其呈现在线条下方;纯文本通道显示要复制的命令。
- 在 Control UI Learned 行上按 撤消。
- 发送
/learn undo <id>,其中<id>是频道通知命令中的评论id。
每个都会恢复在审核第一次更改技能之前保存的版本,并对审核创建的技能进行存档。再次按下它会报告更改已被撤消。聊天命令需要所有者以及来自网关客户端的 operator.admin。
您还可以从 Control UI(技能的最新更改或其“历史记录”选项卡中的 Undo)或 CLI 撤消一项技能:
恢复会在替换之前保存当前副本,因此撤消本身可以撤消。刚刚创建的技能没有早期版本;而是将其存档。
未使用的技能清理
学习开启后,OpenClaw 会存档 30 天内没有任何活动的已学技能,并在更改源中显示原因 unused for 30 days 和参与者 curator。活动是最新的:对其 SKILL.md 的记录读取、前台 skill_workshop view 及其最后更改(创建、修补、恢复)。少于 30 天的技能永远不会被存档。在完成转弯后,每个代理每天最多运行一次检查,并且不会延迟转弯。存档是普通版本存档:随时恢复。
清理仅针对网关进程中默认运行时为嵌入式 OpenClaw harness的代理运行。 Codex 应用程序服务器利用其本机 shell 读取技能,OpenClaw 无法将其归因于技能,因此 Codex 代理的清理工作不会进行,而不是归档正在使用的技能。
早期版本每周运行一次策展人自动化 (skill-collection-review:<agentId>)。它已退役:网关在升级时删除这些 cron 行并且不创建替换项。
/learn
/learn 是正常的前台转弯。如果没有请求,代理会保存当前对话中的可重用工作流程。通过请求,它会使用其常规工具收集命名路径、URL、注释或对话引用,并尊重您提供的任何焦点、范围或命名。它首先查看相关技能,修补涵盖该任务的技能,并仅在没有技能时创建新技能。涵盖同一类任务的相关技能被合并为一项总括技能:它修补幸存者并用 absorbed_into 归档其余部分。然后它会告诉你哪个技能发生了变化。如果没有什么可以持久学习的东西,那就什么也改变不了。
/learn 在两种学习模式下均可工作。当 skill_workshop 不可用时(例如在沙盒会话中或当工具策略隐藏该工具时),它会回复解释。
/learn undo <id> 是一个例外:使用评论 ID,它会在不进行模型转换的情况下恢复后台评论。请参见 撤消 。 /learn 之后的任何其他文本都是请求。
代理工具
内置的 skill_workshop 工具是每次学习技能更改的方式。它是tools.profile: "coding"的一部分;如果策略更严格,则添加到tools.allow或tools.alsoAllow。
| 操作 | 参数 | 作用 |
|---|---|---|
list |
— | 列出实时技能和存档技能 |
view |
name,可选file_path,version |
读取当前文件或已保存版本的文件 |
create |
name、content(完整 SKILL.md) |
创造新技能 |
patch |
name、old_text、new_text、可选 file_path |
替换一个精确、唯一的跨度 |
write_file |
name, file_path, content |
写入支持文件,或重写SKILL.md |
remove_file |
name, file_path |
删除一个支持文件; SKILL.md 仅经过 archive |
archive |
name,可选absorbed_into,reason |
隐藏技能; absorbed_into 命名现在涵盖它的实时技能 |
restore |
name,可选version |
恢复最新保存的版本,或名为 |
每个变异操作都接受 reason,这是出现在更改提要和聊天通知中的一小行。每次更改都会首先保存以前的版本。
写入在落地之前会经过验证:
- 新名称使用 1-63 个小写字母、数字或连字符,并以字母或数字开头。早期版本保存的较长名称仍会列出并易于管理。
SKILL.md需要name与技能目录匹配的 frontmatter 和 1-1024 字节的description(目标为 160 左右)。它必须适合skills.workshop.maxSkillBytes。- 支持文件位于
references/、templates/、scripts/或assets/下,每个最多 256 个 KiB。绝对路径、遍历和符号链接都被拒绝。 - A 关键安全扫描程序发现(包括字面上的秘密)拒绝写入并命名文件、行和规则。
背景审查必须是view一项现有技能才可以patch、write_file、remove_file或archive它,并且其档案需要absorbed_into或reason。前台 view 算作使用该技能。
成功的 create、patch 或 write_file 或 SKILL.md 可能会以最多三行 Advisory (not blocking) 结尾:编写引入的写入问题(超过 160 字节的描述或以“此技能”开头,正文超过 250 行或 12 KB,强调字、三个或更多 Never/Don 步骤、更新注释或日期)。写入已经落地。 create 还列出了代理学习的其他技能,因此代理自行决定新技能是否重复并应合并。
配置
| 设置 | 默认值 | 作用 |
|---|---|---|
skills.workshop.autonomous.mode |
"auto" |
"auto" 启用后台审查和未使用的技能清理。 "off" 禁用两者。 |
skills.workshop.autonomous.channelNotices |
false |
还向频道对话发布背景审核通知,Slack 除外。 |
skills.workshop.maxSkillBytes |
40000 |
最大 SKILL.md 大小(以字节为单位)(1024-200000)。 |
借助 off,当您通过 /learn 提出请求时,或在 会话中学习过去的对话 会话时,代理仍然可以创建和更新已学习的技能。有关架构,请参阅 Skills config。
文件所在位置
<agentDir> 默认为 <state-dir>/agents/<agentId>/agent,或设置时为 agents.entries.<id>.agentDir。 <state-dir> 是 ~/.openclaw,除非 OPENCLAW_STATE_DIR 覆盖它。
每次更改之前都会保存一个版本,包括存档和恢复。每个技能保留最新的 10 个版本。存档技能没有实时目录;其最新版本恢复了它。更改源(谁更改了哪些技能、何时更改以及为何更改)位于状态数据库中,并为每个代理保留最新的 500 个条目。
操作员表面
- Control UI: 打开插件→技能工坊。学到的技能首先列出最常用的技能(或按最近的活动或名称),每个技能都有其最新更改和 Undo;闲置两周的技能会被标记,因为 unused-skill cleanup 可能会在 30 天后将其存档。选择一项技能会显示其说明、支持文件和历史记录。从历史记录中,您可以将早期版本与当前版本进行比较、恢复它或撤消更改。 Archive 和 Restore 在活动列表和存档列表之间切换技能。页眉保存着学习模式开关和从历史中学习。如果无法加载学习配置,页面会显示错误和 Retry 按钮,同时保持技能库可用。
- CLI:
openclaw skills workshop list | changes | show | archive | restore。请参阅 技能 CLI。 - 插件:
skill_changed挂钩观察每个提交的创意工坊更改。
网关方法采用可选的 agentId(省略时默认代理):
| 方法 | 范围 | 参数 | 返回内容 |
|---|---|---|---|
skills.workshop.list |
operator.read |
— | agentId、mode、root、现场 skills(带 useCount、lastUsedAtMs)、archived 版本 |
skills.workshop.changes |
operator.read |
limit (up to 500), beforeMs |
changes,最新的在前 |
skills.workshop.read |
operator.read |
name, filePath, versionId |
name, filePath, content, files |
skills.workshop.archive |
operator.admin |
name, reason |
change |
skills.workshop.restore |
operator.admin |
name, versionId |
change |
skills.workshop.undo |
operator.admin |
runId(评论的运行 ID) |
status(undone 或 already-undone)、changes 通过此调用 |
CLI、Control UI、聊天或网关的存档、恢复和撤消将记录为 user 更改。
从早期版本升级
早期版本将学到的技能作为草稿进行审查。 openclaw doctor --fix 导出所有待处理的草稿并删除旧设置;请参阅 状态迁移 和 技能配置 。导出的草稿未加载。如果您还需要,请让智能体以 /learn 保存一份。
早期的 skills.proposals.* 和 skills.curator.* 网关方法保持注册状态,但返回指向上述方法的错误。删除了 skill_proposal_evaluate 和 skill_proposal_changed 插件挂钩;参见 移除表面 。
不再读取先前每周审核在 <agentDir>/skill-workshop/collection-backups/ 下编写的备份。手动从其中复制您需要的任何文件; OpenClaw 不会恢复它们。
故障排查
| 问题 | 检查 |
|---|---|
| 从来没有学到什么 | skills.workshop.autonomous.mode 为 auto,会话符合条件,并且工具策略允许 skill_workshop。参见自学。 |
代理无法调用 skill_workshop |
沙盒运行无法获取该工具。使用非沙盒会话或 CLI。否则,将该工具添加到 tools.allow 或 tools.alsoAllow。 |
| 写入被拒绝 | 该错误指定了修复方法:重命名技能、更正标题、缩短描述或 SKILL.md,或删除标记行。 |
| 进行了不需要的更改 | 按通知上的 Undo,说“撤消”,发送 /learn undo <id>,或运行 openclaw skills workshop restore <name>。 |
| 技能意外存档 | 未使用的技能清理会存档 30 天内没有活动的技能。运行 openclaw skills workshop restore <name>。 |
在 auto 模式下,openclaw doctor 对每个代理运行 core/doctor/skill-workshop-tool-policy 检查。它命名隐藏 skill_workshop 的沙箱设置或配置层以及要进行的确切 allow 或 alsoAllow 更改。
相关内容
- 自学用于背景审查
- Skills 用于加载顺序和可见性
- 手写创作技巧
SKILL.md skills.workshop架构的技能配置openclaw skills workshop的技能 CLI