30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
---
|
||
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 所属的框架
|
||
|