版本 · 升级
OpenClaw 2026.9.7 移除了 Tasks，Discord 和 Slack 默认接收其他机器人的消息
现在要不要升 2026.9.7，先看三件事：手上有没有一份验证过的完整备份，Linux 内核是不是低于 4.11，是不是打算从 2026.9.5 在聊天里用 /update 升。这一版会把数据库升到旧版本打不开的新结构，升上去再想退回，只能拿升级前验证过的备份配上原来的版本恢复。
升上去以后，有的面板被移除、有的默认值变了，哪些要手动处理，下面的表逐条列出。另有两个升级故障还没随 9.7 修掉：从 2026.9.5 通过聊天 /update 升级，有报告两次都被自动回滚（#161949），issue 下署名 steipete 的回复确认 main 分支已修、修复不在 9.7 里；内核不支持 statx 的 Linux 升级后 Gateway 循环重启（#162672），仓库的自动化账号判断 main 已修好，但这个修复有没有随某个版本发布，目前还没有证实。
怎么查 OpenClaw 当前跟的是哪条更新通道
在跑 Gateway 的机器上执行：
openclaw update status按官方通道文档的说明，它会列出当前生效的通道和决定它的来源（配置、Git 标签、Git 分支、已装版本或默认值）、安装方式是 Git 还是包、当前版本、有没有可用更新，以及最近一次记录在案的更新结果。想看这次会升到哪一版、要做哪些动作，又不改任何东西，跑预演：
openclaw update --dry-run预演会报出生效的通道、目标版本、计划动作，还有要不要降级确认。
OpenClaw 2026.9.7 在 9 月 30 日（UTC）发布。截至 2026 年 10 月 1 日，npm 上 latest 和 beta 两个标签都指向 2026.9.7，extended-stable 仍是 2026.8.33。跟 stable 或 beta 通道的，下一次 openclaw update 的目标版本是 9.7（早于 2026 年 6 月的安装要先过 9.5，见本节末尾）。各通道和 npm 标签的对应如下：
| CLI 通道 | 对应 npm 标签 | 截至 2026-10-01 指向 | 自动更新时怎么动 |
|---|---|---|---|
| stable | latest | 2026.9.7 | 等过内置延迟和分批推送的错峰时间后发起更新 |
| beta | beta（比 latest 旧或缺失时退回 latest） | 2026.9.7 | 有更新的版本就发起 |
| extended-stable | extended-stable | 2026.8.33 | 只给只读提示，从不自动安装 |
| dev | 不走 npm，跟 GitHub main | — | Git 安装每小时检查一次；官方不建议用在生产 Gateway 上 |
临时装某一版用 --tag、换通道用 --channel，两者的区别和命令示例在《OpenClaw 升级、回滚与彻底卸载》里有。
早于 2026 年 6 月的安装不能直接跳到 9.7。9.7 的 changelog 写明，这类安装必须先升到 2026.9.5，在 9.5 里跑 openclaw doctor --fix 并处理完导入问题，再继续往上升。
升级 OpenClaw 前的备份和磁盘空间怎么准备
9.7 的更新说明要求升级前做一份完整备份并验证。只导出配置不算能用来恢复的备份；旧版本做的归档，完整性不一定能确认。新版的已验证备份会核对登记过的每个数据库都在，包括挪过位置的智能体数据库。
自动回滚是有条件的。数据库要能恢复，抓取时 OpenClaw 必须处于停止状态、新版本从没启动过、之后也没有未记账的写入；改过或没抓全的配置文件，可能要手动恢复。changelog 另有一句：这些保护补不上由旧更新器执行的那次升级所缺的备份。从 9.5 往上升，跑这次升级的还是 9.5 装好的更新器，所以自己那份备份省不掉。
空间按《How an update runs》文档的说明分几块估，每一块都是至少要留的量：
- 快照所在的卷：2 × 全部 SQLite family 的字节数 + 3 × 最大的那个 family + 64 MiB，用来放保留的文件和工作空间。量出来不够，更新会在迁移之前就拒绝。
- 数据库原本所在的卷：如果和快照不是同一个卷，这个卷还要另外留出它上面 SQLite family 的总量 + 其中最大的一个 + 64 MiB，迁移后的原文件还在时用来恢复。
- 升级前验证用的临时副本：更新器会先量出共享库和智能体库这些 SQLite family，以及检查要用到的已安装插件文件和依赖，所需空间里还包括新版本 Doctor 的备份。
示意算例，只算了快照所在卷这一项，不代表具体机器：假设全部 SQLite 合计 1 GiB，最大的一个 0.8 GiB，那么 2 × 1 + 3 × 0.8 = 4.4 GiB，再加 64 MiB，约 4.46 GiB。
临时副本会放到第一个空间够用的位置：设了 TMPDIR 就先用它，其次是状态目录旁边的 <state-dir>.update-captures/，最后是系统临时目录。哪里都放不下，更新在复制前就报 snapshot-capacity-insufficient 并给出腾空间或设置 TMPDIR 的说明；这时清出空间，或者把 TMPDIR 指到空间够的其他磁盘再升。实际要留多少，以更新报告里记录的 total required space 为准，报告同时列出检查过的位置和各自的可用空间。
升级失败或没通过验证时，快照会留着，OpenClaw 可能就停在那里；要手动删旧快照，先看更新报告。
OpenClaw 升到 2026.9.7 以后要手动改的设置
下面几条出自 9.7 的 changelog：
| 变化 | 影响谁 | 要做的事 |
|---|---|---|
| Tasks 和 TaskFlow 的面板、命令、API 全部移除 | 用过 Tasks 面板、TaskFlow 或 TaskFlow Webhooks | 改用 subagent 控制、ACP 会话、后台进程、Cron 历史或 Lobster 流水线；TaskFlow Webhooks 没有对应的 HTTP 替代。已有的 Task 和 Flow 记录会保留，但部分 Codex 分派要手动迁移。手动替换安装后，启动前先跑 openclaw doctor --fix |
Tool Search 的旧 JavaScript 工具 tool_search_code 移除 | 手动升级，或修复被推迟的安装 | 重启前跑 openclaw doctor --fix，否则旧设置会让它起不来；JavaScript 编排改用 Code Mode |
Discord、Slack 配置里省略 allowBots 时，改为接收其他机器人的消息，升级后同样生效 | 接了 Discord 或 Slack 频道 | 想保持原来的行为，把 allowBots 设为 false；changelog 提醒机器人之间的对话仍可能来回打转 |
| 实时回复改成只发新增的文本 | 第三方原始客户端、自定义 SDK 传输 | 按更新后的流式协议改。协议仍报版本 4，别拿版本号判断；旧客户端可能丢回复文字。用自定义 SDK 客户端时，Gateway 和 SDK 一起升 |
| 每个 IP 同时挂着、尚未完成认证的连接，默认上限从 32 提到 128 | Gateway 开在共享网络或公网上 | 要恢复旧值，设 OPENCLAW_MAX_PREAUTH_CONNECTIONS_PER_IP=32，然后重启 Gateway |
| 图表退回 Mermaid 11.17.2 | 在对话里画 Mermaid 图 | Mermaid 12 才有的图表类型和内置 ELK 布局用不了，部分连线的样子可能会变 |
| macOS 服务里认得出的旧 PATH 可能被刷新 | 把命令放在 ~/bin、~/.nix-profile/bin、~/.volta/bin、~/.asdf/shims 或 fnm alias 目录里 | 除非目录里放着当前运行时，否则可能被移出 PATH。CLI 工具、MCP server 或 skill 调不到某条命令时，给它写命令的绝对路径；自定义的 PATH 设置不受影响 |
浏览器访问也有改动：没设允许地址列表时，也会放行你配置的公开 HTTPS 地址，已有安装同样如此，设了列表则列表优先。如果 OpenClaw 跑在容器里，升完确认 localhost 的控制台还能打开。
OpenClaw 从 9.5 用 /update 升 9.7 被自动回滚（#161949）
9 月 30 日开的 #161949，报告人在聊天里用 /update 发起托管更新，从 2026.9.5 升 2026.9.7，两次都在候选版本的 Doctor 检查上失败，报错是：
Doctor config promotion refused for top-level keys: meta, models, wizard.
authority-check-failed: OpenClaw state at ~/.openclaw/state/openclaw.sqlite is undergoing offline maintenance; retry when it finishes.结果记为 repair-requires-config-change，两次都自动回滚到 2026.9.5，回滚后 Gateway 正常运行。
按《How an update runs》的描述，旧 Gateway 在验证期间照常服务，更新器用新版本跑健康检查和配置校验，再拿复制的配置和 SQLite 快照在隔离目录里启动测试 Gateway；必需的检查不过，更新就被拒绝，回滚恢复上一代并把失败的那项记作原因。
issue 下署名 steipete 的回复在隔离环境里复现了这一步：已发布的 2026.9.7 里 Doctor 以退出码 1 结束，报的就是上面那段；main 分支上同一检查以 0 退出。回复的结论是 "fixed on main, but not in 2026.9.7"，对应修复 #160671，随即关闭 issue，并写明修复随 2026.9.7 之后的下一版发出。报错里的 meta、models、wizard，回复说明只是更新器列出的候选配置变化，不是禁用这几个键，配置里这几段不用删。
撞上了的话：
- 用
openclaw update status确认最近一次的记录是回滚、当前版本回到了 2026.9.5。 - 同一条
/update不用反复点。报告人两次结果相同，已发布的 9.7 在隔离复现里也一样失败。 - 留在 9.5 等下一版。用下一版或 main 升级还出现同样的拒绝，回复要求带上
openclaw update status --json的输出重开 issue。
9.4 升 9.5 那一轮的 doctor-failed、runtime-verification-failed 等原因码，处理办法在《OpenClaw 更新失败按 doctor-failed 等报错逐个处理》。
老内核 Linux 升到 OpenClaw 9.7 后 Gateway 反复重启（#162672）
10 月 1 日的 #162672，环境是群晖 DS920+ 上的 Docker，宿主和容器的内核都是 Linux 4.4.302+，用官方镜像从 2026.9.4 升到 2026.9.7 后，gateway 容器循环重启，Doctor 一轮轮地生成迁移备份。启动报错：
Existing shared-state database generation changed
SQLite database file identity changed before existing-only open
Session membership store changed before publication
Agent database operation belongs to another native owner报告人给出的原因：9.7 有些数据库和会话的身份校验会一起比对 dev、ino 和 birthtimeNs。内核没有 statx（4.11 才加入）时，Node 拿 ctime 顶替创建时间，Doctor 改一次权限它就变，身份被误判成换了文件。
issue 下的回复来自仓库的自动化账号 clawsweeper[bot]，不是维护者本人。它说当前 main 已经由 #162305 修好，随即按「已经实现」关闭了 issue；同一条回复也写着这个修复比 v2026.9.7 新，尚未证实已经发布，也不声称哪个已发布版本包含它。
内核版本用 uname -r 查。报告里点名的旧 NAS、嵌入式设备，以及其他内核低于 4.11 的 Linux 机器，先别升 9.7，等后续版本的发布说明里出现 #162305 再升。
已经升上去、Gateway 正在循环重启的，单纯换回旧版本的包或镜像不够：9.7 已经把数据库迁到旧版本打不开的新结构，要用升级前验证过的备份，配上和它对应的原版本一起恢复，别手动改数据库里的版本标记。步骤见《OpenClaw 升级、回滚与彻底卸载》。
OpenClaw 用 Sign in with ChatGPT（Beta）登录 OpenAI 要满足什么条件
9.7 加入了 Sign in with ChatGPT（Beta，文档简称 SIWC）：用 ChatGPT 账号给 OpenClaw 授权，把 Codex 额度用在符合条件的 Responses API 请求上。门槛在 OpenAI 那边，你的账号和工作区要由 OpenAI 开通 SIWC 注册和 token sharing。
在跑 OpenClaw 的那台电脑上执行：
openclaw models auth login --provider openai --method siwc登录时要同意 token sharing，模型调用才能用；只授权身份信息的话，账号会存下来，但推理前还会让你打开共享或换别的凭据。浏览器最后跳回 http://localhost:8080/auth/callback。浏览器和 OpenClaw 不在一台机器上时，先把浏览器那台的 8080 端口转发到 OpenClaw 的 IPv4 回环地址；如果 Gateway 在 SSH 主机上，在浏览器那台电脑上保持这条命令运行：
ssh -N -L 8080:127.0.0.1:8080 user@gateway-host按官方 OpenAI 配置文档，眼下用不了的有：OpenAI 托管的插件、connected apps、托管的 MCP 工具、tool search、托管的图像生成。SIWC 凭据也不授权图像生成、音频转写、语音合成和 memory embeddings，这几样要另配兼容的凭据。请求走 HTTP 流式，OpenClaw 里没有 WebSocket 推理和额度显示，额度去 ChatGPT 的 Settings → Usage 看。
官方仓库里 #161216 截至 10 月 1 日仍未关闭：授权同意页显示 This app is unavailable，错误码 invalid_client。登录停在这一页时，去这个 issue 跟进后续。
暂不升级 OpenClaw 2026.9.7 时怎么设置自动更新
Gateway 的自动更新默认是关的。之前打开过，就到 Control UI 的 Settings → Updates（/settings/updates）把 Automatic updates 关掉，更新通道也在这一页改。自动更新一旦发起，有 15 分钟的硬期限，到点即使还有工作也照样开始，管理员可以用一次 Hold 1 h 往后推。
无头节点（headless node）的默认值相反：长期运行的打包版无头节点默认自动更新，首次连上后每小时检查一次，空闲时才切换。要让节点停在当前版本，按《Automatic updates》文档 Headless node updates 一节，在节点那台机器上把 nodeHost.autoUpdate.enabled 设为 false。Gateway 上的 update.auto.enabled 只管 Gateway 自己的更新，管不到节点的这项默认值。查节点实际跑的版本，在连着它所属 Gateway 的 CLI 上执行 openclaw nodes status --json，看 nodes[].version；openclaw --version 报的只是这个 CLI 自己的版本。
想走慢一拍的线，就是 extended-stable。2026.8.33 发布于 9 月 29 日，发布页称它是 "our current equivalent to LTS"：2026 年 8 月底的 OpenClaw，加上关键安全更新、可靠性和性能修复，以及新模型支持，这一版只含 Gateway。通道文档写明，这条通道只支持包安装、只能前台安装，自动更新只给只读提示，从不自动装。
方向要看清：已经在 2026.9.x 上的机器，2026.8.33 比现在装的旧，切过去等于降级。通道文档写明目标版本比当前旧时会要求确认，预演也会报出这一项。已经升到 9.7 的更要注意：9.7 会把智能体数据库升到 schema 24，旧版本打不开；这一版的 changelog 还写到共享状态从 schema 18 升到 19。按 changelog 和《How an update runs》文档，更新器遇到不兼容的降级会直接拒绝，想退回只能用升级前验证过的备份配上对应的版本恢复，不要手动调低数据库的版本标记。回滚和降级怎么做稳妥，看《OpenClaw 升级、回滚与彻底卸载》。
常见问题
- OpenClaw 2026.9.7 的安卓 APK 更新了吗？
- 这一版跳过了安卓 APK。9.7 的 GitHub 发布页在 Release verification 一节写明 Android APK 为 skipped：apps/android/version.json 里还是 2026.8.2，而这次发布的版本线是 2026.9.7。发布页同时记了一条待办，要在下一个版本打标签之前处理安卓的版本号。
- 升到 OpenClaw 2026.9.7 以后，Telegram 收发要先测一下吗？
- 值得测。9.7 的 GitHub 发布页在 Release verification 一节写明，Telegram 集成检查（source QA、Package Acceptance、已发布包的端到端测试）这一版由发布负责人豁免，未运行。如果频道主要靠 Telegram，升完先在频道里发一条消息，确认收发正常。