自学习
自我学习会将纠正和来之不易的操作流程转化为
学习技能,供后续会话加载。它默认开启(skills.workshop.autonomous.mode: "auto")。
学习发生在三个地方:
- 前台代理 会修补误导它的学习技能,并在完成艰难的多步骤工作后,在同一轮中保存一个操作流程。
- 后台审查 会在足够多的工作之后回顾对话,并保存前台代理未保存的内容。本页介绍它。
- 未使用技能清理 会归档 30 天未使用的学习技能。参见 未使用技能清理。
每个更改都会立即生效,在对话中公告,并且可以撤销。参见 撤销。
审查何时运行¶
OpenClaw 按会话统计模型迭代次数,跨越各轮。当一个会话自上次审查以来达到 10 次时,会排队一次审查,计数重新开始。当前台轮次本身更改了学习技能时,计数也会重置,因此代理已保存的工作不会被再次审查。
读取或查看学习技能的轮次也会排队一次审查,无论计数如何,因此刚刚误导或帮助了代理的技能会得到重新审视。相同的资格规则适用,而本身更改了学习技能的轮次仍会跳过审查。
排队的审查会在没有代理或回复运行处于活动状态 30 秒后开始;同一会话中后续活动会重新开始该等待。审查一次只运行一个。前台回复从不等待审查。
这些轮次不计入:
- 以提供商或 prompt 错误结束的轮次。你中断的轮次仍计入。
- cron、heartbeat、hook、subagent、memory 和 Incognito 会话,以及后台 Workshop 运行本身。
- 在运行时未报告其已解析模型以及
skill_workshop是否可用的轮次。嵌入式 runner 和 Codex app-server harness 都会报告这两项。 - 工具策略隐藏
skill_workshop的轮次。
压缩后的会话符合条件。计数保存在内存中,因此 Gateway 重启会重新开始计数。
审查做什么¶
审查会分叉对话至已完成的轮次,并追加一条指令,复用前台提供商、模型、auth profile 和工具 schema,使提供商的 prompt cache 生效。模型回退被禁用。它在嵌入式 OpenClaw harness 下运行,处于一个私有会话中,该会话永远不会出现在你的会话记录中。
审查可以使用 read、ls、view_image、web_search、web_fetch、sessions_history、sessions_search、memory_search 和 memory_get 查找内容;skill_workshop 是唯一会更改任何内容的工具。执行操作的工具有如 exec、write 或 message,会返回正常结果,例如 exec is not available in this background run.。该结果不是失败,审查也从不重新运行你的任务。审查在修补、写入或归档技能之前必须 view 该技能,并且归档需要 absorbed_into 或 reason。
审查者寻找:
- 对你方法、输出或风格的纠正。
- 经过反复尝试后有效的不明显技巧、修复或命令序列。
- 错误、缺少步骤或过时的学习技能。
它会先列出学习技能,然后优先修补已使用或已覆盖该任务的技能,再向其中一个添加 references/、templates/ 或 scripts/ 文件,并且只有在没有技能覆盖该任务时才创建新技能。覆盖同类任务的已列出技能会被合并为一个总括技能:审查会修补保留下来的技能,并使用 absorbed_into 归档其余技能。当轮次被中断时,它只保留在停止前明显有效的步骤。
它不会捕获环境特定或瞬时故障、关于工具的负面断言、未解决的故障或猜测、关于单个代码库的知识、一次性任务、个人事实、秘密,或没有具体命令、路径或标识符的通用建议。当没有持久学习时,它不更改任何内容。
你会看到什么¶
如果审查更改了技能,会向触发它的对话发布一行,并镜像到会话记录中:
💾 Learned: updated `deploy-staging` (tightened the rollback step). Say "undo" to revert this skill change.
无通道的 Control UI 会话会以会话记录条目的形式获得该行。如果没有更改,则不会发布任何内容。回复 "undo",代理会恢复之前的版本。
如果你关闭学习,或源会话在审查运行期间被删除、替换或更改权限模式,审查会停止且不再进一步更改。它已做的更改会保留,每个更改都保存了之前的版本。
开启或关闭¶
openclaw config set skills.workshop.autonomous.mode off
openclaw config set skills.workshop.autonomous.mode auto
Control UI 的 Plugins → Skill workshop 页面有相同的开关。off
会停止后台审查和未使用技能清理。当你要求时,代理仍可通过 /learn 或在
Learn from past conversations 会话中创建或更新学习技能。
成本与隐私¶
审查是在大量工作之后,在前台提供商和模型上额外运行一次模型,而不是在每条消息之后。它在查看和编辑技能时可能发出多个请求。Prompt-cache 复用降低了重新读取对话的成本;提供商定价仍然适用。
Control UI 中的 Learn from history 会打开一个普通聊天,代理在其中读取其可访问的较早对话,使用其配置的模型和工具。你可以观看、引导或停止它。启动它不会更改学习模式。
Warning
后台审查和学习会话会将对话内容(包括工具输入和结果)发送到配置的模型提供商。请选择与工作区的隐私和数据处理要求相匹配的提供商和模式。
故障排除¶
没有学到任何内容¶
- 活动 Gateway 配置中的
skills.workshop.autonomous.mode为auto。 - 该会话自上次审查以来至少进行了 10 次模型迭代,且没有提供商或 prompt 错误。
- 该会话是普通对话,而不是 cron、heartbeat、hook、subagent 或 Incognito。
- 工具策略允许
skill_workshop,并且会话未被沙箱化。在auto模式下,openclaw doctor会报告隐藏它的设置。 - Gateway 在 30 秒等待期间保持运行且空闲。
已运行的审查仍可能判定没有值得保存的内容。对于常规工作,这是预期结果。
过多或不需要的更改¶
使用“撤销”、控制界面 Undo 按钮或 openclaw skills workshop restore <name> 撤销单个更改。使用 openclaw skills workshop archive <name> 归档不需要的技能。要停止后台学习,请将模式设置为 off。
相关¶
- Skill Workshop 用于工具、存储、撤销和未使用技能清理
- 创建技能 用于手写技能
- 技能配置 用于
skills.workshop - 技能 CLI 用于
openclaw skills workshop
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw