Skill Workshop 故障排除

故障排查¶

更新期间的遗留所有权警告¶

Doctor 会从保留的 Workshop 提案和集合备份中发现历史工作区设置文件，即使代理现在使用不同的工作区。它会在迁移 Workshop 记录之前导入有效的设置历史，保留原始时间戳和一份归档副本，且不更改工作区配置。

如果未配置的历史工作区缺少或无法读取设置状态，Doctor 会保留其文件并报告警告。过时提案会变为陈旧状态；具有未完成应用恢复和不明确集合备份的提案仍可供手动审查。已配置工作区的失败以及导入开始后的失败仍会阻止修复。

当其工作区没有已配置的所有者或映射到多个代理时，Doctor 会保留遗留提案元数据和集合备份。警告会指明保留的路径和候选代理。这些所有权警告不会阻止其他迁移或后续的 Doctor 修复。

请结合已配置的代理工作区，审查保留的提案或备份清单。仅当工作区映射能识别实际所有者时，才更正该映射；不要分配任意代理或删除工件以清除警告。解决所有权问题后重新运行 Doctor。除上述历史工作区延迟处理外，无效元数据、写入失败和未完成恢复仍属于迁移失败。

重新定向计数描述在该次处理中更改的提案。任何剩余的外部目标可能属于迁移被阻止的不同提案。在重试同一修复之前，请审查它们的标识符、路径和迁移警告。

软件包回滚不会逆转状态架构迁移或已重新定位的技能文件。因此，较旧的软件包可能与保留的状态不兼容。参见 架构版本升级与旧版更新器 和 降级恢复。

工具策略诊断¶

在 propose 和 auto 模式下，openclaw doctor 会为每个已配置的代理运行 core/doctor/skill-workshop-tool-policy 检查。Doctor 会在工具策略之前检查沙箱构建门控：没有主机授予的库编写权限的沙箱运行不会构建 skill_workshop，即使 alsoAllow 列出了它。警告会指明生效的沙箱设置，并建议使用非沙箱会话、具有库编写权限的人工轮次，或 openclaw skills workshop CLI。对于 non-main 模式，此限制适用于非主会话。库权限由主机为经过身份验证的人工轮次授予；它不是允许列表条目，也不是自主审查可以自行授予的权限。参见 个人库编写。

当工具可以构建但策略将其隐藏时，警告会指明第一个排除它的配置层，以及需要做出的确切 allow 或 alsoAllow 更改。对于显式允许列表未留下任何可调用工具的运行，当沙箱门控排除所请求的 Workshop 工具时，也会指明该沙箱门控。旧版操作手册可能仍会使用 openclaw plugins inspect skill-workshop；该命令现在会说明 Skill Workshop 是内置的，并在适用时打印相同的策略提示。