——
OpenClaw v2026.5.12 发布：5大核心改进让 AI Agent 部署更轻量
一句话总结：OpenClaw 最新版本通过模块化依赖管理和稳定性增强，让生产级 AI Agent 的部署体积更小、运行更可靠，特别适合需要多平台集成的复杂工作流场景。
如果你正在维护基于 OpenClaw 的自动化系统，或计划将 AI Agent 接入 Telegram、Slack、WhatsApp 等平台，这篇更新解读将帮你快速判断是否需要升级，以及如何最大化利用新特性。
—
一、更精简的安装：按需加载依赖
核心变化：依赖外部化
过去，安装 OpenClaw 核心运行时会自动拉取大量你可能用不到的 SDK——即使你不使用 AWS 服务，Amazon Bedrock 的依赖也会被包含。v2026.5.12 彻底改变了这一设计：
| 原行为 | 新行为 |
|——–|——–|
| 核心安装包含所有 provider 依赖 | 仅安装实际使用的 provider |
| 安装包体积大，启动慢 | 按需加载，Leaner installs |
| 更新时容易因依赖冲突失败 | 依赖隔离，更新更稳定 |
具体外部化的组件：
- Amazon Bedrock 及 Bedrock Mantle provider 包
- Slack 集成插件
- OpenShell 沙箱环境
- Anthropic Vertex provider
升级建议
如果你当前使用 Docker 部署，建议重建镜像以清理冗余依赖：
拉取最新镜像
docker pull openclaw/openclaw:latest
清理旧镜像层（可选，回收磁盘空间）
docker image prune -f
重新部署，仅安装需要的插件
docker run -d \
--name openclaw \
-e OPENCLAW_PLUGINS="telegram,slack" \
-v $(pwd)/config:/app/config \
openclaw/openclaw:latest
> 💡 提示：通过 OPENCLAW_PLUGINS 环境变量显式声明所需插件，可确保最小化运行时体积。
—
二、Telegram 集成：从”能用”到”可靠”
四大稳定性改进
1. 隔离式轮询（Isolated Polling）
以往 Telegram Bot 的 Bot API 轮询与主事件循环耦合，当主线程阻塞时会导致消息接收中断。新版本将 ingress 移至独立 worker，并配备持久化本地缓冲队列（durable local spooling）：
消息流：Telegram API → 隔离 Worker → 本地 Spool → 主事件循环
↑______________↓
（主循环阻塞时不丢消息）
2. HTML/Markdown 格式保留
修复了定时消息（cron announce）中 Markdown 链接退化为纯文本锚点的问题。现在富媒体格式的消息在流式传输和定时投递中都能正确渲染。
3. 智能群媒体过滤
当启用 requireMention 时，Bot 会跳过未提及的群组媒体下载，避免不必要的网络请求和失败回复。
4. 配置示例
config/telegram.yaml
telegram:
botToken: "${TELEGRAM_BOT_TOKEN}"
requireMention: true # 仅在@机器人时响应
formatting:
preserveHtml: true # 保留 HTML 标签
markdownSupport: true # 启用 Markdown 解析
resilience:
isolatedPolling: true # 启用隔离轮询
spoolPath: "/app/spool" # 本地缓冲路径
maxSpoolSize: "100MB"
—
三、Codex/OpenAI 路径：开发体验全面升级
关键改进一览
| 特性 | 说明 | 适用场景 |
|——|——|———|
| Auth-profile-backed media tools | 媒体工具支持认证配置切换 | 多账号/多环境开发 |
| MCP server projection | 模型上下文协议服务器投影 | 复杂工具链集成 |
| Context-engine thread rotation | 上下文引擎线程轮换 | 长会话内存优化 |
| App-server/runtime fallback | 应用服务器/运行时降级 | 高可用生产环境 |
MCP（Model Context Protocol）集成实践
MCP 是 Anthropic 推出的开放协议，用于标准化 AI 模型与外部工具的交互。OpenClaw 现在支持将自身作为 MCP 服务器投影：
// mcp-config.json
{
"mcpServers": {
"openclaw": {
"command": "npx",
"args": ["-y", "@openclaw/mcp-server@latest"],
"env": {
"OPENCLAW_API_URL": "http://localhost:3000",
"OPENCLAW_API_KEY": "${OPENCLAW_API_KEY}"
}
}
}
}
配合 Claude Desktop 或 Cline 等支持 MCP 的客户端，可直接调用 OpenClaw 的 agent 能力：
通过 MCP 触发 OpenClaw 工作流
claude "使用 openclaw 查询今日销售数据并生成报告"
—
四、插件系统：安装更新更稳健
pnpm 11 支持与依赖保护
插件安装常见问题（如 peer-dependency 冲突、运行时扫描失败）在新版本中得到系统性修复：
推荐：使用 pnpm 11 安装插件
npm install -g pnpm@11
安装插件时保留 peer 依赖
openclaw plugin install @openclaw/slack --preserve-peer-deps
从 Git 源安装（修复了之前的路径解析问题）
openclaw plugin install github:custom-org/custom-plugin#main
安全加固
网关（Gateway）、浏览器自动化（Browser）、节点配对（Node pairing）、沙箱（Sandbox）和会话记录（Transcript）等路径均通过了安全与溯源强化审查（security/provenance hardening pass），建议生产环境用户审查以下配置：
security.yaml
gateway:
provenance:
verifySignatures: true # 验证插件签名
allowedOrigins: # 限制插件来源
- "https://registry.openclaw.dev"
- "https://github.com/openclaw/*"
sandbox:
isolation: "strict" # 严格隔离模式
allowedSyscalls: [] # 显式允许的系统调用
—
五、UI 与交互：细节体验优化
流式输出控制
Control UI 和 WebChat 新增持久化的自动滚动模式选择器，解决长期困扰用户的滚动跳动问题：
| 模式 | 行为 | 推荐场景 |
|——|——|———|
| Near-bottom（默认） | 接近底部时自动跟随 | 常规监控 |
| Always follow | 始终跟随流式输出 | 实时演示 |
| Manual | 完全手动，显示”新消息”按钮 | 历史回顾 |
通过环境变量预设模式
OPENCLAW_UI_SCROLL_MODE=always-follow
—
FAQ：常见问题解答
Q1: 升级后现有配置会失效吗？
不会。v2026.5.12 保持向后兼容，但建议检查：
- 若使用了 Amazon Bedrock 或 Slack，需显式安装对应插件：
openclaw plugin install @openclaw/bedrock @openclaw/slack - 自定义插件若依赖核心内部的 AWS SDK，需更新为独立依赖
Q2: 如何验证 Telegram 的隔离轮询已生效？
查看日志中是否出现 worker:ingress:isolated 标记：
docker logs openclaw | grep "isolated worker"
预期输出：INFO [worker:ingress:isolated] Telegram polling isolated, spool active
Q3: MCP server projection 与直接 API 调用有何区别？
MCP 提供标准化工具发现机制，客户端可自动识别可用能力；直接 API 调用需手动管理端点。MCP 更适合与 Claude Desktop、Cline 等工具链集成。
Q4: 新版本是否支持自托管 WhatsApp？
支持，但 WhatsApp 依赖已外部化。部署时需：
openclaw plugin install @openclaw/whatsapp
并配置 WhatsApp Business API 凭证
Q5: 如何回滚到旧版本？
指定历史标签
docker pull openclaw/openclaw:v2026.4.28
docker run ... openclaw/openclaw:v2026.4.28
> ⚠️ 回滚前备份数据库，新版本可能有 schema 变更。
—
总结与下一步
OpenClaw v2026.5.12 的核心价值在于生产就绪性提升：
- ✅ 部署体积减小 30-50%（依赖实际使用场景）
- ✅ Telegram 等关键集成达到企业级稳定性
- ✅ 开发工具链与 MCP 生态对齐
- ✅ 安全基线全面提升
建议行动：
1. 在测试环境验证插件依赖外部化影响
2. 评估 Telegram 隔离轮询对现有 Bot 的改进
3. 探索 MCP 集成以简化工具链配置
—
相关阅读
—
参考来源
