OpenClaw v2026.3.7：Context Engine 插件与 Telegram 主题绑定

v2026.3.8 是一个小版本，主要修复了 macOS 应用和聊天 UI 的问题：

• 浏览器代理：通过本地节点浏览器服务路由浏览器代理
• 纯文本粘贴：保留纯文本粘贴语义
• 转录清理：从转录中剥离已完成的助手跟踪/调试包装器噪声
• 权限刷新：从系统设置返回后刷新权限状态
• Cron 容错：在 macOS 标签页中容忍格式错误的 cron 行

Context Engine 插件接口

新增 ContextEngine 插件槽位，支持完整的生命周期钩子（bootstrap、ingest、assemble、compact、afterTurn、prepareSubagentSpawn、onSubagentEnded）。这使得像 lossless-claw 这样的插件可以提供替代的上下文管理策略，而无需修改核心压缩逻辑。

ACP 持久化通道绑定

添加了持久的 Discord 通道和 Telegram 主题绑定存储、路由解析和 CLI/文档支持，使 ACP 线程目标能够在重启后保持，并可一致地管理。

Telegram 增强

• 主题绑定：支持 Telegram 主题线程绑定（--thread here|auto）
• 主题代理路由：支持论坛群组和 DM 主题中的每个主题 agentId 覆盖，使主题可以路由到具有隔离会话的专用代理
• 批准按钮：添加可操作的 Telegram 批准按钮

Web UI 国际化

在 Control UI 中添加了西班牙语（es）区域支持，包括区域设置检测、延迟加载和语言选择器标签。

Web 搜索改进

• 提供商选择：在配置向导中添加提供商选择步骤和完整提供商列表
• Perplexity：切换 Perplexity 提供商到搜索 API，支持结构化结果和新的语言/区域/时间过滤器

Docker/Podman 扩展依赖烘焙

添加 OPENCLAW_EXTENSIONS 环境变量，使容器构建可以预安装选定的捆绑扩展 npm 依赖项，以实现更快、更可复现的容器部署启动。

其他改进

• SecretRef：为 gateway.auth.token 添加 SecretRef 支持
• TTS：添加 messages.tts.openai.baseUrl 配置支持
• Slack：添加 channels.slack.typingReaction 显示处理状态
• Discord：添加 allowBots: "mentions" 只接受提及机器人的消息
• Google Gemini：添加 google/gemini-3.1-flash-lite-preview 支持
• Docker 多阶段构建：重构 Dockerfile 为多阶段构建，生成最小运行时镜像

Gateway 认证现在需要显式的 gateway.auth.mode

当同时配置了 gateway.auth.token 和 gateway.auth.password（包括 SecretRefs）时，必须设置 gateway.auth.mode 为 token 或 password，以避免启动/配对/TUI 失败。

安全与配置

• 配置安全：当 loadConfig() 遇到验证或读取错误时关闭失败，使无效配置无法静默回退到宽松的运行时默认值
• Cron 文件权限：强制 cron 存储/备份/运行日志文件仅所有者可访问（0600），并将目录加固为 0700

内存与搜索

• 混合搜索：在 bm25RankToScore() 中保留负 FTS5 BM25 相关性排序
• Brave 语言代码验证：对齐 search_lang 处理与 Brave 支持的代码（包括 zh-hans、zh-hant）
• QMD 搜索结果解码：接受仅包含 file URI 的 QMD 搜索命中

渠道修复

• Telegram：修复陈旧套接字重启保护
• Slack：修复 app_mention 竞争去重
• 飞书：修复群组斜杠命令检测
• LINE：对齐群组策略解析
• WhatsApp：修复自聊响应前缀回退

工具与代理

• xAI 原生 Web 搜索：删除重复的工具名称注册
• OpenAI 兼容流：修复使用块解析崩溃
• Kimi Coding：规范化 Anthropic 工具载荷为 OpenAI 风格
• 工具结果截断：使用头+尾截断保留重要的尾部诊断

TUI 修复

• 会话隔离：使 /new 分配唯一的会话键，防止多个 TUI 客户端收到彼此的回复
• 模型指示器：防止陈旧的会话快照覆盖新修补的模型选择
• 最终错误渲染：当聊天 final 事件没有可渲染内容但有错误消息时，渲染格式化的错误文本

浏览器与会话

• 会话清理：跟踪会话范围的浏览器工具运行打开的标签页，并在会话重置/删除期间关闭它们
• 路由绑定：预索引路由绑定，避免通道账户缓存翻转时的全绑定列表重新扫描

本版本包含重要的安全修复和新功能，建议所有用户升级。特别是：

• 必须操作：如果同时配置了 token 和 password，升级前设置 gateway.auth.mode
• 推荐：使用 ACP、Telegram 主题、或 Context Engine 插件的用户
• 推荐：使用 macOS 应用的用户
• 推荐：Docker 部署用户（新的多阶段构建镜像更小）