夜雨聆风
OpenClaw 2026.4.22 发布:AI Agent 进入「无网关」时代
OpenClaw 2026.4.22 发布：AI Agent 进入「无网关」时代
160+ commit 带来桌面嵌入、TTS/STD 全家桶、诊断_export
我是atyou, 今天教大家OpenClaw 新版本。
OpenClaw 2026.4.22 正式发布，这是迄今为止变更最多的版本之一——160+ commit，带来了桌面嵌入模式、语音全能力、诊断导出等重磅功能。
这篇文章帮你快速把握更新要点，了解哪些功能值得第一时间体验，以及升级可能遇到的坑。
— — — — — — — — — —
一、桌面嵌入模式：终端聊天摆脱网关
本次更新最重磅的功能变化——现在可以在终端内直接运行聊天，不再依赖 Gateway。
Step 1什么是桌面嵌入模式
TUI 新增 local embedded mode，让终端聊天不依赖 Gateway 即可运行，同时仍保留插件审批机制，安全管控不下线。
这意味着：即使 Gateway 崩溃，你的终端会话依然可以继续工作。
|
📌适用场景 本地开发、CI/CD 环境、无外网连接的设备 |
Step 2如何使用
在 TUI 配置中启用 local embedded mode：
# 在配置文件中启用
tui: { embedded: { mode: “local” } }
— — — — — — — — — —
二、语音能力全家桶：TTS + STT 全面更新
语音相关功能迎来大版本更新，xAI、Deepgram、ElevenLabs、Mistral 全部支持。
Step 1xAI 语音三件套
xAI 新增完整语音支持：
• 图像生成：grok-imagine-image / grok-imagine-image-pro
• 语音合成：6种 live TTS 声音，支持 MP3/WAV/PCM/G.711
• 语音识别：grok-stt 音频转录 + realtime 实时转写
|
⚠️踩坑 xAI 语音需要 xAI API key，当前仅支持部分地域 |
Step 2Voice Call 流式转写
新增 Voice Call streaming transcription，支持：
• Deepgram realtime
• ElevenLabs realtime
• Mistral realtime
• OpenAI 与 xAI 的现有 realtime STT 路径
ElevenLabs 额外支持 Scribe v2 批量转录。
Step 3WhatsApp 语音增强
修复 WhatsApp outbound 重复发送问题：
之前 30 分钟 inbound-silence watchdog 会误触发导致 cron 重复 7-12x，
现在通过 in-memory active-delivery claim 解决。
— — — — — — — — — —
三、新增提供商：Tencent Cloud + Amazon Mantle
两个重要云厂商_provider 正式加入。
Step 1Tencent Cloud (hy3-preview)
新增 Tencent Cloud provider plugin：
• TokenHub 一键 onboarding
• 文档完整支持
• hy3-preview 模型目录
•tiered Hy3 定价
Step 2Amazon Bedrock Mantle (Claude Opus 4.7)
通过 Mantle 的 Anthropic Messages 路由，新增 Claude Opus 4.7支持：
• provider-owned bearer-auth streaming
• 无需将 AWS bearer token 当作 Anthropic API key
• 运行时刷新 IAM token，避免过期
— — — — — — — — — —
四、WhatsApp 配置增强：群组/私聊分别配置
WhatsApp 迎来精细化配置能力。
Step 1per-group / per-direct systemPrompt
新增 per-group 和 per-direct systemPrompt 配置：
• groups: 群组级别的行为指令
• direct: 私聊级别的行为指令
• 支持 “*” 通配符 fallback
• account-scoped 覆盖
• 完全替换根配置（不深度合并）
# 配置示例
channels: {
whatsapp:{
accounts:{
“my-account”:{
groups:{ “*”: “群聊助手角色” },
direct:{ “*”: “私聊助手角色” }
}
}
}
}
Step 2WhatsApp 原生引用回复
新增 configurable native reply quoting，
通过 replyToMode 配置控制引用行为。
— — — — — — — — — —
五、Gateway 诊断 export：一键导出支持日志
Gateway 稳定性记录默认开启，新增诊断导出功能。
Step 1诊断导出功能
新增 support-ready diagnostics export：
• sanitized logs（脱敏日志）
• status（状态）
• health（健康度）
• config（配置）
• stability snapshots（稳定性快照）
用于 bug 报告一键收集。
|
⚠️踩坑 导出日志默认脱敏，如需完整日志需手动开启 |
Step 2稳定性记录默认开启
payload-free stability recording 默认启用，
再也不用担心忘记开稳定性记录了。
— — — — — — — — — —
六、模型管理：/models add 命令上线
模型管理命令增强，支持运行时动态注册模型。
Step 1/models add 命令
新增命令：
• /models add
• 无需重启 Gateway ���可��用新模型
• /models 保留为简单浏览器
• 新增更清晰的 add 指引和复制友好示例
# 使用示例
/models add openai gpt-4.1
/models add anthropic claude-sonnet-4-20250514
Step 2Thinking 默认值调整
reasoning-capable model 的 implicit thinking level：
• 从 legacy off/low 升级为 safe medium equivalent
• preserve configured model reasoning metadata
• /status 报告与运行时一致
— — — — — — — — — —
七、插件加载速度：Jiti 加持 82-90% 提升
Plugin SDK 迎来性能大幅提升。
Step 1Jiti 原生加载
通过 native Jiti loading：
• bundled plugin dist 模块加载提升 82-90%
• 保留 source TypeScript 在 transform path
• 冷启动 doctor 依然使用 built artifacts
Step 2Doctor 插件加载优化
doctor –non-interactive 运行时降低 74%，
通过 lazy-load plugin paths + prefer dist/* runtime entries。
Step 3Config includes 修复
修复 config includes 问题：
• plugins install/update 不再 flatten $include configs
• 单独文件顶层 includes 写入保持独立
— — — — — — — — — —
八、Codex 集成增强
Codex harness 与 OpenClaw 深度对齐。
Step 1Hooks 对齐 Pi
Codex harness hooks 与 Pi 对齐：
• before_prompt_build / before_compaction
• after_compaction / after_tool_call
• llm_input / llm_output / agent_end
• before_message_write transcript 写入
Step 2Codex CLI auth 变化
Codex CLI auth 变化：
• 移除 ~/.codex OAuth 导入路径
• 使用 browser login 或 device pairing
• 修复 stale per-agent OAuth profile 问题
Step 3动态工具描述处理
忽略动态工具描述来决定线程复用，
channel-specific copy 变化不再重置对话。
— — — — — — — — — —
九、其他重要修复
大量 bugfix 提升稳定性。
Step 1Memory search 向量召回
使用 sqlite-vec KNN 向量召回，
保留 full post-filter result limits。
Step 2Media 音频转写优先
prefer configured/key-backed STT providers，
避免 local Whisper CLI shadow API providers。
Step 3Linux OOM 优化
Gateway 子���程 raise oom_score_adj，
under cgroup pressure 时优先 kill transient workers。
Step 4Config 回滚保护
critical clobber signatures 时恢复 last-known-good config，
防止 gateway crash loops。
— — — — — — — — — —
十、升级建议与注意事项
升级前必读。
Step 1建议升级顺序
1. 先备份配置（尤其 plugins.json5）
2. 运行 openclaw doctor 检查
3. 更新插件：openclaw plugins update
4. 重启 Gateway
5. 验证核心功能
Step 2已知兼容问题
• xAI 语音仅部分地域可用
• Codex auth 需要重新配对
• WhatsApp account 配置是全新替换，非合并
|
⚠️踩坑 WhatsApp per-account 配置完全替换旧配置，记得迁移 |
— — — — — — — — — —
七、常见问题与排错
桌面嵌入模式有什么限制？
仍保留插件审批机制，安全管控不下线。仅适用于本地开发或无 Gateway 场景。
xAI 语音哪些地区可用？
需要 xAI API key，当前仅支持部分地域，建议先测试。
WhatsApp 配置为什么失效了？
新版本 per-account 配置是完全替换，不是合并。需要重新配置。
Codex 登录不上怎么办？
移除 OAuth 导入，需要用 browser login 或 device pairing 重新配对。
升级后插件加载变慢？
检查 Jiti 是否正常工作，尝试 openclaw doctor –fix。
— — — — — — — — — —
八、安全建议
•桌面嵌入模式仍走插件审批，安全管控不下线
•诊断导出默认脱敏，敏感信息不会泄露
•Codex auth 变化避免 OAuth token 泄露问题
•Linux OOM 优化避免 Gateway 被误杀
|
⚠️重要提醒 本文中出现的所有 Token 均为示例或已脱敏处理。请务必使用你自己的 Token，并妥善保管。切勿将敏感凭证提交到 Git 仓库。 |
— — — — — — — — — —
总结
OpenClaw 2026.4.22 是里程碑版本，160+ commit 带来桌面嵌入、语音全家桶、诊断导出等重磅功能
插件加载速度提升 82-90%，Gateway 配置更稳定
推荐升级但注意 xAI 地域限制和 Codex auth 变化
•版本代号🎯 160+ commit
•核心功能桌面嵌入 + 语音全家桶
•性能提升🚀 插件加载 82-90%
•语音支持🎤 xAI/Deepgram/ElevenLabs/Mistral
•诊断能力📊 一键导出支持日志
— — — — — — — — — —
我是atyou, 您有什么感兴趣的主题，可以给我留言让我们一起拥抱AI, 共同进步，享受美好生活。
参考文档：
•Release Notes → 点击访问
https://github.com/openclaw/openclaw/releases/tag/v2026.4.22
•OpenClaw 官网 → 点击访问
https://opencl.ai