托管技能
Custodian 技能是与 OpenClaw 一起发布的、按版本管理的运维手册。它们位于包中的 custodian-skills/ 目录下。它们以捆绑技能优先级层级加载,但仅针对由 agents.defaults.systemAgent.agentId 解析的智能体。
当该设置不存在时,OpenClaw 会回退到保留的旧版默认所有者、唯一配置的智能体,或者在没有显式智能体名册时回退到旧版 main。如果配置了多个智能体但没有系统智能体或保留的旧版所有者,则没有任何智能体获得该技能库。对于所有其他智能体,Custodian 技能不会出现在发现、快照、斜杠命令目录、沙箱同步以及面向模型的技能 prompt 中。
常规技能控制仍然适用。skills.entries.<name>.enabled: false 可禁用单个 Custodian 技能,智能体技能允许列表可进一步缩小最终集合。参见 技能配置。
工作流约定¶
每个随版本发布的 Custodian 技能都按以下顺序使用相同的五个部分:
- Gather(收集) 读取脱敏后的当前配置,并检查实时状态。
- Mutate(变更) 使用经过验证的非交互式写入,绝不直接编辑文件。这些写入来自可信 shell 中的
openclaw config set/openclaw config patch,或者在策略允许时使用会话内的 Custodian 工具操作。 - Repair(修复) 使用
openclaw doctor --lint进行诊断。只有经过明确批准的修复才会使用openclaw doctor --fix --non-interactive。只读的diagnose-gateway技能会推荐该独立步骤,但绝不执行它。 - Prove(验证) 实际演练一个实时端到端结果。
- Report(报告) 记录发生了什么变化、观察到了什么、以及还剩下什么。
所有五部分手册都会将秘密值排除在提示、日志和文件之外。凭据使用 SecretRefs 或凭据存储。没有 Prove 验证结果,工作流绝不会声称成功。当无法进行实时验证时,它会报告确切阻塞因素。
Lint 退出码 1 表示有发现,而不是诊断命令失败:阅读报告并继续其余检查。普通的 doctor(包括 --non-interactive)可以在没有 --fix 的情况下复制旧版配置并迁移状态。它不是只读替代品。只读诊断排除配置/服务修复和状态迁移,但不排除附带的日志或缓存记录。参见 Doctor。
第一波¶
| 技能 | 结果 |
|---|---|
configure-channel |
配置并通过一个渠道家族(如 Discord、Slack、Telegram 或 WhatsApp)发送一条已确认的测试消息。 |
add-model-provider |
配置 API 密钥或订阅/OAuth 提供商访问权限,并运行一次实时 Gateway 推理。 |
diagnose-gateway |
执行只读的 Gateway、配置、SecretRef、渠道认证、日志和端口排查。 |
cloud-image-bake |
构建一个 Cloud Worker 镜像,通过定时调度验证它,并安全地淘汰被取代的快照。 |
路线图目录¶
以下目录记录了计划中的后续层级。这些名称是路线图条目,不是已捆绑的技能,也不代表当前行为的承诺。
第 2 层:常见操作¶
configure-search: 配置搜索提供商并实时验证。create-agent: 创建一个智能体,验证其工作区,并验证一轮对话。manage-plugin: 安装、配置、验证或移除已批准的插件。rotate-credential: 通过其所属存储轮换一个受支持的凭据,并验证消费方。upgrade-openclaw: 暂存一次升级,运行健康检查,并验证回滚就绪状态。
第 3 层:高级操作¶
fleet-rollout: 在受管理的各个 Gateway 上推出一个已验证的配置或版本。incident-response: 收集脱敏证据,遏制事件,并验证恢复。migrate-gateway: 在保留显式状态和身份契约的同时迁移 Gateway。release-validation: 运行发布轨道的包、安装和实时行为验证。restore-backup: 恢复到隔离目标中,验证状态,并审慎地完成切换。
添加运维技能¶
将本地新增内容放入所配置的 Custodian 智能体的工作区,而不是放进随发布版拥有的包目录中:
工作区技能已经具有高于捆绑技能层的优先级,并且仅限于该智能体的工作区。遵循相同的 Gather → Mutate → Repair → Prove → Report 约定。保持描述简短。更改技能后启动一个新会话。完整格式参见 创建技能。
相关文档¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw