OpenClaw 3.28 大更新：不仅内置 Grok 搜索、支持 MiniMax 画图，更上线了最保命的「高危操作弹窗拦截」功能。

　　虽然后来 3.23 紧急上了修补丁，还顺手给发布流程加了自动拦截的保险，但这事儿弄得大家心里一阵发毛。

　　xAI 被提到了第一梯队，原生的 Grok 网页搜索和工具配置直接内置了，不用再像以前那样手动来回折腾开关。

　　画图党也有福了，MiniMax 加了进来，完美支持 image-01 模型的图像生成和长宽比编辑。

　　你的小龙虾在执行那些高危操作前，终于可以暂停下来，通过 Telegram、Discord 或者命令行直接弹个框，问你一句：「老板，这活儿能干吗？」

　　现在的 Agent 能画图、能搜网、能随意切模型，甚至能把当前的聊天频道直接变成专属的工作区。

　　官方商店 ClawHub 里，曾经出现过同一个人上传了 300 多个伪装极好的恶意 Skills。

　　看看它有没有偷偷往外传数据，有没有试图去读你的私钥配置，甚至有没有去偷窥你的MEMORY.md记忆文件。

　　配置/Doctor：取消两个月以前的配置自动迁移；极旧的遗留配置键现在将直接触发验证失败，而非在加载时或执行openclaw doctor时被自动重写。

　　xAI/工具：将内置 xAI 提供商迁移至 Responses API，新增一级支持的x_search工具，并根据已拥有的网页搜索及工具配置自动启用 xAI 插件，使内置 Grok 的授权与搜索流程无需手动切换插件即可正常运行。

　　MiniMax：新增 image-01 模型的图像生成提供商，支持图像生成与图生图编辑，并可控制宽高比。

　　插件/钩子：在before_tool_call钩子中新增异步requireApproval，允许插件暂停工具执行并通过执行审批叠加层、Telegram 按钮、Discord 交互或任意频道上的/approve命令向用户请求确认。/approve命令现已统一处理执行审批与插件审批，并支持自动降级。

　　Slack/工具动作：新增显式的文件上传 Slack 动作，通过现有 Slack 上传通道路由文件上传，支持对频道和私信设置可选的文件名、标题与注释。

　　插件/MatrixTTS：将自动 TTS 回复以原生 Matrix 语音气泡形式发送，而非通用音频附件。

　　配置/TTS：在常规读取和密钥解析时自动迁移遗留语音配置，保留遗留诊断信息供 Doctor 使用，并移除旧内置tts.API 密钥格式在常规模式下的运行时降级逻辑。

　　内存/插件：将压缩前的内存刷新计划移交至活跃内存插件合约，由 memory-core 统一负责刷新提示与目标路径策略，不再由核心逻辑硬编码处理。

　　插件/运行时：在插件运行时系统命名空间中暴露runHeartbeatOnce，允许插件以显式的投递目标覆盖参数（如heartbeat: { target: last }）触发单次心跳周期。

　　Agent/压缩：在即时回复与排队后续请求中，均保留陈旧用量预检压缩后的 AGENTS 刷新操作。

　　Agent/压缩：暴露安全防护专属的取消原因，并将良性的手动/compact空操作情况从「失败」重新标记为「已跳过」。

　　Agent/图像工具：在未注册提供商专属媒体理解提供商时，恢复通用图像运行时降级逻辑，使 openrouter、minimax-portal 等提供商的图像分析功能重新可用。

　　WhatsApp：修复自聊天私信模式下的无限回声循环，该问题会将机器人自身发出的回复再次作为新的用户入站消息处理。

　　Telegram/消息分割：以经过验证的 HTML 长度搜索替代按比例估算的文本长度方案，使长消息在单词边界处分割而非从单词中间截断；当标签开销超出限制时优雅降级。

　　Telegram/投递：在 Bot 投递时跳过纯空白和被钩子清空的文本回复，防止因发送空文本触发 GrammyError 400 崩溃。

　　Telegram/发送：在全部四个 API 端点使用共享规范化器验证replyToMessageId，拒绝非数字、NaN 及混合内容字符串。

　　Mistral：规范化 OpenAI 兼容请求标志，解决官方 Mistral API 持续返回 422 状态码（无响应体）聊天错误的问题。

