OpenClaw v2026.5.12-beta.7 发布：5大核心改进与ACP故障转移详解

——

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 版本通知

—

相关阅读

—

参考来源