服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 2026.9.8 的正式发布时间是 UTC 10 月 3 日,版本号不是 9 月 8 日的发布日期。
- 官方于 UTC 10 月 4 日修订该版说明:Sol 相关工作属于准备性实现,支持尚未完成;这次是文档纠正,没有发布新的正式版本。
- 先预览升级目标并保留恢复点,再核对命令行与正在运行的 Gateway。
- 用同一账号和代理完成小任务验收,模型设置成功不能代替调用结果。
先确认这是哪一次升级
OpenClaw v2026.9.8 于 2026 年 10 月 3 日 03:21 UTC 正式发布。阅读旧教程时,应把软件版本、文章日期和自己机器上的版本分别看待。本文围绕现有安装升级后的检查展开,操作依据为官方文档,未声称在你的环境完成实测。
官方在 UTC 10 月 4 日更新了这次发布的说明,明确 GPT-6.1 Sol 支持尚未完成。不能再把升级到 2026.9.8 当作启用 Sol 的完整方案。下面以包管理器安装、需要检查更新恢复或委派回复修复的用户为主;建议保持已有模型,先验证基础功能,再单独评估模型变更。
先预览,再执行对应安装的更新
以下直升步骤面向近期版本;更早的安装先核对官方 Updating 文档的旧版迁移流程,不要直接套用本文命令。开始前先按末节建立备份,再运行 openclaw update status 查看当前安装与更新状态。对于 npm、pnpm 或 Bun 的全局安装,可先运行 openclaw update --tag 2026.9.8 --dry-run,核对目标后再运行 openclaw update --tag 2026.9.8。--tag 指定这次包更新的目标;若当前使用 extended-stable 渠道,不能直接套用该组合,应先阅读官方渠道说明。
源码、容器与桌面应用用户应按各自更新入口操作。尤其不要把“退出码正常”当作已经升级:官方说明中,无法识别包管理器归属的安装可能记录 skipped,提示按原安装方式更新。
执行前确认自己操作的是实际运行服务的那套安装,并在可安排中断的时间进行。建议保留升级预览、原版本和原安装方式,遇到停顿先看当前步骤,而不是同时从另一个终端再发起更新。
核对运行结果,而不只看安装结束
成功的托管 openclaw update 已包含 Gateway 重启与验证;若报告仍有服务修复警告,应按提示处理。检查问题时可运行 openclaw --version、openclaw health 和 openclaw gateway status --deep,分别观察命令行版本、健康情况及服务状态。
建议把输出与升级前记录放在一起看。如果命令行显示新版本,而服务未正常运行,先处理服务指向或启动错误,不急着重登模型账号。若原先能完成的简单对话也失败,应先定位基础服务。用升级前已经可用的模型做短任务,避免把尚未完整支持的 Sol 当成这次升级的验收标准。
Sol 支持未完成,先查当前模型状态
最新正式版说明将 Sol 的模型选择、API 密钥与订阅路由等列为准备性工作,并明确这些支持没有在 2026.9.8 中完成。旧说明中的选择命令已被移除。
先用 openclaw models list --provider openai 查看目录,再用 openclaw models status 查看默认模型、回退和认证概况。models set 修改全局默认;排查指定代理时,用 openclaw models status --agent 代理ID 查看该代理。把“代理ID”替换为自己的实际标识,不要原样复制。
建议先确认当前任务由哪个代理、哪个账号承接,并保留已经验证可用的模型。准备尝试 Sol 时,先查看明确完成支持的正式版本说明;本次修正文档没有给出完成版本或时间,不要把开发分支里的提交当作正式版已提供的能力。多人或多代理环境中,另一条会话成功也不能证明当前会话使用相同设置。
模型已选却失败,按证据区分问题
已知提供方下的模型即使不在本地目录,models set 也可能保存选择并给出警告。因此,保存成功不等于能够调用。models status 未加 --probe 时也不是模型调用测试;--probe 会发起真实请求,且有独立状态目录占用等运行条件,不应随手追加。
其他模型问题再按证据排查:模型或权限拒绝,对照账号目录;认证错误,检查正在使用的登录资料;超时或连接失败,确认是本地 Gateway 还是外部请求未完成。这是排查顺序,不是仅凭一条错误断定根因。若原模型可用,建议先用它完成工作,保留报错供后续正式版本复核。
委派返回改成一次,旧流程要明确续问
普通会话经 sessions_send 委派任务时,结果即时返回,或在完成后送回原请求会话一次。旧的自动代理往返与目标公告回合被移除,继续讨论或向渠道发送内容,需要显式后续请求或消息工具调用。隔离 Cron 等特殊调用路径可能返回 skipped,应按 delivery 状态判断,不要求额外重复投递。
例如,可让代理 A 请代理 B 只读列出一个测试目录的文件,再观察结果是否回到 A。接着由 A 明确要求 B 解释其中一个文件,用两次独立请求检验续问。不要拿“没有自动继续讨论”判定升级失败,也不要把这项变化理解为所有外部群聊都必须回复。若你的旧流程依赖自动接力,应先改写那一步,再验证完整任务。
失败时保留恢复点,别直接覆盖旧包
升级前可用 openclaw backup create --verify 创建经验证的备份。回退包版本不会撤销配置或数据库迁移:只有旧版能读取当前状态时,才按官方回退流程预览指定版本;不兼容时需要与备份匹配的软件版本和离线恢复。确认安装与会话历史正常前,不要清理更新报告列出的恢复文件。
建议把“恢复服务”和“尝试新模型”拆成两件事。先恢复已知能工作的环境,再单独调整模型;若确实需要恢复备份,先保存当前状态并确认备份之后新增了哪些会话,避免只为一次模型拒绝就丢失新工作。遇到新格式拒绝,不要手改版本标记绕过检查,按报告和下方官方恢复文档处理。
资料来源
常见问题
升级后先用哪条任务验收?
建议重复升级前能够完成的一条低敏短任务,保持相同账号、代理和模型,核对实际结果。准备尝试 Sol 时,先阅读本文第 4 节的版本说明,再决定后续操作;不要同时更换多项配置。
升级后代理没有自动继续聊天,是故障吗?
不一定。委派结果返回与后续对话要分别检查。先确认原请求会话收到了结果,再显式发起下一步;旧自动往返流程需要调整。
升级失败后可以直接装回旧版本吗?
先看更新报告与状态兼容性。降包不会撤销迁移;恢复前应确认匹配的备份、软件版本,以及需要保留的新增工作。