### 亮点
- 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 图像 schema、NVIDIA 精选模型、MiniMax 流式音乐响应、加密 PDF 提取、语音模型目录、GitHub Copilot agent 运行时支持以及用于委托 Codex 工作流的 Codex Supervisor 插件路径。（#87845, #87890, #80775, #84764, #87751, #87794）
- CLI、认证、诊断和提供方路径失败更快且恢复更清晰：拒绝格式错误的数值/版本选项，忽略工作区 dotenv 提供方凭据，限制 OAuth 和本地服务启动请求，旧版 `api_key` 认证配置迁移至规范形式，重启指导具有可操作性。（#87398, #86281, #87361, #83655, #87559）
- 插件和 Gateway 热路径减少了重复工作，同时保留了安装记录、配置 JSON 解析、工具搜索目录、会话存储、清单模型行、自动启用插件配置、浏览器令牌和查看器资产的缓存正确性。（#86699）
- 发布、QA 和 E2E 验证现在限制了更多的日志、工件、测试框架和跨操作系统等待时间，以便失败的测试线能够产生证据，而不是挂起或产生错误的通过结果。
### 变更
- 状态：在状态输出中显示活跃子 agent 的详细信息。
- Diffs：拆分默认语言包并扩展默认 Diffs 语言覆盖范围，同时保持宿主基准一致。（#87370, #87372）感谢 @RomneyDa。
- ClawHub：添加插件显示名称以及技能验证和信任表面。（#87354, #86699）感谢 @thewilloftheshadow 和 @Patrick-Erichsen。
- iOS：刷新开发应用，新增 Pro 命令、聊天、Agent 和设置标签页，连接到 gateway 会话、诊断、聊天和实时 Talk。（#87367）感谢 @Solvely-Colin。
- 文档：澄清 Codex 计算机使用设置、粘贴令牌 stdin 认证设置、macOS Gateway 睡眠故障排除、原生 Codex 钩子中继恢复、容器模型认证、安装部署卡片、设备令牌管理权限、CLI 设置流兼容性以及向后移植目标。（#87313, #63050, #87685）感谢 @bdjben, @liaoandi 和 @thewilloftheshadow。
- PDF/工具：使用 ClawPDF 进行 PDF 提取，支持加密 PDF 提取，并在 agent 工具结果中展示 MCP 结构化内容。（#87670, #87751）
- 提供方：新增 Claude Opus 4.8 支持、Fal Krea 图像模型 schema、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` 重放，对 Mistral 路由应用 OpenRouter strict9 ID，提升 Ollama 纯文本工具调用，加载 NVIDIA 精选模型目录，流式传输 MiniMax 音乐生成响应，恢复空的预检压缩。（#87593, #87493, #80775, #84764）感谢 @eleqtrizit。
- 媒体/图像：在解析生成的图像时跳过 CLI 图像缓存引用，并限制生成的视频下载，以便过时的引用和慢速提供方能够干净地失败。（#87523）
- 文件传输：处理归档验证或解包已完成后出现的延迟 tar 标准输入管道错误。
- 性能：在重新加载之间信任安装记录缓存，优先使用原生 JSON 解析，重用未更改的工具搜索目录，跳过未更改的存储序列化，添加预计算的会话补丁写入器，减少存储克隆分配，缓存清单模型目录行和自动启用插件配置，避免为条目读取进行完整会话快照，推迟配置的 Slack 完全启动，优先使用捆绑的插件分发条目，并精简当前元数据身份缓存。（#87760）
- Docker/发布/QA：打包运行时工作空间模板，流式传输跨操作系统服务的工件，保留稀疏的 Crabbox 运行工件，按包隔离 npm 插件安装，拒绝不兼容的包插件 API 安装，限制 OpenClaw 实例日志、插件 gauntlet 中继日志、MCP 频道缓冲区、厨房水槽扫描、agent 轮次断言和发布场景日志，并保持发布/Google 实时守卫最新。（#87647, #87477）感谢 @rohitjavvadi。
- 发布/CI：限制手动 git 获取、ClawHub 验证器响应、ClawHub 所有者元数据、Parallels 限制、启动/测试/内存预算解析以及 diffs 查看器构建警告，以便发布跑道失败时附带有用证据，而不是挂起。（#87839）
### 发布验证
- npm 包：https://www.npmjs.com/package/openclaw/v/2026.5.28-beta.3
- registry tarball：https://registry.npmjs.org/openclaw/-/openclaw-2026.5.28-beta.3.tgz
- 完整性校验：`sha512-S495OQbu67tIExI1cn+rs8wfNI7SY1ksePrt7xnQUGHCWpubvGpqoWKCF/Jf5k/5yfjz3JC+qVD7823IKc42TQ==`
- 发布尝试：https://github.com/openclaw/openclaw/actions/runs/26650757547
- npm 预检：https://github.com/openclaw/openclaw/actions/runs/26648478809
- 完整发布验证：https://github.com/openclaw/openclaw/actions/runs/26648480369
- 性能证据：https://github.com/openclaw/openclaw/actions/runs/26648477398
- 插件 npm 发布：https://github.com/openclaw/openclaw/actions/runs/26650915625
- OpenClaw npm 发布：https://github.com/openclaw/openclaw/actions/runs/26651492551
### 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)
### Release verification
- npm package: https://www.npmjs.com/package/openclaw/v/2026.5.28-beta.3
- registry tarball: https://registry.npmjs.org/openclaw/-/openclaw-2026.5.28-beta.3.tgz
- integrity: `sha512-S495OQbu67tIExI1cn+rs8wfNI7SY1ksePrt7xnQUGHCWpubvGpqoWKCF/Jf5k/5yfjz3JC+qVD7823IKc42TQ==`
- release publish attempt: https://github.com/openclaw/openclaw/actions/runs/26650757547
- npm preflight: https://github.com/openclaw/openclaw/actions/runs/26648478809
- full release validation: https://github.com/openclaw/openclaw/actions/runs/26648480369
- performance evidence: https://github.com/openclaw/openclaw/actions/runs/26648477398
- plugin npm publish: https://github.com/openclaw/openclaw/actions/runs/26650915625
- OpenClaw npm publish: https://github.com/openclaw/openclaw/actions/runs/26651492551