read_file 的 Tool Schema 新增 `pages` 和 `format` 参数：PDF 默认逐页渲染为图像，最多自动读取 10 页；更大的 PDF 可指定最多 20 页，或选用文本提取。该契约让 Agent 能按文档规模选择页面范围和视觉或文本读取方式，减少大文档读取负担，也保留图表等版面信息。另有 monitor 使用说明补充 Python 输出需关闭缓冲，以便监控任务及时收到输出。
动态 /loop 的 Runtime Prompt 更新了 ScheduleWakeup 调度规则：Harness 可追踪的后台任务完成后会自动重新唤醒，因此改为设置 1200 秒以上的后备唤醒；只有 CI、部署等 Harness 无法通知的外部任务才按状态变化速度轮询。此机制旨在减少冗余唤醒，同时将短间隔轮询保留给外部状态，并以缓存窗口为依据选择等待时间。官方发布说明还涉及 Subagent 类型匹配、Plugin 配置诊断、Hook 与设置热重载，以及后台服务和平台可靠性修复；Runtime Prompt 同时扩展了 Fast mode 的 Opus 型号范围。
对话消息组装流程新增 system-reminder 消息，在用户请求前提供可用 Skill 的名称、用途、触发条件和路径，随后仍以普通 user 消息承载请求。这让 Agent 可在处理任务前识别适用 Skill；当前捕获的 Tool 数量仍为 23，且 Tool Schema 比较显示没有变化。此处观察到的是 Runtime Prompt 消息结构变化，未提供实现代码或 Static Prompt 差异。
Context management 现在说明长对话会被总结，并将摘要与剩余 Context 带入下一个 Context window，使 Agent 可以跨窗口继续工作，无需提前收尾或中途交接。auto memory 将条目名规范为 kebab-case slug，把类型放入 metadata，并支持用 `[[name]]` 链接相关 Memory，影响后续记录的组织与检索线索。捕获的 Tool Schema 同时移除了 RemoteTrigger；官方发布说明另列出 `/goal`、agent view、Hook 配置和 MCP 行为更新，但没有提供对应源码位置，不能据此推断其具体实现机制。
图片附件发送给模型前不再先缩小，模型收到的图像保留原始尺寸，可能改善对细节的识别。该行为变化由 1.14.48 官方发布说明确认；证据包未提供对应源码位置。
本版调整了 TUI textarea 的按键绑定、Session 活动期间的模型设置持久化，以及 HTTP API Schema 校验失败时的响应契约；用户可继续使用 esc、enter 等键位，模型变更更可靠地保留，校验错误返回可读的 400 响应。Scout 可预先物化配置的参考仓库以供搜索，大图附件则在发送前按可配置尺寸限制自动缩放；TUI 文件和目录路径优先相对 Session 目录显示。证据包含官方发布说明，但没有对应代码变更样本，因此实现位置仅能定位到发布说明描述的功能边界。
Plan Mode 的 Subagent 现在不能绕过父 Agent 的 deny 规则，收紧了父子执行之间的权限边界。版本还修复旧 Session 数据加载、MCP 工具发现和 HTTP API 查询参数契约问题，并内置 customize-opencode Skill，降低配置编辑导致启动失败的风险。Runtime Prompt 与 Tool Schema 的相邻版本捕获相同；源码变更位置未提供，因此具体实现路径无法从本 packet 确认。
本版本修复了多处局部兼容性与可靠性问题：Read Tool 权限规则按相对 Workspace 的路径匹配，旧迁移 Session 的 diff 缺少文件详情或 patch 时也能加载；SDK 错误处理保留服务端消息和响应体。另修正模型状态识别、Workspace 路由参数、启动错误汇总及 Plugin 行为，减少配置、Session、TUI 和扩展使用中的故障。Runtime Prompt 与 Tool Schema 相邻比较相同；证据未提供 Static Prompt 或源码改动样本。
升级路径调整了 `time_used` 字段的加入方式，以处理已有 Workspace 的升级失败。该修复针对存量数据兼容性，减少新增字段导致升级中断的情况。
Provider 与配置 API 在 auth loader 为 Provider 加入非 JSON 选项时仍保持响应可用；ACP 更新和 Session 回放则纳入工具图片附件，避免相关图像内容在这些输出路径中遗漏。前者对应 API 响应兼容性修复，后者扩展了 ACP 与回放中的附件传递行为。Runtime Prompt 与 Tool Schema 相邻版本相同；没有可用的 Static Prompt 比较。
版本说明新增 Scout Agent，用于仓库研究、文档查找和依赖源码检查；同时加入适配器 Workspace 自动发现与注册，以及大型非流式 HTTP API 响应压缩，扩展了仓库探索和 Workspace 接入路径。HTTP API 的认证、参数校验和错误响应也有调整，目标是让拒绝结果和校验错误按结构化契约返回。npm shim 的信号转发、分离 Session 归属和工具排序则分别调整了 CLI 生命周期、Session 恢复归属和运行间列表稳定性。Runtime Prompt 相邻版本只有 Messages 区域的一处空行删除，Tool Schema 无增删改；Static Prompt 比较不可用。官方说明未提供代码样本或文件路径，因此实现位置只能按其描述的模块和契约概括。
可观察到的 Runtime Prompt 差异仅是计费请求头中的版本标识从 2.1.137.827 改为 2.1.138.354；工具集合和 System Prompt 的其余内容没有显示功能性变化。官方发布说明仅称“Internal fixes”，未给出具体机制或代码位置，因此无法据此说明内部修复如何影响行为。
System Prompt 删去 `skill` Tool Definition，并弱化强制使用 Todo 的要求；工具契约同步移除 `skill`，修改 `task`、`todo_write` 与 `run_terminal_cmd`。这让可调用工具面缩小，并将复杂任务规划从一律要求调整为按任务复杂度选择；代码实现位置无法从本包确认。Runtime Prompt 对比显示 System Prompt 和 Tools 有修改，未见工具新增。
新增 task Tool，使 Agent 可把多步骤任务交给 general-purpose、explore 或 plan Subagent；Tool Schema 提供 capability_mode、isolation、fork_context 与 resume_from 等选项，影响任务委派、Context 传递及 Workspace 隔离方式。System Prompt 同步加入按搜索范围选择直接工具或 Subagent 的规则，并要求在适合时避免重复研究、为子任务补足背景。此次 Runtime Prompt 差异还移除了“修复 linter 错误”的明确要求；发布说明为空，未提供可用于交叉确认的官方代码概览。
官方发布说明称修复了 Windows 上 VS Code Extension 无法激活的问题，行为影响是该平台上的扩展可恢复激活。证据未提供实现代码位置或修复机制，Runtime Prompt 的唯一差异是账单头中的版本标识更新。
本版把 `codex remote-control` 加为启动无头远程 app-server 的入口，并为大型 Thread 提供分页及 unloaded、summary、full 三种 turn item 视图；客户端可按需读取 Session 内容。Plugin 详情开始展示 bundled hooks，分享接口提供链接元数据和 discoverability 控制；`view_image` 则通过所选 Environment 解析文件，扩展多环境 Session 的图像访问路径。官方代码概览还列出基于操作记录的 turn diff 跟踪和经 ThreadStore 处理的摘要、重命名、恢复与分叉路径；Runtime Prompt 与 Tool Schema 的相邻版本捕获相同，不能据此推断这些代码或产品行为没有变化。
Auto Mode 新增 `settings.autoMode.hard_deny`，使分类器规则能够无条件阻止操作，不受用户意图或 allow 例外影响。Session 与 MCP 生命周期也有多项修复：并发 OAuth 刷新不再丢失 refresh token，VS Code、JetBrains 和 Agent SDK 中配置的 MCP Server 不再于 `/clear` 后消失，`--resume` / `--continue` 也能查找路径含下划线的 Session。发布说明还涵盖 Plan Mode 写入限制、Hook 缓存清理、Context 恢复后的环境变量及多项 Terminal 和界面可靠性修复；Runtime Prompt 差异仅为版本计费头变更，Tool Schema 未变化，Static Prompt 对比不可用，且未提供代码变更样本。
本版本调整了 grep、list_dir 和 read_file 的工具说明文案，代码落点仅能从 Runtime Prompt 中观察到 Tool Schema 描述文本；未见参数、工具数量或能力契约变化，因此可观察到的行为影响有限。官方发布说明为空，且没有 Static Prompt 证据。
本版在命令和 Tool Call 分发、Active Memory 管理、Codex 审批及 Telegram 授权路径中强化权限检查；发布说明还记录了 Context 缓存失效、Session 归档与 transcript 持久化、Plugin 安装恢复等可靠性调整。外部可观察契约也有变化：Cron JSON 输出计算后的状态，channels list 默认只列渠道，投递无适配器结果时明确报告失败；这些变化能减少权限误用和状态误判，并让外部工具更容易发现执行问题。Runtime Prompt 与 Tool Schema 相邻版本一致；Static Prompt 比较不可用，且官方代码变更样本未提供，因此具体源码落点无法从本 packet 核验。
工作树创建现在由 `worktree.baseRef` 决定分支基准：默认 `fresh` 从远端默认分支创建，设为 `head` 则保留当前本地 HEAD 的提交；机制落在 EnterWorktree、`--worktree` 与 Agent 隔离工作树的基准选择上，会改变新工作树包含哪些未推送提交。官方发布说明还列出 managed settings 策略合并、Hooks 获得 effort Context，以及凭据刷新、远程中断和 Skill 发现等可靠性修复。Runtime Prompt 捕获差异明确了 EnterWorktree 的基准契约；未提供 Static Prompt 或代码变更样本。
System Prompt 将 Grok Build 定义为非交互式软件工程 Agent，并围绕任务管理、Plan Mode、代码修改和完成前验证规定工作流程；23 个工具覆盖文件操作、Terminal、搜索、任务调度及多模态生成等能力。由此形成从理解请求、规划到执行和核验的明确约束，工具契约也提供了可调用的操作入口。
Plugin 管理增加 Workspace 共享、访问控制、远程 bundle 同步及 marketplace 升级流程，Hook 生命周期扩展到压缩前后并可注入 PreToolUse Context；对应变化落在 Plugin 管理、Hook 处理和相关 app-server 接口。Memory MCP 增加分页、窗口化多查询、规范化匹配与路径限制，Thread 历史逐步迁移到进程级 ThreadStore；这些机制分别改善共享管理、检索精度与历史读取的一致性。Linux 发布包加入独立打包的 bwrap，Windows Sandbox 与 exec policy 也有针对命名管道、ConPTY 和规则解析的修复。Runtime Prompt 与 Tool Schema 的相邻比较相同；Static Prompt 比较不可用。
Cronjob Tool Schema 新增 `no_agent`，允许调度器直接运行脚本并按 stdout 决定是否向用户发消息；这把固定格式的定时通知从每次都启动 Agent 的路径中分出。`skill_manage` 增加 `absorbed_into`，为删除 Skill 标记合并去向或明确修剪；`write_file` 的说明也纳入写后语法检查约定。官方发布说明另列出持久 Kanban、跨轮次 `/goal`、Checkpoint v2、Thread 恢复及多项安全修复，但当前证据未附相应代码概览，不能据此分析其具体实现位置。
官方发布说明记录仓库迁至 `earendil-works/pi-mono`、包作用域改为 `@earendil-works/*`；这是仓库与包引用的调整。当前捕获的 System Prompt 则规定 Agent 通过 bash、read、edit、write 操作文件，并约束 edit 的精确匹配与多位置编辑方式，给出直接的工具使用行为契约。由于没有前一版本基线，这些工具和约定只能描述为当前捕获内容，不能判定为本版本新增。
Session 迁移到其他 Workspace 时现在可携带未提交文件变更；ACP 客户端加载 Session 时恢复最近使用的模型、模式和 effort，并可正常关闭 Session，改善了跨 Workspace 与客户端的状态连续性。桌面本地服务器移至独立 utility process，以改善应用启动和关闭的可靠性；格式化器也恢复了对 stdout、stderr 输出的处理。当前 Runtime Prompt 与 Tool Schema 相邻比较一致；没有可用的 Static Prompt 比较，因此这些机制变化来自官方发布说明，未观察到对应源码样本。
本版调整 Core 的配置解析、Session 与 Workspace 路由、消息回放和 Context 呈现，并修复服务端中间件顺序、网络入口重入及 Provider 选项适配。影响是远程配置、浏览器客户端、跨 Workspace 操作和部分模型请求能按预期工作，已有对话内容与编辑器选择 Context 在发送或压缩时更稳定。TUI 和 Desktop 也修复了模型刷新、启动同步及退出更新等局部行为；Runtime Prompt 与 Tool Schema 相邻版本相同，Static Prompt 比较不可用。
Bash 子进程现在通过 `CLAUDE_CODE_SESSION_ID` 获取与 Hook `session_id` 相同的 Session 标识，便于两种执行入口关联同一 Session。Terminal 新增退出全屏渲染的环境开关；外部 SIGINT 会执行优雅关闭，并为恢复 Session 提示 `--resume`。此外，恢复时修正 Plan Mode 权限参数与状态应用，并处理工具错误截断造成的损坏文本；这些更新改善 Session 与 Terminal 可靠性，但现有证据没有显示主控制流或权限边界发生实质改变。
本版回退 `doctor --fix` 对有效 `openai-codex/*` 路由的改写，避免 OAuth 配置被错误切到 `openai/*` API Key 路由；同时在请求进入原生 `fetch` 或 `Headers` 前去除第三方 symbol metadata，并为超时后的 guarded dispatcher 清理设定边界。前者影响模型路由恢复，后两者影响 Plugin 请求兼容性和 Gateway Tool lane 的超时回收。Runtime Prompt 与 Tool Schema 相邻比较未见变化；Static Prompt 比较不可用。
视频生成 Tool 的 `aspectRatio` 与 `resolution` 参数从列举固定值改为接受 Provider 专属值；官方说明补充 OpenClaw 会按 Provider 规范化或忽略不支持的值。发布说明还指出会将 `720P` 规范化为 MiniMax 支持的 `768P`，并在 Gemini 视频请求中停止发送 `generateAudio`，以提高模型参数差异下的兼容性。
该版本修复两处 Host/SDK 与兼容性问题：VS Code Extension 打包 SDK 中的 `createRequire` polyfill 使用硬编码构建路径，导致 Windows 上无法激活；Mantle endpoint 请求缺少 `x-api-key`，导致认证失败。修复后，Windows 扩展可正常激活，Mantle endpoint 可携带认证所需的 API Key。源码位置未提供；Runtime Prompt 仅更新版本标识，Tool Schema 无变化。
Plugin 可通过 `--plugin-url` 从 URL 获取 ZIP，并支持 `skillOverrides` 的三种可见性策略；Plugin 清单将 `themes`、`monitors` 放入 `experimental`，顶层声明仍可用但会收到校验警告。发布说明还调整 Terminal 输出同步、包管理器后台更新与重启提示，以及 Gateway 模型发现的 opt-in 开关；修复 OAuth 刷新竞争导致运行中 Session 全部登出的故障。Runtime Prompt 将捕获模型更新为 Opus 4.7（1M context），Plan Mode 的探索指引明确列出 `find`/Glob、`grep`/Grep 和 Read；Tool Schema 统计显示 Bash、EnterPlanMode 有修改，但差异未给出其具体定义变化。
桌面端现在遵循 `HTTP_PROXY` 等相关环境变量，并在无法读取已存储值时返回 `null`，避免读取失败直接中断调用。两项变化都落在桌面端的 Proxy 配置和存储读取边界，分别改善网络配置适配与异常回退行为；现有证据未提供具体源码位置。
本版本修复两处连接兼容性问题：默认 CSP 现在允许嵌入式 UI 向任意 `connect-src` 来源发起请求，桌面端 HTTPS 连接则信任系统 CA 证书。前者放宽 UI 的网络连接策略，后者接入系统证书信任；影响分别是嵌入式 UI 可连接更多来源，以及桌面 HTTPS 请求可使用系统 CA 验证。
`pi-embedded-runner` 在自动压缩重试后增加重复 Tool Call 循环守卫；当同一 `(tool, args, result)` 达到配置次数时终止运行，避免 Context 溢出后压缩仍无法打断循环。Twilio 实时语音桥接加入节奏化音频发送、背压缓冲和有界队列，过载时关闭实时流；Plugin 热路径则复用 Workspace 兼容的元数据快照，减少冷扫描。另有运行时 Context 与普通聊天 System Prompt 分离以恢复续聊缓存复用，以及容器和浏览器注册表改为按运行时分片存储等变化。
Core 的任务取消现在会连带取消子任务 Session，明确了父任务与子任务的取消生命周期契约。Session 也可迁移到其他 Workspace 或返回本地项目；v2 Session 渲染改进了 Tool 状态、压缩摘要和耗时显示。官方说明未提供对应源码位置；Runtime Prompt 与 Tool Schema 相邻比较未见变化，Static Prompt 比较不可用。
本版本修复 Session diff 对补丁边界的保留，使文件内容中包含 `diff --git` 文本时，diff 仍能正确渲染。官方说明确认了修复目标，但未提供实现位置或具体处理机制。
发布说明列出 PTY 连接票据和 v2 Session failure events：前者改善经过认证的 Terminal WebSocket 连接，后者让客户端能检测并展示失败运行。说明还列出防止大 diff 使用无界内存、避免 Desktop Terminal 恢复失败后反复重连等改进；证据未提供这些改动的源码路径或实现样例。Runtime Prompt 对 bash 工具的改动只是大小写变化，工具数量与增删情况未变。
本版扩展 `--plugin-dir` 的加载入口以支持 ZIP，并让 `--channels` 支持 API key 认证；SDK host 还会收到持久的 `localSettings` 建议，使 Bash 权限提示中的“Always allow”写入 `.claude/settings.local.json`。子进程启动时不再继承 `OTEL_*`，`EnterWorktree` 从本地 HEAD 创建分支以保留未推送提交；这些改动分别影响 Plugin 分发、认证与授权配置、子进程环境隔离和工作树状态。Runtime Prompt 变化只直接显示 Read 的编辑后重读规则及 RemoteTrigger create/update 的结果摘要契约；没有可用的 Static Prompt 或代码样本证据定位实现文件。
此 hotfix 调整 Plugin 安装扫描器对编译 bundle 的判定：当 `process.env` 访问和常规 API 发送只出现在 bundle 中相距较远的位置时，不再因此阻止官方内置 Plugin 包安装。发布说明将其列为 Plugins/security 修复，并说明该版本发布为 `openclaw@2026.5.3-1`，使用 beta dist-tag。证据未提供对应源码位置或实现细节。
本版在 Runtime Prompt 与 Tool Schema 中加入 browser 控制，以及节点文件读写、目录枚举和 Memory 检索工具；文件传输工具要求节点命令许可与逐节点路径策略，目录传输另设 16 MB 上限。官方代码概览还显示 Gateway 延迟加载、无效配置启动时 fail closed、Sandbox 与浏览器注册表按运行时分片，以及 `/steer` 对当前运行提供独立于队列的引导能力，涉及执行、Session 状态与配置恢复。Static Prompt 当前不可用；官方发布说明和代码概览属于独立证据层，未据此推断未观察到的实现细节。