OpenClaw 升级复盘（一）：subagent 派发为什么会被脏参数绊倒

type

Post

status

Published

date

Apr 29, 2026

slug

openclaw-upgrade-subagent-parameter-sanitization

summary

从 runtime="subagent" 混入 ACP 字段说起，复盘一次参数污染、调度层清洗与系统免疫化修复。

这类故障最烦的地方，不是它难修，而是它特别容易把排查方向带偏。因为最终表现是“派发失败”，人第一反应会去怀疑 OpenClaw 版本、runtime 健康度，甚至怀疑整条分身链路坏了。

但拆开看，真正的问题是：ACP 和原生 subagent 在心智上被混成了一类请求，而两者允许的字段集合并不一样。

根因不是某个字段“写错”这么简单，而是调度层没有建立“先判 runtime，再裁字段”的硬规则。

也就是说，请求构造阶段没有先判断：如果 runtime != ACP，那么所有 ACP 专属字段都应该被视为非法输入。

这让报错点暴露得太靠后：不是构造请求时就被消解，而是等到底层接口再失败。结果就是排查成本被放大，运行时看起来像背锅对象。

真正有效的修法，不是“提醒以后别带错参数”，而是把错误条件本身消掉。

这背后的设计思路很重要：不要让操作者靠记忆规避坑，而要在调度层前置完成字段清洗。这样即使上层再次混入脏参数，最终发出的 subagent 请求仍然是干净的。

从工程视角看，这件事的价值不在“某次派发修好了”，而在“以后同类派发天然更稳”。

一次临时修补，只能解决当前错误；一次调度层免疫，解决的是错误生成的条件。

这才叫真正完成，而不是“这次恰好没炸”。

结论很简单：这次升级后，OpenClaw 的任务派发不只是“又能用了”，而是从容易被脏参数绊倒，进化成了更有免疫力的调度链。