---
title: "TOOLS.md"
type: concept
tags: [OpenClaw, Agent, Tools]
sources: [万字讲透openclaw-workspace深度解析-2026-03-21]
last_updated: 2026-03-21
---

## Definition

**TOOLS.md** 是 OpenClaw workspace 中声明**工具权限与使用规范**的文档。它的核心价值不在于列出工具名，而在于把"什么时候该用、什么时候不该用"写清楚。

## 核心作用

- **减少工具误用**：明确说明什么情况下不用某个工具，比"什么时候用"更有效
- **降低权限越界风险**：把限制规则固化在 workspace 里，不需要每次在对话里重申
- **与 openclaw.json 互补**：系统层决定"能不能用"，TOOLS.md 帮助 Agent 理解"该不该用"

## 应包含的内容

- **可用工具列表**：Read/Write/Edit、Bash、Glob/Grep、sessions_spawn、memory_get/memory_search 等
- **使用原则**：文件操作优先用 Read/Write/Edit，避免直接用 Bash 的 cat/echo
- **受限工具**：需要用户明确授权才使用的工具（如 browser）

## Related Concepts

- [[AGENTS.md]] — 工作说明书，与 TOOLS.md 共同定义 Agent 行为
- [[OpenClaw]] — TOOLS.md 所属的框架