跳转至

自学习

自我学习会将纠正和来之不易的操作流程转化为 学习技能,供后续会话加载。它默认开启(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

后台审查和学习会话会将对话内容(包括工具输入和结果)发送到配置的模型提供商。请选择与工作区的隐私和数据处理要求相匹配的提供商和模式。

故障排除

没有学到任何内容

  1. 活动 Gateway 配置中的 skills.workshop.autonomous.mode 为 auto。
  2. 该会话自上次审查以来至少进行了 10 次模型迭代,且没有提供商或 prompt 错误。
  3. 该会话是普通对话,而不是 cron、heartbeat、hook、subagent 或 Incognito。
  4. 工具策略允许 skill_workshop,并且会话未被沙箱化。在 auto 模式下,openclaw doctor 会报告隐藏它的设置。
  5. Gateway 在 30 秒等待期间保持运行且空闲。

已运行的审查仍可能判定没有值得保存的内容。对于常规工作,这是预期结果。

过多或不需要的更改

使用“撤销”、控制界面 Undo 按钮或 openclaw skills workshop restore <name> 撤销单个更改。使用 openclaw skills workshop archive <name> 归档不需要的技能。要停止后台学习,请将模式设置为 off。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw