夜雨聆风本周 OpenClaw 推了 6 条更新，里面有两类东西值得认真对待：一类是你不做就会挂的 Breaking Changes，一类是平时感知不到但影响实际可用性的基础能力补齐。外部没有特别值得单独展开的内容，所以本期以官方更新为主线。
xAI 彻底换到 Responses API，顺带塞进来 x_search
这条更新（#56048）的幅度比看起来大。`xAI` 的 bundled provider 从旧接口迁移到了 Responses API，同时新增了一个一等公民工具 `x_search`。
最重要的连带效应：你不需要再手动开 xAI plugin 了。以前用 Grok + 内置搜索，需要在配置里手动 toggle plugin，稍微绕一点。现在只要你配了 web-search 或者 tool config，xAI plugin 会自动启用，整个认证 + 搜索流程直接跑通。
`x_search` 的意义在于：它是第一个被正式塞进 OpenClaw 工具链的 x.com 原生搜索，不是绕道 Tavily/Serper 再加一层包装，而是直接走 xAI 自己的 Responses API。对于想用 Grok 做实时信息检索的场景，这条链路从此变得干净很多。
如果你之前配置了 Grok 并且手动管理过 plugin 状态，现在是个好时机清一遍配置，把多余的手动 toggle 去掉，让自动化机制接管。
Config/Doctor 刀到了：老 key 不再自动修复，直接报错
这条 Breaking Change 比较静默，但对长期运行的实例影响实际。
之前 `openclaw doctor` 会在加载时自动把过时的配置 key 迁移成新格式，相当于一个向后兼容的自动修复机制。现在超过两个月的历史迁移规则已经被移除，如果你的配置文件里还有非常老的 legacy key，不再是"加载时静默重写"，而是直接校验失败。
这个改动的逻辑是对的：积累 migration 规则本身就是技术债，某个时间点得切干净。但对于跑在服务器上没人盯着的长期实例，配置文件漂移是真实风险——你三个月前建的 agent，它的配置文件可能从没被主动清理过。
现在就去跑一次 `openclaw doctor`，不要等到某天任务挂了才回头查。 如果你有多个 workspace 或 agent profile，逐个检查比事后救火省力得多。
顺便说一点：这条改动也印证了 OpenClaw 在加速"去向后兼容"。两个月这个窗口比大多数工具短，说明项目迭代速度很快，维护成本不允许无限期保留旧路径。跟上节奏的代价是定期做一遍配置审计，这没什么捷径。
Qwen 认证方式切换，Portal OAuth 正式退场
`qwen-portal-auth` 这条 OAuth 集成被移除了（#52709），不再支持通过 `portal.qwen.ai` 做授权。
迁移路径很明确：`openclaw onboard --auth-choice modelstudio-api-key`，改成 Model Studio 的 API Key 方式。如果你之前用 Qwen 模型跑任何 agent，现在必须重新 onboard，不做就直接失效。
这次改动背后有个趋势：平台级 OAuth 集成一旦维护成本升高，就会被直接砍掉，换成更标准的 API Key 方式。用户侧更透明可控，维护方也少一条依赖链。权衡来说不是坏事，但这种"直接 Breaking"的处理方式意味着你得保持对 Changelog 的关注，不能假设现有配置永远有效。
Gateway 补了两个洞：/v1/models 和 /v1/embeddings
这条更新（v2026.3.24）低调但实用。Gateway 的 OpenAI 兼容层新增了两个端点：
- `/v1/models`：让客户端能正确列出可用模型，很多工具在初始化阶段会先探测这个端点，之前缺失会导致兼容层用起来磕磕绊绊
- `/v1/embeddings`：嵌入向量接口，对接 RAG pipeline 的关键一环，之前得绕道或自己包装
- 显式 model override 透传：通过 `/v1/chat/completions` 和 `/v1/responses` 传入的 model 参数现在能正确透传，不会被 Gateway 层覆盖掉
如果你在用 Gateway 接外部工具或者自建 RAG，这次更新之后值得重新测一遍兼容性，可能有些之前绕开的问题现在已经直接解了。
/tools 终于能告诉你"现在能用什么"
Agent 开发里有个持续性的痛点：你不确定当前 agent 实际挂载了哪些工具，只能靠记忆或者翻配置文件猜。这次 `/tools` 命令做了比较实质的改进：
- 显示的是当前 agent 实际可用的工具，不是全局工具列表
- 增加了 compact 默认视图 + 可选的 detailed mode
- Control UI 里加了 "Available Right Now" 实时区域，在你问问题之前就能看到工具状态
本周踩坑：API 限速连着挂了好几天
从日志里看，3/27 到 3/28 Anthropic API 连续出现大规模 429 rate_limit_error，覆盖了心跳检测、彩票监控和早晨 7/8 点的两个定时任务。主要现象是 cron 触发了但 session 里完全没有 assistant 回复——任务不报错，只是静默失败。
这个问题的难点在于诊断：任务"看起来跑了"但实际没产出，如果没有结果验证机制，你可能完全不知道某天的数据没拿到。对于依赖定时 agent 的场景，光检查 session 文件是否存在不够，还得检查里面有没有有效的 assistant turn。
另一个本周修掉的问题：生成文章时用 `claude --print` 把 prompt 拼进 shell 命令，遇到反引号直接触发 `/bin/sh: Syntax error: EOF in backquote substitution`。改成 `execFileSync('claude', [...args])` 就解了，参数不过 shell，这类注入风险直接消失。这个模式可以推广：任何把用户内容或 AI 生成内容拼进 shell 命令的地方，优先考虑 execFile 绕过 shell 解析层。
一句话总结本周
xAI 迁移 Responses API + `x_search` 是本周最值得测的新功能；`openclaw doctor` 和 Qwen 重新 onboard 是必须做的维护动作；Gateway 的 OpenAI 兼容层补齐让 drop-in 替代的可行性又上了一个台阶。API 限速是个持续风险，结果验证不能省。
