nexus/wiki/concepts/TOOLS.md

title, type, tags

title	type	tags
TOOLS.md	concept	OpenClaw Agent

定义

TOOLS.md 是 OpenClaw workspace 中的工具权限声明与使用规范文件，定义 Agent 可用工具及其使用原则。

职责

• 列出可用工具（Read/Write/Edit、Bash、Glob/Grep、sessions_spawn、memory_get/memory_search 等）
• 规定工具使用原则（优先使用文件操作工具、避免硬编码路径、批量修改前先确认内容）
• 明确受限工具（browser、文件删除操作需要用户授权）

核心价值

• 减少工具误用：明确说明什么情况下不用某个工具
• 降低权限越界风险：把限制规则固化在 workspace 里
• 与 openclaw.json 形成互补：系统层决定"能不能用"，TOOLS.md 帮助理解"该不该用"

典型结构

# TOOLS
## 可用工具
- **Read / Write / Edit**：文件读写
- **Bash**：执行 shell 命令
- **Glob / Grep**：文件搜索

## 使用原则
- 文件操作优先用 Read/Write/Edit，避免直接用 Bash 的 cat/echo
- 路径操作使用相对路径，不要硬编码绝对路径

## 受限工具
- **browser**：网页浏览，只在用户明确要求时调用

来源

• 万字讲透OpenClaw🦞从"能用"到"真好用"的分水岭：Workspace 深度解析

相关

• Workspace：包含 TOOLS.md 的工作台目录
• AGENTS.md：与 TOOLS.md 配合定义 Agent 行为