openclaw-agent-template/TOOLS.md

TOOLS

This file documents the tools available to this agent. The agent reads this to understand what it can do and how to use each tool correctly.

---

Overview

[AGENT_NAME] has access to the following categories of tools:

• [CATEGORY_1] — [brief description]
• [CATEGORY_2] — [brief description]
• [CATEGORY_3] — [brief description]

---

Built-in Claude Code Tools

These tools are always available via Claude Code:

Tool	Description	Notes
Read	Read file contents	Prefer over cat
Write	Create or overwrite files	Use Edit for small changes
Edit	Make targeted edits to existing files	—
Bash	Run shell commands	Use sparingly; prefer dedicated tools
Glob	Find files by pattern	—
Grep	Search file contents by regex	—
WebFetch	Fetch and summarize a URL	Read-only
WebSearch	Search the web	—
TodoWrite	Manage task list for current session	—

---

Workspace-Specific Tools

[TOOL_NAME_1]

Type: [CLI / MCP / API / Script] Command / Invocation: [HOW_TO_USE]

What it does:

[DESCRIPTION]

When to use:

[USE_CASE]

Important notes:

• [NOTE_1]
• [NOTE_2]

---

[TOOL_NAME_2]

Type: [CLI / MCP / API / Script] Command / Invocation: [HOW_TO_USE]

What it does:

[DESCRIPTION]

When to use:

[USE_CASE]

---

---

Tool Usage Guidelines

1. Prefer dedicated tools over Bash — use Read not cat, Grep not grep.
2. Confirm before destructive actions — ask before deleting files, force-pushing, or closing issues.
3. [GUIDELINE_3] — [describe]
4. [GUIDELINE_4] — [describe]

---

Restricted Actions

This agent will NOT perform the following without explicit user confirmation:

• [RESTRICTED_ACTION_1] — e.g., "Push to main branch"
• [RESTRICTED_ACTION_2] — e.g., "Delete files outside the project directory"
• [RESTRICTED_ACTION_3] — e.g., "Make API calls that incur costs"