richard0901 工具运行时流水线
这是什么
一次工具调用不是“选中工具然后跑一下”这么简单。稳定的 runtime 至少应该有这些阶段：
- 解析工具身份
- 校验输入
- 进入前置治理
- 做权限判定
- 执行工具
- 标准化结果
- 进入后置治理
- 分类处理失败
这个 skill 用来帮助你把工具执行看成一条明确的流水线，而不是散落在各处的 if/else。
在 OpenClaw 里何时使用
- 你在审计工具调用逻辑
- 你在设计新的工具接入方式
- 你在排查为什么某些工具失败后很难解释
- 你在做 hook、permission、execution 的职责划分
核心原则
- 权限判定必须是显式阶段。
- hook 是治理层，不是执行层。
- 输入错误、权限错误、运行错误、超时错误要分开。
- 工具结果要尽量标准化，方便下游处理。
- 被阻止的调用也要有结构化结果，不要像“消失了一样”。
OpenClaw 常见流水线阶段
- 识别工具与上下文
- 校验参数格式
- 前置规则或 hook 补充
- 风险判断与是否需要确认
- 实际执行
- 将结果转成可被 transcript 理解的形状
- 后处理、补充上下文、决定是否继续
- 记录 telemetry 与错误分类
实战建议
- schema 错误和 runtime 错误分开汇报。
- 删除、外发、配置修改等动作要在权限阶段明确处理。
- 工具输出过大时，结果标准化阶段就应考虑持久化或截断。
- 失败后进入 failure hook，而不是直接跳过治理层。
- 对被阻止的调用，要明确告诉模型是 blocked，不是 lost。
常见失败模式
- hook 一句话绕过核心权限。
- 所有错误都显示成“工具失败”。
- 不同工具返回形状完全不同，后续难统一。
- failure path 不经过治理层，偏偏最关键的时候没审计。
- 权限逻辑塞在工具内部，系统层完全看不清。
你可以产出的东西
- 一张工具执行阶段图
- 一份错误分类表
- 一份 hook 与 permission 的合并规则说明