## 2026.5.28
### 重点
- Agent 和 Codex 运行时恢复更加稳定：子 Agent 保持当前工作目录/工作空间分离，钩子上下文保持提示词本地化，会话锁在超时中止时释放，避免使用过时的重启延续，Codex 应用服务器/辅助程序故障不再破坏共享运行时状态。(#87218, #86875, #87409, #87399, #87375)
- 频道投递和会话身份在出站插件钩子、Matrix 房间 ID、iMessage 反应/批准、Slack 最终回复、Discord 恢复工具警告、WhatsApp 配置文件认证根、Telegram 轮询和 Microsoft Teams 服务 URL 信任检查中变得更加安全。(#73706, #75670, #87366, #87451, #87334, #82492, #83304, #87160)
- 移动端和聊天界面得到更广泛的刷新：iOS Pro 界面、Gateway 聊天传输、入门引导、Talk 权限、WebChat 重连投递和会话选择器行为现在在重连和空搜索时保留更多状态。(#87367, #87531, #87682)
- 浏览器、频道和自动化输入更加严格：浏览器工具超时、视口/标签页索引、Gateway 端口、cron 重试处理、Discord 组件 ID、schema 数组引用、Telegram 回调页面和频道进度回调现在能更早拒绝格式错误的值，并保留预期的投递上下文。(#82887)
- 提供商、媒体和文档覆盖范围扩大：新增 Claude Opus 4.8、Fal Krea 图像模式、NVIDIA 特色模型、MiniMax 流式音乐响应、加密 PDF 提取、语音模型目录、GitHub Copilot Agent 运行时支持，以及 Codex Supervisor 插件路径用于委托的 Codex 工作流。(#87845, #87890, #80775, #84764, #87751, #87794)
- CLI、认证、诊断和提供商路径更快失败，更清晰恢复：格式错误的数字/版本选项被拒绝，工作区 dotenv 提供商凭据被忽略，OAuth 和本地服务启动请求受限，旧版 `api_key` 认证配置文件迁移到规范形式，重启指导具有可操作性。(#87398, #86281, #87361, #83655, #87559)
- 插件和 Gateway 热点路径减少重复工作，同时保持缓存正确性，涉及安装记录、配置 JSON 解析、工具搜索目录、会话存储、清单模型行、自动启用插件配置、浏览器令牌和查看器资产。(#86699)
- 发布、QA 和 E2E 验证现在限制更多日志、工件、测试框架和跨操作系统等待，以便故障通道产生证据，而不是挂起或虚假通过。
### 变更
- 状态：在状态输出中显示活跃子 Agent 详情。
- 差异对比：拆分默认语言包，扩展默认差异对比语言覆盖范围，同时保持主机基准对齐。(#87370, #87372) 感谢 @RomneyDa。
- ClawHub：添加插件显示名称以及技能验证和信任界面。(#87354, #86699) 感谢 @thewilloftheshadow 和 @Patrick-Erichsen。
- iOS：刷新开发应用，新增 Pro 命令、聊天、Agent 和设置标签页，连接到 Gateway 会话、诊断、聊天和实时 Talk。(#87367) 感谢 @Solvely-Colin。
- 文档：澄清 Codex 计算机使用设置、粘贴令牌标准输入认证设置、macOS Gateway 睡眠故障排除、原生 Codex 钩子中继恢复、容器模型认证、安装部署卡片、设备令牌管理员限制、CLI 设置流程兼容性以及向后移植目标。(#87313, #63050, #87685) 感谢 @bdjben、@liaoandi 和 @thewilloftheshadow。
- PDF/工具：使用 ClawPDF 进行 PDF 提取，支持加密 PDF 提取，并在 Agent 工具结果中显示 MCP 结构化内容。(#87670, #87751)
- 提供商：新增 Claude Opus 4.8 支持、Fal Krea 图像模型模式、NVIDIA 特色模型目录、MiniMax 流式音乐响应以及提供商支持的语音模型目录。(#87845, #87890, #80775, #84764, #87794) 感谢 @eleqtrizit 和 @vincentkoc。
- Codex/GitHub：新增 GitHub Copilot Agent 运行时和 Codex Supervisor 插件包。
- Discord：在进度草稿中显示评论，以便实时 Discord 运行暴露有用的进行中上下文。(#85200)
- 插件 SDK：为需要投递频道所属回复的插件添加回复负载发送钩子，并展开 SDK 声明的包类型。(#82823, #87165) 感谢 @RomneyDa。
- 策略：添加策略比较、入站频道一致性以及沙箱态势一致性检查。(#85572, #85744, #86768)
### 修复
- Agent：当可选的 `agents delete` Gateway 探测无法认证时，回退到本地配置修剪，以便离线安装仍可删除 Agent 而不移除共享工作区。
- 收紧电话控制修改授权 [AI]。(#87150) 感谢 @pgondhi987。
- 澄清指令持久化授权策略 [AI]。(#86369) 感谢 @pgondhi987。
- Agent/Codex：保持生成子 Agent 的当前工作目录/工作空间状态分离，保持钩子上下文提示词本地化，在超时中止和运行时拆除时释放会话锁，避免会话事件队列自等待，清理执行中止监听器，增量流式传输助手增量，恢复原始缺失线程压缩失败，在启动或辅助程序故障时保留共享应用服务器状态，在重启间保持原生钩子中继存活并清理过时的桥接文件，保持 Claude 实时工具进度对看门狗恢复可见，抑制废弃的请求者完成交接，通过工具路由工作区内存，优先解析 Codex 运行时模型，报告隔离的动态工具，格式化 `skills` 命令输出，并限制压缩/重试指导。(#87218, #86875, #86123, #87399, #87375, #72574, #87383, #87400, #83022, #87671, #87738, #87747, #87706, #87546, #87541) 感谢 @mbelinky、@Alix-007、@luoyanglang、@yetval、@sjf 和 @joshavant。
- 频道：将规范会话键线程化到出站钩子中，保留 Matrix 房间 ID 的大小写，使回退工具警告保持提及惰性，在后期清理中保留已投递的 Slack 最终回复，在拒绝反应后继续 iMessage 轮询，抑制重复的原生执行批准，保留 Telegram SecretRef 提示配置和轮询保活，保留 WhatsApp 配置文件认证根、QR 码显示、文档文件名和插件钩子配置，抑制 Discord 恢复工具警告，保留 Discord 语音出站辅助程序，并阻止不受信任的 Teams 服务 URL，同时保持 TeamsSDK 模式对齐。(#73706, #75670, #87366, #87451, #87465, #87334, #76262, #83304, #82492, #87581, #77114, #86426, #85529, #87160) 感谢 @zeroaltitude、@lukeboyett、@xiaotian、@eleqtrizit、@heyitsaamir、@amittell、@liorb-mountapps、@masatohoshino、@bladin 和 @giodl73-repo。
- CLI/认证/诊断/提供商：拒绝格式错误的数字/超时/子命令版本输入，忽略工作区 dotenv 提供商凭据，等待重生子进程关闭，限制 Codex 和 GitHub Copilot OAuth/令牌请求，强化 Codex 认证探测，在主线程外预热提供商认证，尊重 Codex 响应超时，停止将当前 Claude Haiku 4.5 配置文件迁移到 Sonnet，限制本地服务启动，无需缓存目录解析 GPT-5.5，迁移旧版内存自动提供商配置，重写非规范的 `api_key` 认证配置文件，并使诊断重启跟进具有可操作性。(#87398, #86281, #87361, #83655, #87559, #87719) 感谢 @Patrick-Erichsen、@samzong、@giodl73-repo、@alkor2000、@mmaps 和 @nxmxbbd。
- Gateway/安全/会话状态：在认证轮换后使浏览器令牌过期，限定助手幂等性去重范围，排空探测客户端关闭，避免复用过时的重启延续，保留重试后回退和过时的速率限制冷却探测，限制 webchat 图像和工件转录扫描，在入站元数据时间戳中包含秒数，清除已完成的会话活跃运行，并在行数上限时驱逐当前插件状态命名空间。(#87810, #87833) 感谢 @joshavant。
- 配置/解析/网络：拒绝部分数字解析，严格解析提供商/Discord 重试头部和日期，尊重 IPv6 和裸 IPv6 `no_proxy` 条目，规范秘密目标数组索引，并拒绝格式错误的内容长度、检查的 TCP 端口、市场内容长度、cron 周期、沙箱状态字段、不安全持续时间值、空配置路径段、非规范 schema 数组引用、不安全的 Telegram 回调页面以及无效的 Teams 附件获取 DNS 目标。
- 浏览器/输入强化：拒绝无效标签页索引、过大的视口调整、显式零 CDP 端口、格式错误的地理位置选项、不安全的截图或权限授予超时、宽松的响应体限制、无效的 Cookie 过期时间以及非有限的浏览器工具延迟/超时。
- Cron/自动化：在瞬态模型速率限制后重试周期性作业，而不是等待下一个预定时间槽，并在跳过预定工作前预先检查模型回退。(#82887)
- 自动回复/指令：在指令持久化期间尊重提供商和中继频道元数据，以便频道发起的决策保留其预期上下文。(#87683)
- WhatsApp：从活跃配置文件解析认证目录，以便配置文件作用域的 WhatsApp 安装不会漂移到错误的凭据根目录。(#82492)
- Gateway/会话状态：清除已完成的会话活跃运行，避免为 MCP 清单冷加载提供商，缓存单会话子索引，限制握手定时器，并限制预认证、认证守卫、媒体、转录、就绪和端口选项。
- 频道/回复：在详细输出关闭时保留频道所属的进度回调，保持群组房间进度抑制不变，优先使用外部会话投递上下文，转义 Discord 组件 ID 分隔符，强制最终 TUI 聊天重绘，显示 Slack 推理预览，并标准化 Discord/Matrix/Mattermost 频道数字选项。(#87476, #87423)
- Agent/工具参数：强化智能引号参数修复，用于编辑数组和精确转义参数，以便模型生成的工具调用在不破坏有效输入的情况下恢复。(#86611)
- 提供商/Agent：保留种子化的 Anthropic 签名，保留带符号的思维负载，连接签名增量块，在层级后缀间保留 DeepSeek `reasoning_content` 重放，将 OpenRouter strict9 ID 应用于 Mistral 路由，提升 Ollama 纯文本工具调用，加载 NVIDIA 特色模型目录，流式传输 MiniMax 音乐生成响应，并恢复空预压缩。(#87593, #87493, #80775, #84764) 感谢 @eleqtrizit。
- 媒体/图像：在解析生成图像时跳过 CLI 图像缓存引用，并限制生成的视频下载，以便过时引用和慢速提供商干净失败。(#87523)
- 文件传输：处理在归档验证或解包已完成后出现的延迟 tar 标准输入管道错误。
- 性能：在重新加载间信任安装记录缓存，优先使用原生 JSON 解析，重用未更改的工具搜索目录，跳过未更改的存储序列化，添加预计算会话补丁写入器，减少存储克隆分配，缓存清单模型目录行和自动启用插件配置，避免为条目读取获取完整会话快照，推迟配置的 Slack 完全启动，优先使用捆绑插件分发条目，并精简当前元数据身份缓存。(#87760)
- Docker/发布/QA：打包运行时工作区模板，流式传输跨操作系统服务的工件，保留稀疏的 Crabbox 运行工件，按包隔离 npm 插件安装，拒绝不兼容的包插件 API 安装，限制 OpenClaw 实例日志、插件测试中继日志、MCP 通道缓冲区、综合测试扫描、Agent 回合断言和发布场景日志，并保持发布/Google 实时守卫最新。(#87647, #87477) 感谢 @rohitjavvadi。
- 发布/CI：限制手动 git 获取、ClawHub 验证器响应、ClawHub 所有者元数据、Parallels 限制、启动/测试/内存预算解析以及差异查看器构建警告，以便发布通道失败时提供有用证据而不是挂起。(#87839)
## 2026.5.28
### Highlights
- Agent and Codex runtime recovery is steadier: subagents keep cwd/workspace separation, hook context stays prompt-local, session locks release on timeout abort, stale restart continuations are avoided, and Codex app-server/helper failures no longer tear down shared runtime state. (#87218, #86875, #87409, #87399, #87375)
- Channel delivery and session identity got safer across outbound plugin hooks, Matrix room ids, iMessage reactions/approvals, Slack final replies, Discord recovered tool warnings, WhatsApp profile auth roots, Telegram polling, and Microsoft Teams service URL trust checks. (#73706, #75670, #87366, #87451, #87334, #82492, #83304, #87160)
- Mobile and chat surfaces got a broader refresh: the iOS Pro UI, Gateway chat transport, onboarding, Talk permissions, WebChat reconnect delivery, and session picker behavior now preserve more state across reconnects and empty searches. (#87367, #87531, #87682)
- Browser, channel, and automation inputs are stricter: Browser tool timeouts, viewport/tab indices, Gateway ports, cron retry handling, Discord component ids, schema array refs, Telegram callback pages, and channel progress callbacks now reject malformed values earlier and preserve the intended delivery context. (#82887)
- Provider, media, and document coverage expands with Claude Opus 4.8, Fal Krea image schemas, NVIDIA featured models, MiniMax streaming music responses, encrypted PDF extraction, voice model catalogs, GitHub Copilot agent runtime support, and a Codex Supervisor plugin path for delegated Codex workflows. (#87845, #87890, #80775, #84764, #87751, #87794)
- CLI, auth, doctor, and provider paths fail faster and recover more clearly: malformed numeric/version options are rejected, workspace dotenv provider credentials are ignored, OAuth and local service startup requests are bounded, legacy `api_key` auth profiles migrate to canonical form, and restart guidance is actionable. (#87398, #86281, #87361, #83655, #87559)
- Plugin and Gateway hot paths do less repeated work while preserving cache correctness for install records, config JSON parsing, tool search catalogs, session stores, manifest model rows, auto-enabled plugin config, browser tokens, and viewer assets. (#86699)
- Release, QA, and E2E validation now bound more log, artifact, harness, and cross-OS waits so failing lanes produce proof instead of hanging or false-greening.
### Changes
- Status: show active subagent details in status output.
- Diffs: split the default language pack and expand default Diffs language coverage while keeping the host floor aligned. (#87370, #87372) Thanks @RomneyDa.
- ClawHub: add plugin display names plus skill verification and trust surfaces. (#87354, #86699) Thanks @thewilloftheshadow and @Patrick-Erichsen.
- iOS: refresh the dev app with Pro Command, Chat, Agents, and Settings tabs wired to gateway sessions, diagnostics, chat, and realtime Talk. (#87367) Thanks @Solvely-Colin.
- Docs: clarify Codex computer-use setup, paste-token stdin auth setup, macOS gateway sleep troubleshooting, native Codex hook relay recovery, container model auth, install deployment cards, device-token admin gating, CLI setup flow compatibility, and backport targets. (#87313, #63050, #87685) Thanks @bdjben, @liaoandi, and @thewilloftheshadow.
- PDF/tools: use ClawPDF for PDF extraction, support encrypted PDF extraction, and surface MCP structured content in agent tool results. (#87670, #87751)
- Providers: add Claude Opus 4.8 support, Fal Krea image model schemas, NVIDIA featured model catalogs, MiniMax streaming music responses, and provider-backed voice model catalogs. (#87845, #87890, #80775, #84764, #87794) Thanks @eleqtrizit and @vincentkoc.
- Codex/GitHub: add the GitHub Copilot agent runtime and the Codex Supervisor plugin package.
- Discord: show commentary in progress drafts so live Discord runs expose useful in-progress context. (#85200)
- Plugin SDK: add a reply payload sending hook for plugins that need to deliver channel-owned replies and flatten package types for SDK declarations. (#82823, #87165) Thanks @RomneyDa.
- Policy: add policy comparison, ingress-channel conformance, and sandbox-posture conformance checks. (#85572, #85744, #86768)
### Fixes
- Agents: fall back to local config pruning when the optional `agents delete` Gateway probe cannot authenticate, so offline installs can still delete agents without removing shared workspaces.
- Tighten phone-control mutation authorization [AI]. (#87150) Thanks @pgondhi987.
- Clarify directive persistence authorization policy [AI]. (#86369) Thanks @pgondhi987.
- Agents/Codex: keep spawned agent cwd/workspace state separated, keep hook context prompt-local, release session locks on timeout abort and runtime teardown, avoid session event queue self-wait, clean up exec abort listeners, stream assistant deltas incrementally, recover raw missing-thread compaction failures, preserve shared app-server state across startup or helper failures, keep native hook relay alive across restarts and prune stale bridge files, keep Claude live tool progress visible for watchdog recovery, suppress abandoned requester completion handoff, route workspace memory through tools, resolve Codex runtime models first, report quarantined dynamic tools, format `skills` command output, and bound compaction/steering retries. (#87218, #86875, #86123, #87399, #87375, #72574, #87383, #87400, #83022, #87671, #87738, #87747, #87706, #87546, #87541) Thanks @mbelinky, @Alix-007, @luoyanglang, @yetval, @sjf, and @joshavant.
- Channels: thread canonical session keys into outbound hooks, preserve Matrix room-id case, keep fallback tool warnings mention-inert, retain delivered Slack final replies during late cleanup, continue iMessage polling after denied reactions, suppress duplicate native exec approvals, preserve Telegram SecretRef prompt config and polling keepalives, preserve WhatsApp profile auth roots, QR display, document filenames, and plugin hook config, suppress Discord recovered tool warnings, preserve the Discord voice outbound helper, and block untrusted Teams service URLs while keeping TeamsSDK patterns aligned. (#73706, #75670, #87366, #87451, #87465, #87334, #76262, #83304, #82492, #87581, #77114, #86426, #85529, #87160) Thanks @zeroaltitude, @lukeboyett, @xiaotian, @eleqtrizit, @heyitsaamir, @amittell, @liorb-mountapps, @masatohoshino, @bladin, and @giodl73-repo.
- CLI/auth/doctor/providers: reject malformed numeric/timeout/subcommand-version inputs, ignore workspace dotenv provider credentials, wait for respawn child shutdown, bound Codex and GitHub Copilot OAuth/token requests, harden Codex auth probes, warm provider auth off the main thread, honor Codex response timeouts, stop migrating current Claude Haiku 4.5 profiles to Sonnet, bound local service startup, resolve GPT-5.5 without cached catalog, migrate legacy memory auto-provider config, rewrite non-canonical `api_key` auth profiles, and make doctor restart follow-ups actionable. (#87398, #86281, #87361, #83655, #87559, #87719) Thanks @Patrick-Erichsen, @samzong, @giodl73-repo, @alkor2000, @mmaps, and @nxmxbbd.
- Gateway/security/session state: expire browser tokens after auth rotation, scope assistant idempotency dedupe, drain probe client closes, avoid stale restart continuation reuse, preserve retry-after fallbacks and stale rate-limit cooldown probes, bound webchat image and artifact transcript scans, include seconds in inbound metadata timestamps, clear completed session active runs, and evict current plugin-state namespaces at row caps. (#87810, #87833) Thanks @joshavant.
- Config/parsing/network: reject partial numeric parsing, parse provider/Discord retry headers and dates strictly, honor IPv6 and bare IPv6 `no_proxy` entries, canonicalize secret target array indexes, and reject malformed media content lengths, inspected TCP ports, marketplace content lengths, cron epochs, sandbox stat fields, unsafe duration values, empty config path segments, noncanonical schema array refs, unsafe Telegram callback pages, and invalid Teams attachment-fetch DNS targets.
- Browser/input hardening: reject invalid tab indexes, excessive viewport resizes, explicit zero CDP ports, malformed geolocation options, unsafe screenshot or permission-grant timeouts, loose response-body limits, invalid cookie expiries, and non-finite Browser tool delays/timeouts.
- Cron/automation: retry recurring jobs after transient model rate limits before waiting for the next scheduled slot, and preflight model fallbacks before skipping scheduled work. (#82887)
- Auto-reply/directives: respect provider and relayed channel metadata during directive persistence so channel-originated decisions keep their intended context. (#87683)
- WhatsApp: resolve the auth directory from the active profile so profile-scoped WhatsApp installs do not drift to the wrong credential root. (#82492)
- Gateway/session state: clear completed session active runs, avoid cold-loading providers for MCP inventory, cache single-session child indexes, cap handshake timers, and bound preauth, auth-guard, media, transcript, readiness, and port options.
- Channels/replies: preserve channel-owned progress callbacks when verbose output is off, keep group-room progress suppression intact, prefer external session delivery context, escape Discord component id delimiters, force final TUI chat repaints, show Slack reasoning previews, and normalize Discord/Matrix/Mattermost channel numeric options. (#87476, #87423)
- Agents/tool args: harden smart-quoted argument repair for edit arrays and exact escaped arguments so model-produced tool calls recover without corrupting valid input. (#86611)
- Providers/agents: preserve seeded Anthropic signatures, preserve signed thinking payloads, concatenate signature-delta chunks, preserve DeepSeek `reasoning_content` replay across tier suffixes, apply OpenRouter strict9 ids to Mistral routes, promote Ollama plain-text tool calls, load NVIDIA featured model catalogs, stream MiniMax music generation responses, and recover empty preflight compaction. (#87593, #87493, #80775, #84764) Thanks @eleqtrizit.
- Media/images: skip CLI image cache refs when resolving generated images and bound generated video downloads so stale refs and slow providers fail cleanly. (#87523)
- File transfer: handle late tar stdin pipe errors after archive validation or unpacking has already settled.
- Performance: trust install-record caches between reloads, prefer native JSON parsing, reuse unchanged tool-search catalogs, skip unchanged store serialization, add precomputed session patch writers, reduce store clone allocations, cache manifest model catalog rows and auto-enabled plugin config, avoid full session snapshots for entry reads, defer configured Slack full startup, prefer bundled plugin dist entries, and slim current metadata identity caches. (#87760)
- Docker/release/QA: package runtime workspace templates, stream cross-OS served artifacts, preserve sparse Crabbox run artifacts, isolate npm plugin installs per package, reject incompatible package plugin API installs, bound OpenClaw instance logs, plugin gauntlet relay logs, MCP channel buffers, kitchen-sink scans, agent-turn assertions, and release scenario logs, and keep release/google live guards current. (#87647, #87477) Thanks @rohitjavvadi.
- Release/CI: bound manual git fetches, ClawHub verifier responses, ClawHub owner metadata, Parallels limits, startup/test/memory budget parsing, and diffs viewer build warnings so release lanes fail with useful proof instead of hanging. (#87839)