　　控制界面/配置：默认隐藏敏感原始配置，将空白被屏蔽的编辑器替换为显式的「解锁以编辑」状态，并在不自动暴露密钥的前提下恢复原始 JSON 编辑功能。

　　CLI/zsh：将compdef注册推迟至compinit可用后执行，使 zsh 补全在插件管理器和手动配置场景下均可正常加载。

　　BlueBubbles/防抖：通过在入队边界处清理消息文本，并增加独立的合并器防护，防止防抖刷新处理空消息文本时崩溃。

　　自动回复：在频道投递前使用严格的单键检测器过滤 JSON 包装的{action:NO_REPLY}控制信封；当文本仅为静默信封时仍保留媒体内容。

　　文档/FAQ：移除英文和 zh-CN FAQ 条目中已失效的 Xfinity SSL 故障排除交叉链接——这两个章节均已包含完整的解决方案内容。

　　Telegram：恢复在论坛主题会话中投递详细工具摘要的功能，使有线程的主题聊天与私信的详细模式行为保持一致。

　　BlueBubbles/CLIAgent：恢复 CLI 路由轮次的入站提示图像引用，重新应用嵌入式运行器图像大小限制，并为两条 CLI 图像传输路径添加回归测试。

　　BlueBubbles/群组：在群组门控通过后，可选择性地使用本地 macOS 通讯录名称丰富未命名参与者列表，使群组成员上下文可显示姓名而非仅展示原始电话号码。

　　Discord/重连：清理陈旧的网关套接字，在强制全新重连前清除缓存的恢复状态，并在旧套接字无法关闭时主动失败，防止 Discord 恢复流程因中毒的恢复状态而陷入循环。

　　iMessage：通过将reply_to以 RPC 元数据形式发送并从出站消息中剥离多余的指令标签，阻止内联[[reply_to:...]]标签泄露到已投递文本中。

　　CLI/插件：使路由命令与网关启动时使用相同的自动启用内置频道快照，确保 Slack 等已配置的内置频道无需事先重写配置即可正常加载。

　　CLI/消息发送：通过始终将默认 CLI Agent 接入出站镜像，将手动执行的openclaw message send投递内容重新写入已解析 Agent 会话的对话记录。

　　CLI/引导流程：在 Moonshot 配置菜单中重新显示 Kimi Code API 密钥选项，使交互式选择器将所有 Kimi 配置路径集中展示。

　　Agent/状态：为最新的 Anthropic 4.6 模型覆盖使用感知提供商的上下文窗口查询，使/status显示正确的 100 万 token 窗口，而非被低报的共享缓存最小值。

　　OpenAI/WebSocket：在 WebSocket 工具轮次中保留推理回放元数据和工具调用条目 ID，并在需要完整上下文重发时启动全新的响应链。

　　OpenAI/WS：为 Responses WebSocket 运行恢复推理块，并保持推理/工具调用回放元数据完整，防止恢复的会话在后续支持推理的轮次中丢失或出错。

　　Agent/错误：在可用时展示提供商配额与重置详情，同时将 HTML/Cloudflare 限流页面保留在通用降级逻辑中，避免将原始错误页面直接呈现给用户。

　　ClaudeCLI：将内置 Claude CLI 后端切换为流式 JSON 输出，使看门狗可在长时间运行时感知进度，并在 Claude 以空结果行结束时仍保留会话与用量元数据。

　　Agent/嵌入式回复：在嵌入式运行无用户可见回复时暴露中途发生的 429 和过载错误，同时保留仍使用遗留mediaUrl的成功纯媒体回复。

　　聊天/界面：将聊天发送按钮迁移至共享的幽灵按钮主题样式，同时保持停止按钮图标在危险状态下清晰可辨。

　　WhatsApp/allowFrom：对有效但被拦截的目标显示专属的allowFrom策略错误，替代具有误导性的格式提示。

　　Agent/冷却：按模型划分限流冷却范围，防止单个 429 错误阻塞同一授权配置下的所有模型；将指数级 1 分钟→1 小时升级策略替换为 30 秒/1 分钟/5 分钟的阶梯式策略，并在所有模型均受限时向用户展示倒计时信息。

