—# OpenClaw 2026.5.5 更新解读：10 项关键修复与性能优化全解析
OpenClaw 2026.5.5 版本聚焦于多平台消息网关稳定性、大语言模型兼容性以及控制界面响应性能三大核心领域。本次更新修复了 10 个关键问题，涵盖飞书话题会话、Discord 心跳机制、xAI/Grok 模型调用等高频使用场景，显著提升了 AI Agent 在生产环境中的可靠性。
—
一、消息平台兼容性修复
1.1 飞书（Feishu）：话题会话一致性保障
飞书用户长期面临的首轮对话与跟进消息分散在不同会话的问题终于得到解决。本次修复确保 native topic starter thread IDs 在会话路由前完成补全，使同一话题内的所有交互保持在统一会话上下文中。
影响场景：使用飞书进行多轮任务协作的企业用户，对话连续性体验提升显著。
1.2 LINE：私信策略验证强化
针对 dmPolicy: "open" 配置的安全隐患，OpenClaw 现在会在 webhook 阶段主动拒绝缺少通配符 allowFrom 的配置。这一变更将潜在的静默阻断转化为明确的验证失败，帮助开发者更早发现配置错误。
错误配置示例（将被拒绝）
dmPolicy: "open"
allowFrom: [] # 缺少通配符
正确配置
dmPolicy: "open"
allowFrom: ["*"] # 明确允许所有来源
1.3 Telegram/Codex：工具进度渲染优化
Codex 工具调用时的消息重复问题得到修复。现在系统会保持仅含工具进度的草稿可见性，并确保每个工具的原生进度仅渲染一次，消除冗余的 item/tool 草稿行。
—
二、大语言模型提供商适配
2.1 xAI/Grok：推理参数兼容性修复
针对 xAI 提供商的两项关键调整解决了 xai/grok-4.3 模型的运行时故障：
| 修复项 | 变更内容 | 解决的问题 |
|:—|:—|:—|
| 推理 effort 控制 | 停止向原生 Grok Responses 模型发送 OpenAI 风格的 reasoning_effort 参数 | Invalid reasoning effort 错误 |
| Thinking profile 限制 | 将 bundled xAI thinking profile 强制设为 off | 防止发送不支持的推理级别 |
这两项修复确保 Docker 和 Gateway 模式下的实时运行稳定性。
—
三、网关与基础设施稳定性
3.1 Discord：心跳机制与指令路由双修复
心跳 ACK 超时计算优化：超时计时现在从实际心跳发送时刻开始，而非连接建立时刻。这消除了因初始心跳延迟导致的误重连循环（Issue #77668）。
控制指令授权修复：/steer 等纯文本控制指令现在经过正常的授权和提及门控流程，不再在 Agent 会话可见前被静默丢弃。
3.2 Matrix：审批消息重试机制
审批提示的投递失败不再导致请求滞留。系统现在执行最多 3 次重试，配合短退避策略，有效应对瞬时的 Matrix 发送故障。
—
四、Control UI 性能与体验升级
4.1 会话管理界面重构
- 紧凑化展示：检查点数量采用
N Checkpoint(s)折叠式披露 - 现代化卡片：响应式表格布局中展示扩展的会话级详情与检查点历史
4.2 响应性能优化
| 优化场景 | 具体改进 |
|:—|:—|
| 历史载荷加载 | 保持聊天/频道标签页响应性 |
| 频道探测 | 标注部分频道状态，避免阻塞 |
| 渲染性能 | 慢速聊天/配置渲染耗时记录至事件日志 |
4.3 会话生命周期钩子修复
/new 命令和生命周期钩子现在仅在通过 Control UI 显式创建会话时触发。这一变更恢复了 SDK 父会话创建时的会话内存隔离和自定义钩子捕获能力，解决 Issue #76957。
—
五、安全与跨平台修复
5.1 Windows 执行审批文件操作
针对 Windows 系统拒绝重命名覆盖操作的问题，系统现在回退到受保护的复制策略，同时保留符号链接、硬链接和仅所有者权限等安全机制。
5.2 Slack 错误日志增强
Socket Mode SDK 错误上下文和结构化 Slack API 字段现在完整保留在重连日志中，启动失败不再简化为模糊的 unknown error。
5.3 iOS 配对灵活性提升
| 场景 | 协议选择 |
|:—|:—|
| 私有 LAN / .local 网关 | 允许 ws:// + 设置码/手动连接 |
| Tailscale / 公共路由 | 强制 wss:// |
| 混合认证重连 | 优先使用显式网关密码，而非过期的引导令牌 |
—
常见问题解答 (FAQ)
Q1: 升级到 2026.5.5 是否需要修改现有配置？
不需要。除 LINE 的 dmPolicy: "open" 配置需要补全 allowFrom 外，其他修复均为向后兼容的缺陷修复。建议检查 LINE 相关配置以避免启动验证失败。
Q2: xAI/Grok 模型用户需要关注哪些变更？
如果您使用 xai/grok-4.3 或更高版本，本次更新解决了 Docker/Gateway 模式下的 Invalid reasoning effort 错误。升级后无需调整模型调用代码。
Q3: Control UI 的 /new 命令行为变化会影响现有自动化流程吗？
不会。该变更仅区分 Control UI 显式创建与 SDK 父会话创建的场景，恢复的是原本应有的行为一致性。自动化 SDK 调用不受影响。
Q4: 如何验证 Discord 心跳修复是否生效？
观察网关日志中的重连频率。修复前因误触发导致的频繁重连（Issue #77668）应显著减少，频道就绪前的连接稳定性提升。
Q5: iOS 配对支持哪些私有部署场景？
支持 mDNS .local 域名、私有 IP 段的 ws:// 连接，以及 Tailscale 等 overlay 网络的 wss:// 连接。混合场景下密码优先策略提升了重连可靠性。
—
总结与下一步
OpenClaw 2026.5.5 通过 10 项精准修复，显著提升了多平台消息网关的稳定性、主流 LLM 的兼容性以及控制界面的用户体验。建议所有生产环境用户尽快升级。
推荐操作：
1. 查阅 OpenClaw 升级指南 执行版本更新
2. 验证 LINE 配置的 allowFrom 字段完整性
3. 监控 Discord 网关重连日志确认修复效果
—
相关阅读
—
参考来源
