**发布时间：** 2026年4月23日
**版本号：** 2026.4.22（正式版）
**更新内容总结：** 4 月下旬正式版，聚焦于 xAI 多模态能力补齐、TUI 本地嵌入模式、WhatsApp 群组/私聊系统提示词配置、本地后端 Token 统计修复以及大量稳定性和性能优化。
—
## ✨ 新功能
### 1. xAI 多模态全面支持
OpenClaw 正式支持 xAI (Grok) 的完整多模态能力，包括：
– **图像生成**：`grok-imagine-image`、`grok-imagine-image-pro`、参考图像编辑
– **语音合成 (TTS)**：6 种实时 xAI 语音，支持 MP3/WAV/PCM/G.711 格式
– **语音识别 (STT)**：`grok-stt` 音频转录、xAI 实时语音通话转录
### 2. Voice Call 流式转录扩展
除了原有的 OpenAI 和 xAI，现在支持更多提供商的实时语音转录：
– **Deepgram**：实时 STT 流式转录
– **ElevenLabs**：实时 STT + Scribe v2 批量音频转录
– **Mistral**：实时 STT 流式转录
### 3. TUI 本地嵌入模式
新增本地嵌入模式，允许在**无需 Gateway** 的情况下运行终端聊天，同时保留插件审批门控。适合离线场景和轻量级使用。
### 4. 首次配置自动安装插件
Onboarding 流程增强：首次配置时自动安装缺失的 provider 和 channel 插件，无需手动恢复，降低新手门槛。
### 5. OpenAI 原生网页搜索
OpenAI Responses 模型现在自动使用原生 `web_search` 工具进行网页搜索（当启用搜索且未固定其他搜索提供商时）。显式指定的提供商（如 Brave）仍使用托管的 `web_search` 工具。
### 6. `/models add` 命令
新增 `/models add` 命令，允许在聊天中直接注册模型并立即使用，**无需重启 Gateway**。`/models` 命令保持为简单的提供商浏览器，同时增加更清晰的添加指引和可复制的命令示例。
### 7. WhatsApp 回复引用 + 群组系统提示词
– **回复引用**：新增可配置的原生回复引用模式 (`replyToMode`)
– **群组/私聊系统提示词**：支持 per-group 和 per-direct `systemPrompt` 配置，支持 `*` 通配符回退和账户级覆盖
### 8. 会话列表筛选增强
新增 mailbox 风格的 `sessions_list` 筛选器：按标签 (label)、代理 (agent)、搜索关键词过滤，以及可见性范围派生的标题和最近消息预览。
### 9. 用户身份与个性化
Control UI 新增浏览器本地用户身份（姓名 + 本地安全头像），统一用户身份渲染路径，优化快速设置、代理回退芯片和窄屏聊天布局。
### 10. Gateway 诊断导出
新增支持就绪的诊断导出功能：包含脱敏日志、状态、健康检查、配置和稳定性快照，便于提交 Bug 报告。
### 11. Tencent Cloud 提供商插件
捆绑 Tencent Cloud 提供商插件，支持 TokenHub 引导、文档、hy3-preview 模型目录条目和分层 Hy3 定价元数据。
### 12. Amazon Bedrock Mantle 支持
新增 Claude Opus 4.7 支持，通过 Mantle 的 Anthropic Messages 路由，使用提供商拥有的 bearer-auth 流式传输，解决 AWS bearer token 与 Anthropic API key 混用问题。
—
## 🐛 修复内容
### 核心修复
1. **本地后端 Token 统计**：标记已知本地后端（vLLM、SGLang、llama.cpp、LM Studio、LocalAI、Jan、TabbyAPI、text-generation-webui）为流式用量兼容，Token 计数不再退化为未知/过时状态
2. **llama.cpp 风格用量恢复**：从 `timings.prompt_n` / `timings.predicted_n` 元数据恢复流式 Token 用量，修复兼容服务器不发出 OpenAI 格式用量对象时显示未知或过时总计的问题
3. **思考默认值提升**：将推理能力模型的隐式默认思考级别从传统 off/low 提升到 provider 支持的 medium 等效级别
4. **会话活动维护**：防止日常重置和空闲维护记账触发会话活动更新或裁剪刚刚活跃的路由
5. **WhatsApp 发送重复**：修复并发重连排水期间重复发送 cron 消息 7-12 倍的问题（30 分钟入站静默看门狗在发送中途触发时）
6. **Kimi 工具调用 ID**：停止对 Kimi K2.6 的原生 `tool_call` ID 进行严格清理，修复多轮代理流程在 2-3 轮工具调用后中断的问题
### 提供商修复
– **Azure OpenAI 图像端点检测**：支持 Azure 风格图像端点，使用 Azure api-key 认证 + 部署范围图像 URL
– **Codex OAuth 导入路径移除**：不再复制 `~/.codex` OAuth 材料到代理认证存储，改用浏览器登录或设备配对
– **Moonshot 工具调用 ID**：修复 Kimi K2.6 多轮代理流程中断
– **SDK Retry After 上限**：限制长 Retry-After 休眠，60s+ 重试窗口立即浮出供 OpenClaw 故障转移
– **Telegram 论坛主题元数据缓存**：带边界过期的缓存恢复论坛元数据，减少重复 getChat 查询
### 性能优化
– **Doctor 运行时间减少 74%**：延迟加载 doctor 插件路径，优先使用已安装插件的 `dist/*` 运行时条目
– **捆绑插件加载时间减少 82-90%**：在支持的运行时上优先使用原生 Jiti 加载
– **Linux OOM 防护**：Gateway 管理的子进程包装在 `/bin/sh` 垫片中，提升子进程的 `oom_score_adj`，在 cgroup 内存压力下内核优先终止临时工作者而非长期运行的网关
—
## ⚠️ 升级注意事项与常见问题
### 从 4.19-beta 升级必读
#### 1. Codex CLI 认证方式变更
**影响**：使用 Codex CLI 认证的用户
**变更**：`~/.codex` OAuth 材料不再自动复制到代理认证存储
**操作**：重新通过浏览器登录或设备配对进行认证
#### 2. 模型认证合并行为
**影响**：重新认证 OAuth 提供商（如 OpenAI Codex）的用户
**变更**：`openclaw models auth login` 现在合并提供商拥有的默认模型添加，而非替换 `agents.defaults.models`
**注意**：这防止重新认证时意外清空其他提供商的别名和 per-model 参数
#### 3. 本地 Whisper CLI 优先级
**影响**：安装了本地 Whisper CLI 的用户
**变更**：配置或密钥支持的 STT 提供商现在优先于自动检测的本地 Whisper CLI
**注意**：防止本地转录工具意外遮挡 Groq/OpenAI 等 API 提供商
#### 4. 思考级别默认值提升
**影响**：使用推理能力模型（Claude、GPT-o 系列等）的用户
**变更**：默认思考级别从 off/low 提升到 medium 等效
**操作**：如需禁用思考，在配置中显式设置 `thinking: off`
#### 5. WhatsApp 消息重复问题已修复
**影响**：使用 WhatsApp channel 且配置了 cron 定时任务的用户
**修复**：并发重连时不再重复发送消息 7-12 次
**建议**：升级后检查历史日志确认是否受影响
#### 6. Kimi K2.6 多轮工具调用
**影响**：使用 Moonshot/Kimi 的用户
**修复**：工具调用 ID 不再被错误清理，多轮代理流程恢复正常
**建议**：升级后测试多轮工具调用场景
### 插件兼容性检查
升级前建议运行：
“`bash
openclaw compatibility check
“`
扫描所有已安装插件，检查是否已迁移至 `openclaw/plugin-sdk/*`。
### 完整备份
升级前务必备份：
“`bash
# 备份配置目录
cp -r ~/.openclaw ~/.openclaw_backup
# 备份数据库
openclaw database backup –full
“`
### 升级命令
“`bash
# 停止服务
openclaw service stop
# 更新核心
npm install -g openclaw@2026.4.22
# 运行迁移
openclaw doctor –fix –auto-approve
# 更新插件
openclaw plugins update –all
# 启动并验证
openclaw service start
openclaw status –verbose
“`
—
## 点评
🎯 **从 beta 到正式版的跨越**。v2026.4.22 是 4.19-beta 系列的正式收官，不仅修复了 beta 版遗留的边缘问题，更带来了一系列重量级新功能。
三个最值得关注的更新：
1. **xAI 多模态补齐**——OpenClaw 对主流 AI 提供商的多模态支持趋于完整，xAI 用户终于可以用上图像生成、TTS、STT 全套能力
2. **本地后端 Token 统计修复**——vLLM、llama.cpp、LM Studio 等本地后端用户不再看到”未知”或”0%”的上下文使用，这对成本监控和调试至关重要
3. **WhatsApp 群组系统提示词**——企业用户可以为不同群组配置不同的 AI 行为指令，适配不同业务场景
升级建议：从 4.19-beta 及更早版本升级的用户，务必阅读”升级注意事项”部分，特别是 Codex 认证方式变更和思考级别默认值提升。生产环境建议先在测试环境验证后再升级。