　　Agent/嵌入式传输错误：在嵌入式运行的用户消息与生命周期诊断中，区分「连接被拒绝」「DNS 查询失败」「连接中断」等常见网络故障与真正的超时错误。

　　Telegram/配对：忽略机器人自身发送的私信消息更新，防止置顶状态卡片等服务更新触发虚假配对请求或重新进入入站分发流程。

　　Mattermost/回复：在所有出站回复分支中，将配对回复、斜杠命令降级回复和模型选择器消息保持在已解析的配置路径上，确保exec: SecretRefBot Token 正常工作。

　　MCP/频道：新增由网关支撑的频道 MCP 桥接，提供面向 Codex/Claude 的会话工具、Claude 频道通知，以及更安全的 stdio 桥接生命周期处理（含重连与路由会话发现）。

　　消息工具/按钮：在合并的工具定义中将共享按钮 Schema 设为可选，使纯action=send调用在未提供按钮时不再触发验证失败。

　　模型/OpenAI 补全：默认为非原生 OpenAI 兼容提供商省略工具定义的strict字段，除非用户显式重新启用，确保工具调用在拒绝该选项的提供商上继续正常工作。

　　插件/上下文引擎：在旧引擎拒绝新prompt字段时，自动去除该字段后重试严格遗留的assemble调用，保持对 pre-prompt 插件的兼容性。

　　CLI/更新状态：当本地版本与 npm 最新版本一致时，明确显示「已是最新版本」，同时保持可用性判断逻辑不变。

　　守护进程/Linux：停止将仅因 unit 文件中提到 OpenClaw 的非网关 systemd 服务误判为重复网关，减少 Doctor 和日志中的误报噪音。

　　飞书：在监控器停止/中止时关闭 WebSocket 连接，防止幽灵连接持续存在，避免跨重启周期的重复事件处理和资源泄漏。

　　飞书：对入站消息使用原始的message create_time而非Date.now作为时间戳，使离线重试消息携带正确的创作时间，防止对陈旧指令采取错误的 Agent 动作。

　　控制界面/技能：通过浏览器模态生命周期打开技能详情对话框，使点击技能行时面板居中显示，而非渲染到页面底部屏幕外。

　　Matrix/回复：在入站回复上下文中包含被引用的投票问题与选项，使 Agent 在用户回复 Matrix 投票消息时能看到原始投票内容。

　　Matrix/插件：防止插件引导在构建运行时混合裸路径和深路径 matrix-js-sdk 入口时崩溃，避免不相关的频道在插件加载期间被连带中断。

　　Agent/沙箱：遵守tools.sandbox.tools.alsoAllow配置，允许显式的沙箱再授权移除匹配的内置默认拒绝工具，并保持沙箱说明与错误引导和实际生效的沙箱工具策略一致。

　　Agent/沙箱：使被拦截工具的引导信息重新支持 glob 匹配，对沙箱说明提示中的会话专属内容进行脱敏处理以便安全复制，并避免在提示中泄露控制字符会话密钥。

　　Agent/压缩：在重试高上下文 LLM 超时前触发超时恢复压缩，防止嵌入式运行反复重发超大请求。

　　Agent/压缩：在延迟的嵌入式自动压缩成功后同步，使持久化的会话计数在处理器报告完成后能及时追上。

　　Agent/故障转移：将 CodexaccountIdToken 提取失败分类为授权错误，确保模型降级能继续至下一个配置候选项。

　　插件/运行时：跨工具、提供商、网页搜索和频道引导只复用兼容的活跃插件注册表，将/tools/invoke插件加载与会话工作区对齐，并在固定频道界面发生变化时重试出站频道恢复，防止插件工具和频道因运行时加载不匹配而消失或重复注册。

　　语音/macOS：修复系统语音直接失败后重复触发系统语音的问题，使用 App 语言区域降级处理共享看门狗计时，并为 macOS 降级路由和语言感知超时策略添加回归测试。

　　Discord/网关清理：在启动/销毁清理阶段持续抑制 Carbon 迟到的「重连耗尽」错误，防止 Discord 监控器关机时因迟到的网关关闭事件崩溃。

　　Discord/网关关闭：在有意的生命周期停止过程中，将预期的「重连耗尽」事件视为正常关机，防止启动中止清理逻辑将其误报为网关故障。

