更新OpenClaw并完成运行确认的openclaw-update
機械翻訳 / Machine-translated
機械翻訳 / Machine-translated
原文链接：更新OpenClaw并完成运行确认的openclaw-update（cccskills）
技能页面：openclaw-update
本文结论
安装openclaw-update后，OpenClaw Gateway的运维人员可以将更新工作交由Agent处理。
可委托的范围涵盖：按适配部署环境的流程执行更新、重启后的会话恢复，以及运行版本的确认。
以下将依次介绍更新流程的分派方式、安装方法、请求示例，以及使用前需了解的注意事项。
请求更新已有Gateway时，Agent会从确定目标到完成运行确认，一气呵成地完成全部步骤。
请更新这台服务器上的OpenClaw Gateway，并完成运行确认
Agent首先会调查目标主机、执行用户、配置文件及状态的保存位置。
同时确认服务、正在运行的版本以及负责更新的管理主体（Owner）。
这是因为本地仓库或Shell的CLI有时可能属于另一个安装实例。
在此基础上，系统会选择适合当前部署环境的已有更新流程。
备份、重启、恢复均按该流程中的说明执行。
最后的工作是确认目标版本或提交是否实际正在运行。
结果以1～3行的简短报告返回，仅在必要时附上简短的SHA（用于标识提交的字符串）。
不包含重复日志或完整哈希值。
该技能的职责是将更新分派至各环境对应的正确流程，并跟踪至完成。
它不会自行构建更新方案，也不会创建新的部署机制或调度器。
使用哪种更新流程，取决于部署环境的类型。
| 部署环境 | 使用的更新流程 |
|---|---|
| 正规的main检出与macOS应用 | openclaw-live-updater技能 |
| 运维人员配置的Team服务器 | update-team-server技能 |
| 容器或声明式安装等其他托管环境 | 环境专属技能或运维手册，以及已有的管理主体 |
| 标准包，或单用户源码安装 | OpenClaw更新文档与update CLI（使用目标主机·配置文件对应的CLI） |
对所选流程的命令、锁定、备份及迁移要求原样遵守。
通知策略和收尾工作亦同。
不会在单独管理的版本或运行中的容器内执行标准CLI更新。
同时避免修改正在运行的Gateway所使用的文件，也不会覆盖存在未提交变更的检出。
更新请求默认包含常规重启和有限时间的中断。
需恢复的会话会自动重启，因此不会仅因Agent或任务正在运行而重复询问确认。
停止时使用的是管理主体提供的优雅停止方式（等待处理中的任务完成后再停止）。
取消任务、中断会话、清空队列会导致工作丢失，因此不会为了强行制造等待状态而使用这些操作，也不会手动重做已恢复的对话。
即使更新被推迟、发生失败或回滚，该技能也不会放弃请求。
它会追踪至管理主体的完成确认，或明确出需要外部处理的具体阻碍因素为止。
仅旧进程恢复运行，不算作完成。
若用户指示暂停或取消，则遵从该指示。
若没有继续推进的路径，则如实报告阻碍因素，不作无法兑现的承诺。
确认时使用管理主体的验证流程。
主要检查以下几点：
构建成功或交接确认不构成完成的证据。
监控包装器返回成功，实际更新有时仍可能延迟或失败，因此两者的结果会分开读取。
安装方式有两种：执行一行命令，或委托Agent处理。
通过命令安装时，可选择安装目标Agent，如Claude Code或Codex。
npx skills add https://github.com/openclaw/openclaw --skill openclaw-update
委托Agent安装时，请直接发送以下内容：
请安装以下 Agent Skill。
https://github.com/openclaw/openclaw/tree/main/.agents/skills/openclaw-update
请先确认 SKILL.md 及附属文件的内容，确保没有可疑操作（如向外部发送数据、读取认证信息等），然后将其放置到 Claude Code 对应的 ~/.claude/skills/openclaw-update/，或 Codex 对应的 ~/.agents/skills/openclaw-update/。
存放位置根据使用范围有所不同：
| Agent | 在所有项目中使用 | 仅在特定项目中使用 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ | .agents/skills/ |
包含的文件为SKILL.md和agents/openai.yaml共两个。
分派目标的流程说明位于同一仓库的其他技能或OpenClaw文档中。
若有适用于自身环境的技能（如openclaw-live-updater或update-team-server），请一并安装。
请求内容可以用中文。
注明更新范围或希望确认的事项，可使报告内容更加清晰。
将本地的OpenClaw Gateway在保持当前更新频道的情况下更新至最新版
此处"最新版"的含义为保持已配置频道不变。
Agent会确认管理主体，并按对应流程执行更新。
完成后的报告简短，仅告知当前运行的版本。
我想更新所管理服务器上的Gateway。
请先调查应使用哪种更新流程
Agent会调查主机、执行用户、服务及正在运行的版本，并判断属于上表中的哪种流程。
若本地CLI属于另一安装实例，该情况也会被识别并区分。
用最新的main更新，并确认正在运行的提交和健康状态
明确指定"最新main"后，会选择从开发版源码更新的流程。
这相当于标准CLI中的--channel dev。
开发版的预检有时会选择可构建的较旧提交，因此更新前会显示目标，更新后会报告实际运行的SHA。
适用对象仅限已有Gateway的常规更新。
不处理新安装、版本验证与发布，以及无关的主机。
需要目标环境的管理流程及相应的访问权限。
更新会伴随重启。
需恢复的会话会自动重启，但PTY（伪终端）不会保留。
若管理主体没有受控中断机制，Agent会报告该不足，或在允许范围内自行修复。
不会创建强制标志或绕过兼容性检查，也不会自动接受未经授权的降级或插件权限变更，同时遵守托管环境特有的限制和更新锁定。
若在更新流程中发现确定的问题，会在允许范围内进行修复，修复内容经PR审查和CI后合并。
许可证为MIT。
安装前请阅读SKILL.md及附属文件，确认没有可疑操作。
openclaw-update分派的目标技能，根据环境有时需要配合使用。
openclaw-live-updater是将macOS上的OpenClaw更新至main最新版，并确认Gateway和应用运行状态的技能。
在正规main检出与macOS应用的环境中，由该技能负责更新。
update-team-server负责将运维人员配置的Team服务器的更新移交给负责人，并推进验证、恢复、完成确认。
如果您正在运维Team服务器，请一并安装。
会。更新请求包含常规重启和有限中断，需恢复的会话会自动重启。但PTY（伪终端）不会保留。
本地仓库或CLI有时属于与目标更新环境不同的安装实例。该技能会确认目标主机的配置文件和管理主体后，再选择对应该环境的流程。
不能。适用对象为已有Gateway的更新，新安装及版本验证与发布不在范围内。
即使发生延迟、失败或回滚，也会持续追踪至完成确认或明确具体阻碍因素为止。若需要外部处理，会简短报告该阻碍因素。
openclaw-update是一个按目标环境的管理流程，对已运行的OpenClaw Gateway执行更新的技能。
它会一气呵成地完成重启后的会话恢复，以及目标版本是否正在运行的确认。
适合管理多个部署环境、不确定应使用哪种更新流程的运维人员。
不妨先尝试委托更新本地Gateway，确认分派和报告的流程。
本文转载自 cccskills 的文章「更新OpenClaw并完成运行确认的openclaw-update」。
技能详情及安装方法请参见 cccskills 的 openclaw-update 页面。