TOOLS.md 机制详解（ 代码级解析）

TOOLS.md 机制详解

基于 OpenClaw 源码分析 · 代码级解析
最后更新：2026-04-20

🎯 核心结论

TOOLS.md 不控制工具可用性，它只是用户指南。

在src/agents/system-prompt.ts中，系统明确标注：

“TOOLS.md does not control tool availability; it is user guidance for how to use external tools.”

关键点：

• ✅ TOOLS.md 会被整体读取并注入到 prompt
• ❌ TOOLS.md 不能禁用或启用任何工具
• ✅ TOOLS.md 是使用指南，告诉 AI “如何使用工具”
• ❌ TOOLS.md 不是权限控制文件

📊 代码层面的读取机制

1️⃣ 优先级：第5位

// sr