　　Discord/网关关闭：抑制在拆卸翻转lifecycleStopping之前已缓冲的「重连耗尽」事件，防止陈旧套接字 Discord 重启导致整个网关崩溃。

　　心跳/运行器：确保在心跳运行完成及意外运行器错误后重新设置间隔计时器，防止定时心跳在中断的周期后静默停止。

　　配置/Doctor：将陈旧的内置插件加载路径从遗留的extensions/*位置重写至已打包的内置路径，包括目录名称不匹配和带尾部斜杠的配置条目。

　　WhatsApp/提及：停止将被引用消息中嵌入的提及视为直接提及，防止回复带有 @机器人 的消息时误触提及门控。

　　Matrix：在m.direct种子成功后，将独立的双人房间排除在私信路由之外，同时仍遵守显式的is_direct状态和启动降级恢复逻辑。

　　飞书/工具：在工具执行时，停止将agent-spawner等合成 Agent ID 视为飞书账户 ID，确保工具降级使用已配置的默认飞书账户，而非将合成 ID 当作真实的已启用账户。

　　引导流程/TUI/本地网关：在配置输出中显示已解析的网关端口，明确无守护进程时本地健康检查与控制面板的提示信息，并在重复运行和显式本地网关 URL 场景下保留回环控制界面认证，使本地快速启动流程能正常恢复。

　　TUI/聊天记录：将系统消息保留为单一逻辑条目，并在完整消息边界处裁剪溢出，保持包装后的系统消息间距整洁。

　　TUI/激活：在 TUI 中对/activation参数进行验证，拒绝无效值而非静默强制转换为mention。

　　Agent/模型切换：在下一个安全重试边界将/model更改应用于活跃的嵌入式运行，确保过载或重试中的轮次切换至新选择的模型，而非继续锁定旧提供商。

　　内存/搜索：跨拆分插件运行时共享内存嵌入提供商注册，防止memory-core注册内置适配器后内存搜索因「未知提供商」错误而失败。

　　插件/入站声明：通过入站声明钩子元数据传递完整的入站附件数组，同时保留遗留的单一媒体附件字段以保持向后兼容。

　　插件/差异：在打包更新时暂存内置@pierre/diffs运行时依赖项，确保内置差异查看器在全局安装和更新后仍可正常加载。

　　插件/差异：不使用 JSON 模块导入方式加载内置 Pierre 主题，使差异渲染在更新版本的 Node.js 构建上保持正常工作。

　　插件/卸载：在卸载频道插件时移除对应的channels.配置，并保持卸载预览与显式频道所有权一致，确保内置频道和共享密钥不受影响。

　　插件/Matrix：在选择出站私信房间和路由未映射的验证摘要时，优先使用显式私信信号，防止严格的双人降级房间优先于真正的私信房间。

　　Microsoft Teams/主动私信：当存储了同一用户的多个会话引用时，对user:发送优先使用最新的个人会话引用，防止回复被投递至陈旧的私信线程。

　　网关/插件：在构建 HTTP/tools/invoke工具列表时复用会话工作区，并强化工具构建逻辑以默认推断会话 Agent 工作区，防止工作区插件在重复 HTTP 工具调用时重复注册。

　　Brave/网页搜索：在请求和缓存键生成前将不支持的 Brave 国家过滤器规范化为ALL，防止VN等从语言区域派生的值触发上游 422 验证错误小火箭vmess节点怎么使用。

　　Discord/回复：在剥除内联回复标签时保留前导缩进，确保带回复标签的纯文本和代码块保持原有格式。

　　守护进程/状态：从轻量级探测中暴露即时的网关关闭原因，并在openclaw daemon status中优先显示这些具体的授权或配对失败信息，而非通用超时提示。

　　Agent/故障转移：默认将 HTTP 410 错误分类为可重试的超时错误，同时仍保留载荷中的显式会话过期、计费和授权信号。

　　插件/Matrix：对 E2EE 图像缩略图使用thumbnail_file加密，对非加密房间的预览保留thumbnail_url，确保加密 Matrix 图像事件保留缩略图元数据，同时不泄露明文预览。

　　Telegram/论坛主题：通过在论坛线程命令上下文中保留主题目标，使原生的/new和/reset命令始终路由至当前活跃主题。