聊天和 CLI 创作

聊天¶

对于 Workshop 创作，向 agent 请求你想要的技能；它会调用 skill_workshop 并返回一个提案 id。个人库创作则会返回个人库创作中描述的托管发布回执。

从近期工作中学习¶

使用 /learn 将当前对话或命名来源路由到最匹配的待处理提案或现有技能，仅在需要时创建技能：

/learn
/learn docs/runbook.md and https://example.com/guide; focus on recovery

在没有请求的情况下，/learn 要求 agent 从当前对话中提炼可复用的工作流。有请求时，agent 会将路径、URL、粘贴的笔记和对话引用视为来源，同时遵循焦点、范围和命名要求。它使用现有工具收集这些来源，然后调用 skill_workshop 来修订匹配的待处理提案、更新匹配的现有技能，或在两者都不存在时创建提案。

生成的提案保持 pending 状态；/learn 永远不会应用它。通过正常的审批流程或使用 openclaw skills workshop 对其进行审查和应用。

当实际轮次仅支持个人发布（包括配对节点的个人 CLI 创作）时，/learn 会停止且不会更改任何技能。如果你想发布修订版，请正常请求明确的个人创建，或使用现有的管理员 UI 或 CLI 进行 Workshop 提案审查。个人轮次无法暂存待处理的草稿。

创建：

Make a skill called morning-catchup that runs my Monday inbox routine.

更新一个由 Workshop 生成的现有技能：

Update trip-planning to also check seat maps before booking.

如果当前轮次中使用的技能被证明错误或不完整，agent 会读取现有技能并创建有针对性的补丁提案。当完整技能超出所选模型的读取预算时，agent 可以准备一个唯一的精确片段，并在打补丁前审查其受限的周边上下文。运行时回执将该流程限制为仅针对该次运行中使用的技能。自主模式 off 禁用修复，propose 会保持补丁为待处理状态直到明确应用，auto 会立即扫描并应用它。修复后的技能由新会话加载；当前运行会话保留其原始技能快照。

对待处理的提案进行迭代：

Show me the morning-catchup proposal.
Revise it to also flag anything marked urgent.
Apply the morning-catchup proposal.

默认情况下，agent 发起的 apply、reject 和 quarantine 无需额外的审批提示即可执行。将 skills.workshop.approvalPolicy 设置为 "pending" 以要求在这些操作之前获得操作员批准。

当需要批准时，提示会标识提案 id 和目标技能，并显示提案描述、支持文件数量和主体大小。批准请求需在 agent 工具看门狗（watchdog）之前完成。如果在提示过期前没有收到决定，生命周期操作不会运行：提案保持待处理且不变。之后可在 Skill Workshop UI 中决定，或运行 openclaw skills workshop apply|reject|quarantine <proposal-id>。Agent 不应循环重试已过期的生命周期操作。

命令行¶

# Create
openclaw skills workshop propose-create \
  --name morning-catchup \
  --description "Daily inbox catch-up: triage, archive, surface, draft, plan" \
  --proposal ./PROPOSAL.md

# Update an existing Workshop-generated skill
openclaw skills workshop propose-update trip-planning --proposal ./PROPOSAL.md

# List and inspect
openclaw skills workshop list
openclaw skills workshop inspect <proposal-id>

# Revise before approval
openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.md

# Run installed plugin evaluators against the exact current draft
openclaw skills workshop evaluate <proposal-id>

# Close out
openclaw skills workshop apply <proposal-id>
openclaw skills workshop reject <proposal-id> --reason "Duplicate"
openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"

每个子命令都接受 --agent <id>（agent 上下文；默认为从 cwd 推断，然后是默认 agent）和 --json（结构化输出）。提案和生成的技能目标限定于所选 agent。propose-create、propose-update 和 revise 还接受 --goal <text> 和 --evidence <text> 来记录提案上下文，与 --proposal 一起使用。evaluate 通过实时 Gateway 插件注册表运行，在分派前对当前提案修订版进行快照，并接受 --correlation-id <id> 用于外部编排。