夜雨聆风版本：v2026.4.15
发布日期：2026-04-16
https://github.com/openclaw/openclaw/releases/tag/v2026.4.15
📋 更新概览（10秒速读）
本次更新新增 9 项功能，修复超过 60 个问题，主要涉及语音合成、模型授权监控、内存存储、稳定性修复和安全加固。最重要的是新增 Gemini 文字转语音支持和 Model Auth 状态卡片，让用户可以一眼看到 OAuth 授权健康状态。
📣 功能更新
1. Gemini 文字转语音支持
💡 大白话： 就像给 OpenClaw 装了个"谷歌配音员"，用 Gemini API 把文字变成语音。比如：你让 AI 生成一段故事，以前只能看文字，现在可以直接"听"AI 用自然的语调讲给你，就像听有声书一样。
影响范围：
原来是什么： OpenClaw 的语音合成（TTS）只支持 ElevenLabs 和 Microsoft，用户需要额外购买这些服务才能获得语音输出（来源：https://github.com/openclaw/openclaw/issues/67515） 现在是什么： 新增 Google Gemini TTS 提供者，支持 24kHz PCM 音频，可复用现有的 Gemini API Key 针对哪些人群： 已有 Gemini API Key 的用户、需要语音交互功能的用户 有什么影响： 不需要额外购买 ElevenLabs，直接用现有的 Gemini 配额就能获得语音输出
实际更新内容： 新增 bundled Google speech provider，调用 Gemini generateContent with responseModalities: ["AUDIO"]，支持 API Key 认证（messages.tts.providers.google.apiKey、models.providers.google.apiKey、GEMINI_API_KEY、GOOGLE_API_KEY），24kHz PCM 包装为 WAV 用于普通 TTS，直接返回 PCM 用于 Talk/telephony。
2. Model Auth 状态卡片
💡 大白话： 就像给模型授权装了个"健康仪表盘"，一眼就能看到哪些授权快过期、哪些被限速了。比如：你用 OpenAI Codex 和 GitHub Copilot，以前授权出问题只能盲猜，现在打开 Overview 就能看到"OpenAI 授权还有 2 天过期"、"Copilot 被限速了"这样的提醒。
影响范围：
原来是什么： OAuth 认证的模型提供者（OpenAI Codex、GitHub Copilot 等）令牌刷新失败时，gateway 静默降级到其他提供者，用户完全不知道发生了什么（来源：https://github.com/openclaw/openclaw/issues/66211） 现在是什么： Overview 面板新增 Model Auth 卡片，显示 OAuth 令牌健康状态和提供商限速压力，有过期或已过期令牌时会突出提醒 针对哪些人群： 使用 OAuth 认证模型（OpenAI Codex、GitHub Copilot）的用户 有什么影响： 授权问题可视化，不用再猜为什么模型突然换成了别的
实际更新内容： 新增 models.authStatus gateway 方法，剥离凭证并缓存 60 秒，在 Overview dashboard 显示 OAuth 令牌健康状态和 rate-limit 压力，过期令牌有 attention callouts。
3. Memory LanceDB 云存储支持
💡 大白话： 就像把你的"记忆仓库"从本地硬盘搬到了云端，不怕本地机器坏了记忆就丢。比如：你在多台机器上跑 OpenClaw，以前每台机器的记忆都是独立的，现在可以把记忆索引存到 S3 或其他云存储，所有机器共享同一份记忆。
影响范围：
原来是什么： memory-lancedb 只支持本地文件系统存储，记忆索引只能在单机上使用（来源：https://github.com/openclaw/openclaw/issues/63502） 现在是什么： 新增 storageOptions配置，支持将 LanceDB 记忆索引存储到云存储（如 S3）针对哪些人群： 需要在多台机器共享记忆的用户、需要在云端持久化记忆的用户 有什么影响： 记忆可以跨机器共享，不怕本地故障丢失记忆数据
实际更新内容： 新增 storageOptions config 支持将 cloud storage credentials 传给 LanceDB，记忆索引可以存储在远程对象存储而非仅本地磁盘。
4. GitHub Copilot 记忆搜索嵌入
💡 大白话： 就像让你的 GitHub Copilot 订阅"一鱼两吃"，既写代码又做记忆搜索。比如：你有 GitHub Copilot 订阅但没买 OpenAI API，以前记忆搜索功能用不了，现在可以直接用 Copilot 的嵌入模型来搜索记忆。
影响范围：
原来是什么： 有 GitHub Copilot 订阅的用户必须额外配置 API Key（OpenAI、Gemini 等）才能使用记忆搜索嵌入功能（来源：https://github.com/openclaw/openclaw/issues/61718） 现在是什么： GitHub Copilot 插件新增嵌入提供者，自动发现 Copilot API 的嵌入模型，注册在自动选择优先级 15 针对哪些人群： 有 GitHub Copilot 订阅但没有单独嵌入 API Key 的用户 有什么影响： 不需要额外购买嵌入服务，直接用 Copilot 订阅就能搜索记忆
实际更新内容： 新增 MemoryEmbeddingProviderAdapter 到 github-copilot 插件，通过 Copilot API 发现嵌入模型，注册在 auto-selection priority 15，暴露 dedicated Copilot embedding host helper 供插件复用。
5. 本地模型精简模式
💡 大白话： 就像给小模型"减负"，去掉它用不上的复杂工具，让它能专心干活。比如：你用一台配置不高的机器跑本地模型，以前 OpenClaw 默认给它一堆复杂工具（浏览器、定时任务、消息），小模型被"吓到"产生幻觉，现在可以精简到只保留必要工具。
影响范围：
原来是什么： 较弱的本地/自托管模型面对 OpenClaw 完整默认工具集时，工具 schema 单独就消耗大量 prompt budget，容易产生幻觉（来源：https://github.com/openclaw/openclaw/issues/66495） 现在是什么： 新增 agents.defaults.experimental.localModelLean: true选项，可去掉重型默认工具（browser、cron、message）针对哪些人群： 使用较弱本地模型（如 1-3B 参数）的用户 有什么影响： prompt 更精简，小模型也能正确执行任务
实际更新内容： 新增实验性配置 agents.defaults.experimental.localModelLean: true，去掉 browser、cron、message 等重型默认工具，减少 prompt size，不改变 normal path。
6. Anthropic 默认模型优化
💡 大白话： 就像给 Anthropic 系模型"标配优化"，默认选更好的模型、更好的图片理解。比如：你用 Anthropic 模型时，以前默认配置可能不是最优的，现在默认会用 Claude Opus 4.7 做图片理解，体验更好。
影响范围：
原来是什么： Anthropic 模型的默认选择和别名配置不够优化，图片理解可能用不到最强的模型 现在是什么： 默认 Anthropic 选择优化， opus别名，Claude CLI 默认，图片理解默认使用 Claude Opus 4.7针对哪些人群： 使用 Anthropic 模型的用户 有什么影响： 默认体验更好，不用手动配置就能获得更优的模型选择
实际更新内容： default Anthropic selections、opus aliases、Claude CLI defaults，bundled image understanding 默认使用 Claude Opus 4.7。
7. 插件运行时依赖本地化
💡 大白话： 就像给每个插件"独立打包"，不再共享依赖，更干净更轻量。比如：以前多个插件共享一些运行时依赖，打包体积大，现在每个插件只带自己需要的依赖，安装包更小更快。
影响范围：
原来是什么： bundled plugin 运行时依赖分散，core 承载 extension-owned runtime baggage，打包体积大（来源：https://github.com/openclaw/openclaw/issues/67099） 现在是什么： bundled plugin 运行时依赖本地化到 owning extensions，精简 published docs payload 针对哪些人群： 所有安装 OpenClaw 的用户 有什么影响： 安装包更轻量，启动更快
实际更新内容： localize bundled plugin runtime deps to owning extensions，trim published docs payload，tighten install/package-manager guardrails。
8. Matrix QA 分离
💡 大白话： 就像把"测试房间"和"正式房间"分开，避免混淆。比如：Matrix 的 live QA 测试以前可能混在发布包里，现在单独成 runner，正式版本更干净。
影响范围：
原来是什么： Matrix live QA 混在 packaged 和 published builds 中 现在是什么： Matrix live QA 分离成 source-linked qa-matrixrunner，repo-privateqa-*surfaces 不在发布包中针对哪些人群： Matrix 用户、开发者 有什么影响： 发布版本更干净，测试和正式分开
实际更新内容： split Matrix live QA into source-linked qa-matrix runner，keep repo-private qa-* surfaces out of packaged and published builds。
9. 文档展示页优化
💡 大白话： 就像给官网"装修升级"，更好看更好找。比如：以前看社区示例要翻半天，现在有响应式视频网格、快速跳转链接，一眼就能找到想要的内容。
影响范围：
原来是什么： Docs showcase 页面展示不够直观 现在是什么： 新增 scannable hero、完整 section jump links、响应式视频网格 针对哪些人群： 所有用户 有什么影响： 文档更好浏览，社区示例更容易找到
实际更新内容： add scannable hero、complete section jump links、responsive video grid for community examples。
⚠️ 升级风险提示
梦境存储模式变更： 默认 dreaming.storage.mode从inline改为separate，梦境相位块会写入memory/dreaming/{phase}/YYYY-MM-DD.md而非memory/YYYY-MM-DD.md。如需保持旧行为，需设置plugins.entries.memory-core.config.dreaming.storage.mode: "inline"。工具名称冲突检测： 禁止客户端工具定义名称与内置工具 normalize-collide，如有自定义工具名称与内置工具相似的，可能收到 400 invalid_request_error。QMD 内存读取限制： memory_get现在只允许读取 canonical memory files（MEMORY.md、memory.md 等）和 active indexed QMD workspace docs，不能作为通用文件读取工具。
🐛 Bug 修复（技术细节，不建议普通用户查看）
本版本修复了以下问题，内容较为技术化，普通用户可跳过此部分。
安全加固
工具媒体传递安全：anchor trusted local MEDIA:tool-result passthrough on exact raw name，reject client tool definitions whose names normalize-collide（来源：https://github.com/openclaw/openclaw/issues/67303）Workspace 文件安全：route workspace files through fs-safehelpers，reject symlink aliases for allowlisted agent files（来源：https://github.com/openclaw/openclaw/issues/66636）MCP loopback：switch bearer comparison to safeEqualSecret，reject non-loopback browser-origin requests（来源：https://github.com/openclaw/openclaw/issues/66665）Exec approval：redact secrets in approval prompts（来源：https://github.com/openclaw/openclaw/issues/61077、https://github.com/openclaw/openclaw/issues/64790） Webchat/media：reject remote-host file://URLs in media embedding（来源：https://github.com/openclaw/openclaw/issues/67293）Feishu/webhook：harden webhook transport，refuse start without encryptKey（来源：https://github.com/openclaw/openclaw/issues/66707）
稳定性修复
Linux systemd 重启循环：fix spurious SIGUSR1 restart loop on Linux/systemd，plugin auto-enable 写入不再触发 hot-reload（来源：https://github.com/openclaw/openclaw/issues/67436、https://github.com/openclaw/openclaw/issues/67557） 工具循环防护：enable unknown-tool stream guard by default，防止"Tool X not found"无限循环（来源：https://github.com/openclaw/openclaw/issues/67401） TUI streaming watchdog：30s delta silence 后 reset streaming indicator（来源：https://github.com/openclaw/openclaw/issues/67401） LM Studio preload backoff：模型加载失败时 exponential backoff，不再每 2s WARN（来源：https://github.com/openclaw/openclaw/issues/67401） Skills snapshot invalidation：config 写入 skills.*时 bump cached skills-snapshot version（来源：https://github.com/openclaw/openclaw/issues/67401）
模型/提供者修复
OpenAI Codex：normalize stale native transport metadata，legacy rows self-heal to canonical Codex transport（来源：https://github.com/openclaw/openclaw/issues/67635） Ollama：strip ollama/provider prefix from model ids，防止 404（来源：https://github.com/openclaw/openclaw/issues/67457）OpenRouter/Qwen3：parse reasoning_detailsstream deltas as thinking content（来源：https://github.com/openclaw/openclaw/issues/66905）Anthropic：ignore non-positive token overrides，fail locally when no positive budget（来源：https://github.com/openclaw/openclaw/issues/66664） Failover：treat HTML provider error pages as upstream transport failures（来源：https://github.com/openclaw/openclaw/issues/67642） Audio STT：restore models.providers.*.request.allowPrivateNetworkfor audio transcription（来源：https://github.com/openclaw/openclaw/issues/66692）
记忆/梦境修复
梦境存储分离：default dreaming.storage.mode改为separate，phase blocks 不再污染 daily memory files（来源：https://github.com/openclaw/openclaw/issues/66412）QMD memory_get：reject reads of arbitrary workspace markdown paths，只允许 canonical memory files（来源：https://github.com/openclaw/openclaw/issues/66026） Dreaming ingestion：strip AI-facing inbound metadata envelopes from session-corpus user turns（来源：https://github.com/openclaw/openclaw/issues/66548） Dreaming transcripts：stop ordinary transcripts quoting dream-diary prompt from being classified as internal runs（来源：https://github.com/openclaw/openclaw/issues/66852）
频道修复
BlueBubbles：persistent file-backed GUID dedupe、catchup cursor after gateway restart（来源：https://github.com/openclaw/openclaw/issues/19176、https://github.com/openclaw/openclaw/issues/12053、https://github.com/openclaw/openclaw/issues/66816、https://github.com/openclaw/openclaw/issues/66857） Telegram：sanitize binary reply context、drop leaked binary caption bytes（来源：https://github.com/openclaw/openclaw/issues/66663、https://github.com/openclaw/openclaw/issues/66877） WhatsApp：harden encrypted upload handling、drain pending creds save queue before reopening sockets（来源：https://github.com/openclaw/openclaw/issues/65966、https://github.com/openclaw/openclaw/issues/67464） Matrix/E2EE：keep startup bootstrap conservative for passwordless token-auth bots（来源：https://github.com/openclaw/openclaw/issues/66228） Slack：fix option menus for slash commands，unique action ID for native buttons Discord：strip Gemma-style <function>...</function>tool-call payloads（来源：https://github.com/openclaw/openclaw/issues/67318）
其他修复
Compaction：cap compaction reserve-token floor to model context window，防止 small-context local models overflow（来源：https://github.com/openclaw/openclaw/issues/65671） Tilde paths：resolve non-workspace host tilde paths against OS home directory（来源：https://github.com/openclaw/openclaw/issues/62804） TTS：auto-enable bundled Microsoft and ElevenLabs speech providers（来源：https://github.com/openclaw/openclaw/issues/62846） Codex harness：auto-enable Codex plugin when selected as embedded agent runtime（来源：https://github.com/openclaw/openclaw/issues/67474） CLI transcripts：persist successful CLI-backed turns into session transcript（来源：https://github.com/openclaw/openclaw/issues/67490） Dashboard：constrain exec approval modal overflow on desktop（来源：https://github.com/openclaw/openclaw/issues/67082）
📝 总结
本次更新带来了多项重要功能：Gemini TTS 让语音合成更易获得，Model Auth 状态卡片让授权问题可视化，记忆云存储支持让数据更持久，GitHub Copilot 嵌入让记忆搜索更普及。同时修复了大量稳定性问题，特别是 Linux systemd 重启循环、工具循环防护等关键修复。建议所有用户升级，特别是使用 OAuth 认证模型、本地模型、BlueBubbles 频道的用户。
感谢所有贡献者：@barronlroth、@omarshahine、@rugvedS07、@feiskyer、@vincentkoc、@ImLukeF、@gumadeiras、@jchopard69、@pgondhi987、@ly85206559、@SARAMALI15792、@neo1027144-creator、@jalehman、@stainlu、@obviyus、@joelnishanth、@neeravmakwana、@suboss87、@xantorres、@duqaXxX、@plgonzalezrx8、@cyrusaf、@BKF-Gitty、@MonkeyLeeT、@Bartok9、@damselem、@chris-yyau、@openperf、@eleqtrizit、@hexsprite、@Tianworld、@slepybear、@WuKongAI-CMU、@joshavant、@Rohan5commit、@martinfrancois、@kashevk0、@bladin、@nightq、@jhsmith409、@frankekn、@xinmotlanthua、@hxy91819、@Ivan-Fn、@scotthuang、@Unayung、@tmimmanuel、@Wangmerlyn 等。
