——
OpenClaw v2026.5.25-beta.1 发布：iMessage 修复、Windows 原生支持与 12 项关键改进
一句话总结：本次更新重点修复了 iMessage 附件读取和重复监听问题，同时为 Windows 原生开发和 Alpine Linux 部署提供了完整支持，让 OpenClaw 跨平台体验更加稳定。
如果你在使用 OpenClaw 处理 iMessage 数据、在 Windows 上进行插件开发，或在 Alpine 容器中部署服务，这篇文章将帮你快速了解所有关键改进和升级建议。
—
Beta 1 紧急修复：iMessage 与 Codex 稳定性
iMessage 附件路径策略修复（#86569）
此前，存储在 ~/Library/Messages/Attachments 的 iMessage 附件会被错误地拒绝为 path-not-allowed。本次更新将附件根目录纳入 image tool 的入站路径策略，支持通配符路径匹配：
// 现在支持的配置示例
{
"channels": {
"imessage": {
"accounts": ["default"],
"attachmentRoots": ["~/Library/Messages/Attachments/**"]
}
}
}
影响：使用 iMessage 通道进行媒体处理的 AI Agent 工作流现在可以正常读取本地附件，无需手动移动文件。
重复账户监听去重（#86705）
当 channels.imessage.accounts 同时包含 default 和指向同一本地源的命名账户时，系统会启动重复的 imsg rpc 进程，导致入站回复重复发送。
修复后：重复账户仍可用于出站发送和状态查询，但监听进程自动去重，避免资源浪费和消息重复。
Codex 沙盒路径映射优化
在跨主机与沙盒环境映射工作区指令文件时，Codex 现在会保留原始的引导路径样式，确保容器内外路径一致性：
示例：工作区路径映射
host_path: /home/user/project
sandbox_path: /workspace
修复后：指令文件中的相对路径正确解析
—
2026.5.25 核心更新详解
1. Alpine Linux 原生安装支持
OpenClaw 现在原生支持 musl Linux 发行版（如 Alpine），安装器会自动检测并使用 apk 包管理器安装 Node.js、npm 和 Git，而非下载不兼容的 glibc 版本：
Alpine Linux 安装命令（推荐）
apk add nodejs npm git
npm install -g openclaw
验证安装
openclaw --version
关键改进：
- 修复
node:sqlite模块加载失败问题 - 避免 NodeSource 包管理器路径的兼容性问题
- 安装器正确识别 musl shell 环境
2. Windows 原生开发完整支持
本次更新解决了 Windows 平台的 6 个关键问题，实现真正的原生开发体验：
| 问题场景 | 修复方案 |
|———|———|
| 网关、TUI、Docker-all 启动失败 | 跨平台启动器处理环境变量覆盖 |
| Discord opus 原生模块安装 | 可选安装器入口点兼容 |
| 代码格式化工具 | 生成模块格式化跨平台支持 |
| Vitest 高并发测试 | Node 包装器运行 test:max |
| 串行测试执行 | Node 包装器运行 test:serial |
| 导入诊断收集 | Node 包装器处理导入时序 |
Windows 上现在可以正常运行
npm run test:max # 高并发测试
npm run test:serial # 串行测试
npm run gateway # 启动网关服务
3. 插件开发体验优化
#### 本地插件源码开发（无需编译）
链接的本地插件路径现在可以直接探测 TypeScript 源码入口，无需预编译输出：
// package.json - 插件配置
{
"name": "my-local-plugin",
"main": "src/index.ts", // 直接指向 TypeScript 源码
"openclaw": {
"linked": true
}
}
适用场景：Windows 原生环境下的插件迭代开发，保存即生效。
#### CLI 构建输出隔离
源码检出构建的输出现在路由到 stderr，避免污染 --json 标准输出：
安全获取 JSON 输出
openclaw status --json # 不再包含构建日志
4. 性能优化：Agent 模型回退缓存
Agent 性能提升：缓存基于 manifest 的 CLI 提供商描述符和回退提供商解析结果，模型回退重试时避免重复的捆绑运行时扫描：
// 内部优化：缓存策略
const providerCache = new Map();
// 插件重载时自动失效，保证配置更新生效
效果：复杂工作流中的模型切换延迟显著降低，同时保持配置热更新能力。
5. 测试基础设施加固
| 测试场景 | 修复内容 |
|———|———|
| 变更检测扫描 | 预过滤冲突标记，干净运行避免全仓库读取 |
| RPC 就绪探测 | 重试瞬态回环 HTTP 重置，Windows 稳定性提升 |
| 配置路径断言 | 标准化 Vitest 配置路径，Windows 路径兼容 |
现在可靠的测试命令
npm run test:changed:max # 变更文件高并发测试
npm run kitchen-sink # 完整 RPC 走查
6. 构建优化：控制 UI 代码分割
大型构建时依赖被拆分为稳定 chunk，确保 Linux/Docker 安装和包构建低于应用 chunk 警告阈值，提升容器镜像构建成功率。
—
升级指南
推荐升级路径
1. 备份当前配置
cp -r ~/.openclaw ~/.openclaw.backup
2. 更新到最新版本
npm update -g openclaw
3. 验证版本
openclaw --version # 应显示 v2026.5.25-beta.1 或更高
4. 清理插件缓存（推荐）
openclaw plugins reload
Alpine/Docker 用户特别说明
优化的 Alpine Dockerfile
FROM node:20-alpine
RUN apk add --no-cache git
RUN npm install -g openclaw@2026.5.25-beta.1
iMessage 通道配置检查
验证附件路径策略
openclaw channels imessage config --check-attachments
—
常见问题解答 (FAQ)
Q1: 我在 Windows 上开发 OpenClaw 插件，之前需要 WSL，现在还需要吗？
不需要了。v2026.5.25-beta.1 完整支持 Windows 原生开发，包括 TypeScript 源码直接加载、测试运行和网关启动。建议升级后移除 WSL 依赖，直接使用 PowerShell 或 CMD。
Q2: Alpine Linux 部署时遇到 node:sqlite 错误怎么办？
这是 glibc 与 musl 的兼容性问题。请确保使用本版本的安装器，它会自动通过 apk 安装兼容的 Node.js。手动安装时请避免使用 NodeSource 的 setup 脚本。
Q3: iMessage 附件仍然无法读取，如何排查？
首先确认配置中的 attachmentRoots 包含通配符路径，如 ~/Library/Messages/Attachments/**。然后运行 openclaw channels imessage config --check-attachments 验证路径策略。若问题持续，检查 macOS 是否授予 OpenClaw 完全磁盘访问权限。
Q4: 模型回退缓存会影响实时配置更新吗？
不会。缓存设计为插件重载时自动失效，您可以通过 openclaw plugins reload 或重启服务强制刷新。日常配置热更新不受影响。
Q5: 这个版本适合生产环境使用吗？
作为 beta 版本，建议先在 staging 环境验证。关键修复（iMessage 路径、Windows 支持、Alpine 安装）已针对特定场景充分测试。若您的生产环境涉及这些场景，升级收益大于风险。
—
总结与下一步
OpenClaw v2026.5.25-beta.1 的核心价值在于跨平台稳定性的质变——iMessage 数据通道修复、Windows 原生开发闭环、Alpine 容器原生支持，这三项改进显著扩展了 AI Agent 的部署场景。
建议行动：
1. iMessage 用户：立即升级验证附件处理
2. Windows 开发者：尝试原生环境，简化工具链
3. 容器化部署：采用 Alpine 基础镜像减少镜像体积
—
相关阅读
—
参考来源
