# Tool Runtime Pipeline

> 面向 OpenClaw 的工具运行时流水线技能。用于设计或审计 read/write/edit/exec/browser/cron/message 等工具从输入校验到权限判定、执行、结果标准化与失败分类的完整链路。

- Skill: `richard0901/tool-runtime-pipeline` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add richard0901/tool-runtime-pipeline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/richard0901/tool-runtime-pipeline/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: richard0901 (https://skillmd.com/u/richard0901)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/richard0901/tool-runtime-pipeline

---


# 工具运行时流水线

## 这是什么

一次工具调用不是“选中工具然后跑一下”这么简单。稳定的 runtime 至少应该有这些阶段：

1. 解析工具身份
2. 校验输入
3. 进入前置治理
4. 做权限判定
5. 执行工具
6. 标准化结果
7. 进入后置治理
8. 分类处理失败

这个 skill 用来帮助你把工具执行看成一条明确的流水线，而不是散落在各处的 if/else。

## 在 OpenClaw 里何时使用

1. 你在审计工具调用逻辑
2. 你在设计新的工具接入方式
3. 你在排查为什么某些工具失败后很难解释
4. 你在做 hook、permission、execution 的职责划分

## 核心原则

1. 权限判定必须是显式阶段。
2. hook 是治理层，不是执行层。
3. 输入错误、权限错误、运行错误、超时错误要分开。
4. 工具结果要尽量标准化，方便下游处理。
5. 被阻止的调用也要有结构化结果，不要像“消失了一样”。

## OpenClaw 常见流水线阶段

1. 识别工具与上下文
2. 校验参数格式
3. 前置规则或 hook 补充
4. 风险判断与是否需要确认
5. 实际执行
6. 将结果转成可被 transcript 理解的形状
7. 后处理、补充上下文、决定是否继续
8. 记录 telemetry 与错误分类

## 实战建议

1. schema 错误和 runtime 错误分开汇报。
2. 删除、外发、配置修改等动作要在权限阶段明确处理。
3. 工具输出过大时，结果标准化阶段就应考虑持久化或截断。
4. 失败后进入 failure hook，而不是直接跳过治理层。
5. 对被阻止的调用，要明确告诉模型是 blocked，不是 lost。

## 常见失败模式

1. hook 一句话绕过核心权限。
2. 所有错误都显示成“工具失败”。
3. 不同工具返回形状完全不同，后续难统一。
4. failure path 不经过治理层，偏偏最关键的时候没审计。
5. 权限逻辑塞在工具内部，系统层完全看不清。

## 你可以产出的东西

1. 一张工具执行阶段图
2. 一份错误分类表
3. 一份 hook 与 permission 的合并规则说明