OpenClaw 24h 更新快报（2026-03-22）：Discord 图像投递、运行时路径保全、vitest 线程裁剪

过去 24 小时，OpenClaw 主线分支合并了一个影响 Discord 渠道图像生成体验的关键修复：当用户请求 OpenClaw 生成图像并投递到 Discord 时，媒体文件此前可能在回复路径中丢失，只有文本到达用户。同时，维护者针对 secrets 快照机制补全了运行时 PATH 环境变量的保留逻辑，并裁剪了 vitest 的线程覆盖参数以压缩 CI 资源占用。

渠道集成：Discord 图像投递路径修复

PR #52489 解决了 Discord 渠道图像投递链路上的三个问题。首先，Discord 出站文件名传递断裂——生成的图片虽已落地本地，但附件从未进入发送队列，导致 Discord 只收到文字回复而没有图片。其次，OpenAI 图像 API 的 aspect ratio 参数（16:9、21:9 等宽屏比例）在部分情况下会映射到平台不支持的尺寸而静默失败，修复后转为明确映射到 API 支持的尺寸（1024×1024、1792×1024 等）。第三，当 text block streaming 关闭时，携带媒体信息的 block 回复会被错误地阻隔在缓冲队列中，新逻辑确保含媒体的 block 始终走独立投递路径。

改动涉及多个层级：Discord 出站模块 send.outbound.ts、OpenAI 图像 provider openai.ts、通用回复投递 reply-delivery.ts，以及对应的测试覆盖。值得注意的是，该修复没有在 Discord 模块中做任何渠道级别的特殊判断，而是将逻辑收敛到共享的 reply/runtime 管道中，这意味着其他渠道（WhatsApp、Feishu 等）的媒体 block 回复也会受益于此番重构。

对于已在使用 OpenAI gpt-image 系列模型通过 OpenClaw 生成图像并投递到 Discord 的用户，这是过去一段时间内最影响实际体验的 bug 之一——系统回复"图像已生成"但 Discord 端只有文字，新版已彻底弥合这一落差。

安全与稳定性：secrets 快照路径保全、gateway 认证加固

commit 24b9bae（steipete）在 secrets 快照保存流程中新增了对运行时 PATH 环境变量的保留。在容器化或分布式环境中，凭证分发时的 PATH 信息若被截断，会导致依赖路径查找的工具链（如 exec 类工具）出现非预期行为。新修复确保快照恢复后路径信息完整。

同作者的另一枚提交 commit 47e8ffc 则修复了当前 main gate 中 no-isolate 模式下的 gateway 认证与配对回归测试。这类回归往往在并发认证流程压力下才会暴露，修复验证了无隔离模式（shared namespace）下身份验证状态机的正确性，对使用单实例部署的用户有直接意义。

构建与测试：vitest 线程参数裁剪

为降低 CI 资源占用，commit d907ebf 裁剪了 vitest 配置中的线程覆盖参数。vitest 默认会基于 CPU 核心数自动推断线程池大小，手动设置过高会浪费调度开销，尤其在共享 CI 节点上影响并行流水线的整体吞吐。调整后测试套件执行效率预期有所提升，且不影响测试覆盖范围。

文档改进

多位贡献者同步更新了文档质量：commit 196c07c 修正了 FAQ 页面的破损锚点（#how-does-openclaw-load-environment-variables → #env-vars-and-env-loading），涉及 tools/web.md 和 perplexity-search.md；commit ad014653 将工具文档中过时的"Web tools"链接文本更新为"Web Search"，提升开发者导航准确性；commit d1ad48c 对齐了 sdk-runtime、sdk-testing、sdk-setup 等文档的 frontmatter 标题与实际 H1 标题，减少搜索引擎索引混乱；commit d6c6316 修正了 memory 加载、WhatsApp 媒体能力标注以及 Signal reaction mode 的文档描述。

本轮更新基调偏向缺陷修复与质量加固，Discord 媒体投递链路和 secrets 快照路径是两个最具实际影响的变化，建议相关用户确认现有部署行为是否符合预期。