41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
---
|
||
title: "TOOLS.md"
|
||
type: concept
|
||
tags: [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 帮助理解"该不该用"
|
||
|
||
## 典型结构
|
||
```markdown
|
||
# 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 行为 |