OpenClaw 2026.3.7 发布:重启后 ACP 绑定依然有效,Docker 镜像大幅瘦身
OpenClaw 团队正式推出 2026.3.7 版本。本次更新不仅带来了 GPT-5.4 与 Gemini 3.1 Flash-Lite 的前沿模型支持,更在架构灵活性、部署效率及跨平台体验上实现了重大突破。
- 地址:https://github.com/openclaw/openclaw/releases/tag/v2026.3.7
核心亮点在于:ACP 绑定现在支持持久化存储,彻底解决了重启后线程丢失的痛点;Docker 构建引入多阶段编译,镜像体积显著缩小;以及全新的可插拔上下文引擎,为社区开发自定义压缩策略打开了大门。
核心特性:更智能、更持久、更轻量
1. ACP 绑定持久化:重启不再“失忆”
此前,自动协作协议(ACP)的频道绑定在系统重启后往往失效,需要重新配置。
- 新增功能:引入持久的 Discord 频道和 Telegram 主题绑定存储。
- 实际效果:无论服务如何重启,ACP 线程目标始终有效且可被一致管理。
- Telegram 增强:支持在
/acp spawn中使用 Mac Unicode 破折号前缀,完美适配 Telegram 主题线程(--thread here|auto)。绑定成功后,确认信息将自动置顶,并附带可操作的批准按钮。
2. 可插拔上下文引擎:定义你的记忆策略
这是架构层面的重大升级。OpenClaw 现在开放了 ContextEngine 插件槽。
- 全生命周期钩子:支持
bootstrap、ingest、assemble、compact、afterTurn等关键节点。 - 零侵入扩展:开发者可以编写像
lossless-claw这样的插件,提供替代的上下文管理或压缩策略,而无需修改核心代码。 - 向后兼容:若未配置插件,系统将自动回退到默认的
LegacyContextEngine,行为零变化。
3. Docker 多阶段构建:极致轻量化
针对容器化部署进行了深度优化。
- 重构 Dockerfile:采用多阶段构建,最终镜像仅包含运行时必要文件,剔除了构建工具、源代码及 Bun 运行时。
- Slim 变体:新增
OPENCLAW_VARIANT=slim参数,基于bookworm-slim构建,进一步压缩体积。 - 依赖预置:通过
OPENCLAW_EXTENSIONS环境变量,可在构建时将选定的 npm 依赖预安装进镜像,实现秒级启动和高度可复现的部署环境。
模型与多模态:拥抱最新标准
- 模型支持:
- GPT-5.4:全面适配最新一代旗舰模型。
- Gemini 3.1 Flash-Lite:添加对
google/gemini-3.1-flash-lite-preview的一流支持,包括模型 ID 规范化、默认别名及媒体理解图像查找。
- 图像格式:原生支持 HEIF 格式图片,满足 Apple 设备及现代手机用户的上传需求。
- TTS 路由:新增
messages.tts.openai.baseUrl配置,支持将 OpenAI 兼容的 TTS 请求路由到自定义端点,优先级高于环境变量。
开发者与运维:更灵活的控制权
- SecretRef 安全增强:网关认证 token (
gateway.auth.token) 现在支持SecretRef引用模式,配合认证模式保护,密钥管理更安全。 - ⚠️ 重要不兼容变更:
- 若同时配置了
gateway.auth.token和gateway.auth.password,必须显式设置gateway.auth.mode为token或password。否则将导致启动失败。请在升级前检查配置文件。
- 若同时配置了
- 插件系统增强:
- 新增
prependSystemContext和appendSystemContext,允许静态插件指导注入系统提示,优化提供商缓存并降低 Token 成本。 - 增加
allowPromptInjection钩子策略控制,防止未知插件恶意修改提示词。
- 新增
- 工具优化:
- Diff 指导:将 Diff 使用说明移至配套技能路径,减少无关轮次的提示噪音。
- 结果截断:过大的工具输出现在采用“首尾保留”策略,确保关键诊断信息不丢失。
- 搜索升级:Perplexity 提供商切换至搜索 API,支持结构化结果及语言/地区/时间筛选。
全平台体验:从 Web 到 iOS
- 🌐 Web UI 国际化:控制界面新增 西班牙语 (es) 支持,具备区域自动检测与懒加载功能。
- 🍎 iOS 发布准备:
- 统一 Bundle ID 为
ai.openclaw.client。 - 刷新 Watch 应用图标,集成 Fastlane 自动化流程。
- 支持基于钥匙串的 App Store Connect 认证上传,iOS 正式版蓄势待发。
- 统一 Bundle ID 为
- 💬 通讯平台修复:
- Zalo:修复频道连接问题。
- Slack:私聊模式下增加基于反应(Reaction)的输入状态反馈,弥补原生助手状态缺失。
- Discord:新增
allowBots: "mentions"门控,仅接受提及机器人的 Bot 消息,减少噪音。 - Mattermost:添加交互式模型选择器,体验对标 Telegram。
📝 其他改进与修复
- Cron 作业快照:标准化持久化过程中跳过备份,保留
jobs.json.bak用于紧急恢复。 - 压缩保护调优:公开
agents.defaults.compaction.recentTurnsPreserve配置,允许用户自定义压缩后保留的最近对话轮数。 - 文档更新:移除过时的 Brave 免费套餐说明,替换为中立的合规指南。
💡 升级建议
- 检查认证配置:务必在升级前确认
gateway.auth.mode已显式设置,避免服务无法启动。 - 尝试新镜像:Docker 用户建议拉取最新的
slim变体镜像,体验更快的启动速度和更小的存储占用。 - 探索插件开发:上下文引擎的开放为高级用户提供了巨大空间,不妨尝试编写自定义的压缩或记忆插件。
暂无评论...











