—# OpenClaw 2026.5.12-beta.8 发布：5大核心改进与安装指南
OpenClaw 2026.5.12-beta.8 版本带来了显著的架构优化，核心安装包体积大幅缩减，同时增强了 AI Agent 工作流的稳定性和多平台集成能力。本文将深入解析 5 项关键更新，并提供可直接落地的配置方案。
—
一、核心改进概览
本次更新聚焦于三个方向：依赖精简、稳定性增强和安全加固。以下是值得优先关注的变更：
| 改进领域 | 关键变更 | 影响 |
|———|———|——|
| 依赖管理 | AWS SDK 等外部化 | 核心安装包减小 40%+ |
| 消息流 | 自动滚动模式持久化 | WebChat 体验优化 |
| 故障恢复 | ACP 备用后端机制 | 关键任务可靠性提升 |
| 平台集成 | Telegram 长连接优化 | Bot 稳定性显著改善 |
| 安全沙箱 | Windows 凭证路径加固 | 防止敏感信息泄露 |
—
二、详细功能解析
2.1 依赖外部化：更轻量的核心安装
Amazon Bedrock 和 Bedrock Mantle 提供商包现已从核心安装中分离。这意味着：
基础安装（不再包含 AWS SDK）
docker pull openclaw/openclaw:2026.5.12-beta.8
按需添加 Bedrock 支持
openclaw plugin install provider-bedrock
同理，Slack、OpenShell Sandbox 和 Anthropic Vertex 插件也改为按需安装：
安装 Slack 集成
openclaw plugin install slack
安装 Anthropic Vertex
openclaw plugin install anthropic-vertex
收益：最小化部署场景（如边缘节点或 CI/CD 环境）的镜像体积和启动时间大幅降低。
2.2 WebChat 自动滚动：三种模式自由切换
控制界面新增持久化的自动滚动模式选择器，解决长期困扰用户的滚动行为不一致问题：
| 模式 | 行为 | 适用场景 |
|—–|——|———|
| Near-bottom（默认） | 接近底部时自动跟随 | 常规对话 |
| Always follow | 始终跟随流式输出 | 实时监控 |
| Manual | 关闭自动滚动，使用”新消息”按钮 | 需要回溯历史时 |
配置持久化至浏览器本地存储，刷新页面后设置保留。
2.3 ACP 故障转移：关键任务的可靠性保障
ACP（Agent Control Protocol） 新增 acp.fallbacks 配置，允许为单个 ACP 回合配置备用运行时后端：
openclaw.yaml 配置示例
acp:
fallbacks:
- name: "primary"
backend: "claude-cli"
priority: 1
- name: "backup"
backend: "openai-gpt4"
priority: 2
# 主后端不可用时自动切换
triggerOn: ["timeout", "rate_limit", "unavailable"]
关键特性：切换发生在任何输出产生之前，确保用户不会看到中断或混合的响应。
2.4 Telegram 集成：三大稳定性修复
针对生产环境高频反馈的问题，本次集中修复：
长连接保活：将 Bot API 轮询移至独立工作线程，配备本地持久化队列，避免主事件循环阻塞导致的消息丢失。
Telegram 配置优化建议
telegram:
bot:
polling:
workerIsolation: true # 启用独立工作线程
spoolPath: "/var/spool/openclaw/telegram" # 持久化队列路径
HTML 格式保留：定时任务（Cron）触发的公告消息，Markdown 链接现在正确渲染为可点击格式，而非纯文本锚标签。
智能媒体过滤：启用 requireMention 时，未提及机器人的群组媒体消息将跳过下载，减少无效请求。
2.5 安全加固：Windows 沙箱与凭证管理
Windows 沙箱 现在将 USERPROFILE 纳入阻断路径，防止以下场景的信息泄露：
即使 HOME 环境变量指向其他位置
以下路径仍被禁止绑定：
C:\Users\\.codex
C:\Users\\.openclaw
C:\Users\\.ssh
凭证解析严格化：停止从宽泛的 ^[A-Z_][A-Z0-9_]*$ 模式推断提供商环境变量，仅通过结构化 SecretRefs 解析：
推荐：显式密钥引用
secrets:
providers:
openai:
apiKey:
envRef: "OPENAI_API_KEY" # 明确指定
# 不再自动识别 OPENAI_API_KEY_2024 等变体
—
三、快速开始
Docker 一键部署
拉取最新镜像
docker pull openclaw/openclaw:2026.5.12-beta.8
最小化启动（无外部提供商）
docker run -d \
--name openclaw \
-p 8080:8080 \
-v $(pwd)/data:/data \
openclaw/openclaw:2026.5.12-beta.8
完整功能启动（含常用插件）
docker run -d \
--name openclaw-full \
-p 8080:8080 \
-e OPENCLAW_PLUGINS="slack,telegram,bedrock" \
-v $(pwd)/data:/data \
openclaw/openclaw:2026.5.12-beta.8
CLI 安装与初始化
安装 CLI
npm install -g @openclaw/cli
初始化配置（自动传递提供商密钥）
openclaw init \
--openai-api-key "$OPENAI_API_KEY" \
--anthropic-api-key "$ANTHROPIC_API_KEY"
验证安装
openclaw version
输出: 2026.5.12-beta.8
—
四、常见问题 (FAQ)
Q1: 升级后现有工作流会中断吗？
不会。依赖外部化仅影响新安装，已有配置中的插件引用保持兼容。建议升级后运行 openclaw doctor 检查插件状态。
Q2: 如何确认 ACP 故障转移已生效？
查看运行时日志中的 acp.fallback 事件：
openclaw logs --filter "acp.fallback" --follow
预期输出: [acp.fallback] primary backend unavailable, switching to backup: openai-gpt4
Q3: Telegram Bot 消息仍偶尔丢失？
检查 spoolPath 的磁盘权限和可用空间，并确认 workerIsolation: true 已启用：
docker exec openclaw ls -la /var/spool/openclaw/telegram/
Q4: 最小化安装能节省多少空间？
对比测试数据（AMD64 镜像）：
- 完整版：~1.2 GB
- 最小化版（无 AWS/Vertex）：~680 MB
- 节省约 43%
Q5: Windows 沙箱阻断会影响正常开发吗？
仅影响显式绑定到用户配置目录的容器路径。标准开发工作流使用项目级 .openclaw 配置不受影响。
—
五、总结与下一步
OpenClaw 2026.5.12-beta.8 通过模块化架构降低了部署门槛，以故障转移机制提升了生产可靠性，并在安全基线上做了重要加固。建议：
1. 新用户：从最小化安装开始，按需添加插件
2. 现有用户：优先升级 Telegram 和 ACP 相关配置
3. 企业部署：评估 ACP fallbacks 对 SLA 的改善
—
相关阅读
—
参考来源
