跳转至

托管技能

Custodian 技能是与 OpenClaw 一起发布的、按版本管理的运维手册。它们位于包中的 custodian-skills/ 目录下。它们以捆绑技能优先级层级加载,但仅针对由 agents.defaults.systemAgent.agentId 解析的智能体。

当该设置不存在时,OpenClaw 会回退到保留的旧版默认所有者、唯一配置的智能体,或者在没有显式智能体名册时回退到旧版 main。如果配置了多个智能体但没有系统智能体或保留的旧版所有者,则没有任何智能体获得该技能库。对于所有其他智能体,Custodian 技能不会出现在发现、快照、斜杠命令目录、沙箱同步以及面向模型的技能 prompt 中。

常规技能控制仍然适用。skills.entries.<name>.enabled: false 可禁用单个 Custodian 技能,智能体技能允许列表可进一步缩小最终集合。参见 技能配置。

工作流约定

每个随版本发布的 Custodian 技能都按以下顺序使用相同的五个部分:

  1. Gather(收集) 读取脱敏后的当前配置,并检查实时状态。
  2. Mutate(变更) 使用经过验证的非交互式写入,绝不直接编辑文件。这些写入来自可信 shell 中的 openclaw config set / openclaw config patch,或者在策略允许时使用会话内的 Custodian 工具操作。
  3. Repair(修复) 使用 openclaw doctor --lint 进行诊断。只有经过明确批准的修复才会使用 openclaw doctor --fix --non-interactive。只读的 diagnose-gateway 技能会推荐该独立步骤,但绝不执行它。
  4. Prove(验证) 实际演练一个实时端到端结果。
  5. 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 智能体的工作区,而不是放进随发布版拥有的包目录中:

<custodian-workspace>/skills/<skill-name>/SKILL.md

工作区技能已经具有高于捆绑技能层的优先级,并且仅限于该智能体的工作区。遵循相同的 Gather → Mutate → Repair → Prove → Report 约定。保持描述简短。更改技能后启动一个新会话。完整格式参见 创建技能。

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