OpenClaw 2026.3.7版本刚上线，我从3.2版本完成升级后深度体验了新功能，整理了一手使用心得，今天分享给大家！
升级前的注意事项（非常重要！）
如果你和我一样同时配置了 gateway.auth.token 和 gateway.auth.password ，升级前务必先设置认证模式，否则可能出现启动失败或配对问题：
openclaw config set gateway.auth.mode token # 或 password
这一步千万别跳过，否则升级后会很麻烦。
我比较关注的新功能
1. Context Engine 插件接口
这个是我最期待的功能之一。新增了 ContextEngine 插件槽位，支持完整的生命周期钩子。这意味着可以使用 lossless-claw 等替代上下文管理策略的插件了。
默认不配置时行为保持不变，所以升级是无感的，想用的时候再开启就行。
2. ACP 持久化绑定
如果你用 Discord 频道或 Telegram topic 绑定，之前每次重启都要重新绑定挺烦人的。这次更新后绑定关系会持久化保存，跨重启自动恢复，方便很多。
同时新增了 CLI 管理命令，操作更直观。
3. Telegram 功能增强
Telegram 用户的福音：
- Topic 绑定更方便：
/acp spawn --thread here|auto - 每个 topic 可以指定独立的 agent，适合多场景使用
- 支持 Telegram 内审批交互，不用切回命令行了
4. Web 搜索体验提升
Perplexity 切换到了 Search API，搜索结果更结构化、更易用。还新增了语言、地区、时间过滤器，查资料更精准。
5. 新模型支持
Google Gemini 3.1 Flash-Lite 现在可以用了（google/gemini-3.1-flash-lite-preview ），轻量级任务的好选择。
6. Docker 镜像瘦身
采用了多阶段构建，运行镜像更小了。还新增了 OPENCLAW_VARIANT=slim 精简变体，对于资源受限的环境很友好。
其他值得提到的改进
| 功能 | 说明 |
|------|------|
| Gateway SecretRef | gateway.auth.token 支持 SecretRef，更安全 |
| Slack 打字反馈 | DM 支持 reaction 显示处理状态 |
| Discord allowBots | 新增 allowBots: "mentions" 只接受 @提及 |
| 工具结果截断 | 保留头尾重要信息，不再一刀切 |
| Cron 备份 | 编辑时保留原始快照用于恢复 |
| Web UI | 新增西班牙语支持 |
| TTS | 支持 OpenAI 兼容端点自定义 baseUrl |
安全和稳定性修复
这次更新做了不少修复：
- 配置加载失败时 fail-closed，不再静默回退默认值
- Memory BM25 排序修复
- LINE 群组策略修复
- Gateway Telegram 陈旧 socket 重启守护
- 多项 Windows/WSL2 兼容性修复
我的升级建议
推荐升级的情况：
- 使用 ACP 且希望绑定持久化
- 需要 Telegram topic 级 agent 路由
- 使用 Perplexity 搜索
- 想用 Gemini 3.1 Flash-Lite
- 使用 Docker 且希望镜像更小
可以暂缓的情况：
- 生产环境稳定运行，无上述需求
- 同时配置了 token 和 password 但暂时不想改配置
- 想观望一下社区反馈
升级步骤
# 1. 先备份配置（养成好习惯）
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
# 2. 检查 gateway.auth 配置
openclaw config get gateway.auth
# 如果同时有 token 和 password，设置认证模式
openclaw config set gateway.auth.mode token
# 3. 升级
npm update -g openclaw
# 4. 重启 gateway
openclaw gateway restart
# 5. 验证
openclaw --version # 应显示 2026.3.7
openclaw doctor # 检查配置
总结
这次更新内容挺丰富的，Context Engine 插件和 ACP 持久化是我认为最有价值的两个新功能。如果你有上述需求，建议在工作日低峰期升级，记得先处理认证配置就行。