——
OpenClaw v2026.5.12-beta.7 发布：5大核心改进与ACP故障转移详解
OpenClaw 最新 Beta 版本 v2026.5.12-beta.7 正式发布，本次更新聚焦插件架构优化、运行时可靠性与安全加固三大方向。无论你是构建企业级 AI Agent 工作流，还是部署自托管的自动化网关，这 5 个关键改进都将直接影响你的生产环境稳定性。
本文将逐一解析新功能的技术细节，并提供可直接落地的配置代码。
—
一、Amazon Bedrock 插件化：告别臃肿依赖
核心变化
AWS SDK 依赖已从 OpenClaw 核心包中移除。现在，只有当你显式安装 bedrock 或 bedrock-mantle 提供商插件时，才会拉取相关依赖。
为什么重要？
此前，即使你不使用 AWS 服务，核心安装也会捆绑 50MB+ 的 AWS SDK。这在容器化部署（Docker/Kubernetes）中显著增加了镜像体积和启动时间。
迁移操作
全新安装（无 AWS 依赖）
npm install -g @openclaw/cli
按需添加 Bedrock 支持
openclaw plugin install provider-bedrock
openclaw plugin install provider-bedrock-mantle
验证依赖瘦身
对比安装前后
du -sh node_modules/@aws-sdk # 安装插件后才会出现
—
二、ACP 故障转移：多后端高可用配置
ACP（Agent Control Protocol） 新增 acp.fallbacks 配置，允许在主后端不可用时自动切换备用运行时，且在输出产生前完成切换，避免用户看到中断或错误片段。
配置示例
openclaw.config.yaml
acp:
runtime: primary-backend
fallbacks:
- name: backup-gpu-pool
runtime: bedrock-runtime-us-west-2
condition: "error_rate > 5% or latency_p99 > 3000ms"
- name: cold-standby
runtime: openai-gpt4o-fallback
condition: "primary_unavailable > 30s"
故障转移触发条件
| 条件类型 | 说明 | 适用场景 |
|———|——|———|
| error_rate | 错误率阈值 | API 限流或模型降级 |
| latency_p99 | P99 延迟 | 网络波动或后端过载 |
| primary_unavailable | 主后端失联时长 | 区域级故障 |
> 注意：故障转移决策在首个 token 生成前完成，确保用户无感知切换。
—
三、Telegram Bot 稳定性：隔离工作进程
问题背景
此前，当 OpenClaw 主事件循环阻塞（如复杂工作流执行）时，Telegram Bot API 轮询会中断，导致消息丢失。
解决方案
新版本将消息入口（ingress）移至独立工作进程，并引入本地持久化队列（durable local spool）：
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Telegram API │────▶│ Isolated Worker │────▶│ Local Spool │
│ (长轮询) │ │ (独立进程) │ │ (持久化队列) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│
▼
┌─────────────────┐
│ Main Event Loop │
│ (主业务逻辑) │
└─────────────────┘
环境变量配置
.env
OPENCLAW_TELEGRAM_ISOLATED_WORKER=true
OPENCLAW_TELEGRAM_SPOOL_PATH=/var/spool/openclaw/telegram
OPENCLAW_TELEGRAM_SPOOL_MAX_SIZE=100MB
—
四、安全加固：Windows 沙箱路径拦截
漏洞修复
Windows 环境下，沙箱现在会拦截 %USERPROFILE% 下的敏感路径绑定，即使 HOME 环境变量指向其他位置。
被拦截的凭证路径
%USERPROFILE%\.codex
%USERPROFILE%\.openclaw
%USERPROFILE%\.ssh
%USERPROFILE%\.aws
Docker 部署建议
Dockerfile
FROM openclaw/openclaw:latest
显式设置非敏感 HOME（额外防护层）
ENV HOME=/tmp/openclaw-home
运行非特权用户
USER 1000:1000
—
五、UI 体验：自动滚动模式持久化
WebChat/Control UI 新增自动滚动行为选择器，用户偏好现在会持久化存储：
| 模式 | 行为 | 适用场景 |
|—–|——|———|
| near-bottom | 接近底部时自动滚动（默认） | 常规对话 |
| always-follow | 始终跟随流式输出 | 实时监控/日志 |
| manual | 完全手动，显示”新消息”按钮 | 需要回顾历史上下文 |
前端配置
// 通过 localStorage 查看当前设置
localStorage.getItem('openclaw:autoscroll:mode');
// 返回值: "near-bottom" | "always-follow" | "manual"
—
六、其他值得关注的修复
| 修复项 | 影响 | 致谢 |
|——-|——|——|
| CLI 插件帮助优化 | openclaw plugin --help 启动速度提升 3-5 倍 | – |
| 网关会话历史同步 | 修复 SSE 历史状态追加错误 | @samzong |
| 媒体获取内存优化 | HEAD/204 响应跳过缓冲区分配 | @shakkernerd |
| 提供商认证安全 | 停止从宽泛正则匹配环境变量 | @sallyom |
| Codex 迁移输出格式 | 去除冗余句点，提升可读性 | @sjf |
—
常见问题 FAQ
Q1: 我已在使用 Amazon Bedrock，升级后需要做什么？
A: 运行以下命令补装插件即可，配置无需变更：
openclaw plugin install provider-bedrock provider-bedrock-mantle
Q2: ACP 故障转移会影响对话连续性吗？
A: 不会。故障转移在首个 token 生成前完成，用户侧表现为”响应稍慢”而非”回答中断”。上下文（memory）会通过 OpenClaw 的会话层保持。
Q3: Telegram 独立工作进程会增加资源消耗吗？
A: 约增加 50-80MB 内存占用，但消除了消息丢失风险。可通过 OPENCLAW_TELEGRAM_ISOLATED_WORKER=false 回退到旧模式（不推荐生产环境）。
Q4: 如何验证沙箱路径拦截是否生效？
A: 在 Windows 执行：
openclaw sandbox test --bind %USERPROFILE%\.ssh
预期输出: Error: EACCES: path blocked by sandbox policy
Q5: 这个版本适合生产部署吗？
A: Beta.7 已修复多个生产环境关键问题（Telegram 稳定性、网关状态同步），建议非关键业务先行验证，关键业务等待 RC 版本。
—
总结与下一步
OpenClaw v2026.5.12-beta.7 的核心价值在于模块化架构与运行时韧性：
1. 按需安装减少攻击面和部署体积
2. ACP 故障转移保障 AI Agent 高可用
3. 进程隔离解决长期存在的消息可靠性问题
建议操作：
- 开发环境：立即升级验证新功能
- 生产环境：等待 RC 后配合蓝绿部署
- 关注 OpenClaw 官方文档 获取 GA 版本通知
—
相关阅读
—
参考来源
