OpenClaw 2026.9.1 发布:Mermaid 全场景渲染、Gateway 自愈、Codex 审批持久化

OpenClaw 在 9 月 3 日悄然推送了 v2026.9.1 版本。本次更新距离上一版（v2026.8.2）累积了 1,195 个 PR 与 491 次主分支提交，由维护者 Peter Steinberger（steipete）签名。从功能头条到性能细节，本期可谓「让产品更顺手、让底层更稳」的一次综合升级。

本文整理自官方 GitHub Release v2026.9.1^[1] 的完整发布说明，按亮点、改进、破坏性变更分块呈现，方便快速定位自己关心的部分。

一、本期亮点

1. Mermaid 在每个会话里都看得见

```mermaid 代码块现在会自动在 Control UI、macOS / iOS / Android 原生客户端 中渲染为可视化图表，移动端还有专门的失败重试机制和放大预览。

无论是流程图、时序图、甘特图，直接贴在消息里就能看，不用导出图片。

2. 从安装到对话只要一个提示

全新安装（包括 npx openclaw@latest）现在走一条「快速通道」：

• 自动识别本机已有的 Claude Code 或 Codex 登录态 / API Key
• 在线校验凭据是否可用
• 直接进入 Web Dashboard

原本的完整向导被收进「Custom setup」入口，老用户不被打扰。

3. 共享 Gateway 上的个人技能库

过去团队 Gateway 上想保留个人技能非常麻烦。本次新增 openclaw skills library：

• 个人技能和团队工作区技能 并存而不冲突
• 支持从 ZIP 压缩包导入
• 可按 身份 在团队 Gateway 上分享 / 发布

4. 升级也能继续工作

openclaw update 一口气做了多项鲁棒性改造：

• Doctor 失败时 自动回滚 npm 候选版本
• 失败升级也会 保留配置和 Secret 引用
• 升级失败交给内置 triage agent 处理
• 等待插件就绪后再重启，避免抢占
• 支持本地 npm 12 tar 包离线升级
• 代理发起的升级可以脱离 Gateway 进程树继续
• 没有 systemd / launchd 时也不卡住

5. Gateway 真的能立住

• 高负载 + 大型 agent 名册下也能正常启动恢复
• 损坏的历史 cron 行 不再阻塞启动，直接隔离
• 迁移告警降级为提示，不再拒绝启动
• 本地模型服务器成为首选 OOM 牺牲对象，避免主进程被 OOM Killer 盯上
• Windows Gateway 在 agent 重启后保持在线

6. Codex 审批「永远允许」真的能永远

• "Allow Always" 现在 对 MCP 工具持久生效（前提是 OpenClaw 配的服务器）
• 工具审批跟随 session posture，跨实例不丢
• 同一 Codex placement 内已批的允许会被 复用，不必每次重新确认

7. 审批消息会主动找你

当被委派的系统 agent 提交配置变更或 Gateway 重启请求时：

• 审批卡片直接送到 发起该任务的频道（包括 Telegram topics）
• 卡片附带 请求人身份与职务
• 不再需要跑去后台点确认

8. Android 终于追平 Web UI

聊天面板、侧边栏、外观设置统一对齐 Control UI；输入框最多长到 6 行；听写不可用时自动引导录音。

二、主要变更

账户与身份

• 新增 "My GitHub" 个人 GitHub 账号，与系统账号并存；可在不同 session 间无缝切换而无需重复校验
• Model Setup 页面区分账号态 / API Key 态，实时回显 Codex、Claude 的注册邮箱
• 「+」号直接在终端唤起对应 CLI，模型选择器支持默认自动保存

模型与用量

• 新增 Anthropic Fable 5.1 支持
• SuperGrok 用量接入 openclaw models 与用量面板
• GPT-5.6 Ultra 在 runtime 切换时保持选中状态
• Vertex 上 Sonnet 5 价格更新为最新

本地与已配置 provider

• 自动发现 web app 端点背后的 llama.cpp 模型
• 本地 Ollama 路由保持可选
• 配置后自动启用 Google provider 插件
• 已通过外部认证的 provider 不被刷新覆盖
• 鉴权 / 配置变更后 无需重启 即可刷新模型目录

Agent 工作目录与 worktree

• 新增 agents.defaults.cwd 与 per-agent cwd 配置
• 新增全局 worktreeRoot
• 托管 checkout 最多支持 100 个，到上限不再拒绝新 session

配置控制

• 新增 cron.skipMissedJobs
• 新增 blockedHostnames SSRF 防护（浏览器 / Web Fetch / Webhook）
• config set 支持 --expect-current-json、--expect-current-absent、--dry-run、--strict-json
• channels.<id>.enabled: false 直接跳过加载该 channel 插件

记忆维护

• openclaw memory reset 仅重建派生索引，不删除会话
• recall 结果反馈给模型，便于后续推理

Codex 插件

• 本地历史在受监管 fork 中保留
• 其他会话运行时，空闲会话可继续推进
• MCP 工具保持原生 fallback
• 按时区处理时间
• 托管安装已迁移至 Codex 0.152.1
• 流式、语音、推理链路整体打磨

会话与界面

• 大列表下 session 切换更快
• 侧边栏目录分组每组上限 5 个 session
• 「New Session」「Chat」启动路径更轻
• Control UI 在 agent header 暴露侧边栏控件
• 主题色支持 accent color
• 移动端 dashboard widget 适配窄屏
• Agent 选择器 / 设置页面加入 skeleton loading
• 群成员 hovercard、账户页底暴露 Gateway 暂停入口

macOS / iOS / watchOS / Linux

• macOS：原生编辑器精简、侧边栏支持过半屏宽度、闲置 CPU 降低、后台 session 完成有通知、Talk overlay 在快速切换中保持可见、语音识别器复用
• iOS / watchOS：session dashboard 不再嵌套 Control UI；模型目标可用性明示；Watch / 实时语音回复各自保留 turn；口语回复超时给说明
• Linux 桌面：首次启动无需 CLI

Channel 改进

• 飞书、Matrix 增加 agent 回复按钮
• LINE 告诉 agent 自己渲染了哪些按钮；保留快捷回复文本；支持 @ 群成员并直达回话 turn；卡片可能被拒绝时优雅降级

CLI / 插件 / Skills

• channels add/login/logout/remove/resolve 支持 --agent
• mcp --json 输出 JSON 失败包络
• zsh / Bash 补全修正
• heartbeat 显示 Gateway 时长
• sessions tail 报告轨迹结果
• secrets JSON 失败结构化
• TUI 选择器取消问题修复

卸载与备份

• openclaw uninstall 默认 仅卸载服务、保留用户数据
• Claude 迁移备份保留被覆盖的生成技能
• 备份跳过已禁用工作区、容忍 ACPX 软链、在易失过滤下保留活跃配置

三、Bug 修复精选

由于本期修复条目非常密集（覆盖安全、运行时、UI、平台、性能等十几个维度），下面按影响面挑出关键项：

安全与边界

• SMS webhook 预认证读并发有界
• Watch 节点撤销后命令链停止
• Copilot Azure BYOK proxy 强制 per-process nonce
• Webhook 限速按客户端隔离
• 节点 token 按 owner 可管理
• 拒绝超大 A2A JSON-RPC 批 / 响应
• 旧版 config.get 不再泄露未脱敏快照
• systemd 单元备份不再泄漏 Gateway token
• iOS 不再向日志写入 deep link URL
• Chrome MCP --browserUrl 端点强制遵守可达性策略；未审核的 Chrome MCP 升级被阻止
• 临时文件名拒绝 dot 穿越
• 记忆同步跳过符号链接 / 非常规文件
• Agent 创建在委派权限关闭后停止
• 私有沙箱里 guest coding 不再失灵
• Dashboard 读 GitHub Actions 走 agent 身份

升级与数据完整性

• schema-17 session 原子修复
• 嵌套 session 写入有序
• 旧 cron 行保留 enabled 状态
• 清理期间被替换的凭据得到保留
• 旧版 agent-list 升级后工作区存活
• per-agent 记忆搜索在 Doctor 后恢复
• doctor --fix 在空 attestation 下能收尾
• 跨进程凭证迁移中断后可恢复
• 凭据迁移冲突可诊断
• 自定义 provider 的 SecretRef 跨 Doctor 存活

运行时与可靠性

• 子 agent 完成消息在父 turn busy 后也能送达
• 空完成会被记录
• 模型 reroute 显示更清晰，包括 rerouted siblings
• 上下文使用计数不再被缓存超额
• Anthropic 拒绝直接终止，不再重发
• 单一 failover owner 接管瞬时 LLM 重试
• 时区正确处理 ISO 日期
• 不再因父链成环挂死
• Gateway 不再被晚到的 CLI 输出拖垮
• 超长 transcript 改为流式而非整段加载
• oc-path 修补保留原字节
• PDF / 图片分析在 Code Mode 下存活
• /bash 失败显示真实 exit status

消息渠道

• 任务列表跨 chunk 边界存活
• 完整 markdown 链接被正确解析
• UTF-8 附件跨 sniff 边界识别
• Slack thread 回复重新可用
• Discord Webhook 投递结果如实显示
• WhatsApp 引用缓存未命中时不再发空泡
• iMessage 在私有 API 网桥失效后立即 fail-fast
• Signal SSE 永久拒绝时上报终态
• 飞书校验文档 API 结果
• Twitch 报错明确指出 accessToken 键
• 禁用 manifest 账号从健康检查里剔除

UI / 平台 / 性能

• 附件-only 消息回复已恢复
• 队列 prompt 顺序修正
• Gateway 宕机后图片仍能恢复
• 通配符 tool policy 正确显示
• macOS 设置取消 / onboarding 失败可一键重试
• iOS 长按文本选择正常
• Android 模型鉴权不可用时禁止发送
• npm 12 安装在 Windows 上容忍 stderr 警告
• Docker 镜像预装 libgomp1 以托管 llama.cpp
• 控制台表格列对齐稳定
• 多语言环境下 duration 数量保留
• 大幅削减目录刷新、重置、聊天的内存尖峰
• CodeMode 与 session 查找延迟下降
• 启动更快：Doctor bootstrap 精简；CLI-only 代码不再进启动路径
• Markdown / 回复格式化分配更少
• 更新恢复模块仅在更新时加载

四、需要注意的变更

虽然 release notes 没有单独列「Breaking Changes」章节，但有两处 行为默认值变化 值得留意：

1. 更新方式

   仍在 v2026.8.2 且没有 service manager 的用户，请执行一次 openclaw update --no-restart。

2. openclaw uninstall 默认行为

   现在默认 仅删除服务、保留用户数据。需要彻底清理请显式带 --purge 类选项。

3. 插件升级权限

   旧的 capability 同意失效后，再次升级插件会 重新征求同意。

4. Channel 关闭

   channels.<id>.enabled: false 现在直接跳过加载该 channel 插件，对性能更友好，但如果你依赖加载副作用，需要重新评估。

五、写在最后

v2026.9.1 看起来没有特别亮眼的新卖点，但仔细读 notes 会发现，整支团队把力气花在了三个真正影响生产体验的方向：

• 让升级、迁移、卸载这些「运维时刻」不再翻车
• 让 Codex / Claude Code 这种生态级集成更顺
• 把持续累积的内存、启动、UI 抖动一点一点压下去

对于仍停留在 v2026.8.x 的用户，建议先按官方指引走一次 update，再去 Doctor 里跑一遍 doctor --fix，把升级带来的小毛病一次性清掉。

参考：https://github.com/openclaw/openclaw/releases/tag/v2026.9.1^[2]

本文由 OpenClaw 发布跟踪整理，原始数据版权归 OpenClaw 项目及其贡献者所有。

引用链接