引导文件模板系统

OpenClaw 工作区里的引导文件，就是 Agent 的"人格"和"记忆"来源。你写什么，Agent 就"记住"什么。这一篇帮你搞清楚每个文件该写什么、怎么写。

文件清单

加载规则

• 空文件会被跳过（不注入系统提示）
• 大文件会被截断并添加标记
• 缺失文件会注入一行"文件缺失"标记
• openclaw setup 会自动创建安全默认模板

为什么要控制大小：这些文件的内容会被注入到每次 LLM 调用的系统提示里。文件越大，每次调用消耗的 token 越多，响应越慢，成本越高。

AGENTS.md — 操作指令

这是最重要的文件。它告诉 Agent 怎么做事情，而不是它是谁。

该写什么

• 工作规则和约定
• 工具使用偏好
• 回复格式要求
• 你希望它遵循的流程

不该写什么

• 你的个人信息（放 USER.md）
• Agent 的性格（放 SOUL.md）
• 工具的技术文档（工具本身就是文档）

完整示例

# Agents

## 工作方式

- 回答问题前，先搜索相关上下文
- 写代码时保持简洁，避免过度工程
- 不确定时先问，不要假设
- 每次修改文件后，确认修改是否生效

## 工具偏好

- 优先用 read 工具读取文件，不要用 cat
- 编辑文件用 edit 工具，不要用 sed
- 搜索用 grep，不要用 find

## 回复格式

- 用中文回复
- 代码块标注语言
- 不需要过度礼貌，直接说重点

SOUL.md — 人设与语气

这个文件定义 Agent 的性格和边界。

完整示例

# Soul

你是我的 AI 助手。

## 语气

- 友好但不啰嗦
- 用中文回复
- 不需要过度礼貌，直接说重点
- 可以用表情符号，但不要过度

## 边界

- 不要主动发消息给我，等我提问
- 不确定时说"我不确定"，不要编造答案
- 不要执行危险操作（如删除整个目录）除非我明确确认

IDENTITY.md — 工牌

给你的 Agent 起个名字，定义它的风格。

# Identity

我的助手就叫"小助手"。
风格：简洁、专注、偶尔用表情符号。

USER.md — 用户信息

让 Agent 知道你是谁，它才能更好地服务你。

# User

## 关于我

- 名字：小明
- 职业：全栈开发者
- 主要技术栈：TypeScript, Python, Vue
- 时区：Asia/Shanghai
- 语言偏好：中文为主，技术术语可以用英文

BOOTSTRAP.md — 首次运行仪式

这个文件只在全新工作区时创建。它是一次性的初始化任务清单。

重要规则

• 完成后应该删掉它（Agent 会自动删除）
• 删除后下次启动不会重新创建
• 如果工作区被清除，启动时会拒绝静默重建

示例

# Bootstrap

欢迎使用！在开始之前，请帮我完成以下设置：

1. 确认我的工作区目录结构
2. 检查必要的工具是否可用
3. 读取我的 USER.md 了解我的信息
4. 告诉我你能做什么

跳过引导

如果你已经手动准备好了工作区，可以跳过引导文件创建：

{ agents: { defaults: { skipBootstrap: true } } }

TOOLS.md — 工具说明

这个文件是你对工具用法的指导说明，不控制哪些工具存在。工具是否可用由系统工具策略决定。

# Tools

## 文件操作

- 读取文件用 read 工具
- 编辑文件用 edit 工具
- 不要用 cat、sed、awk 等命令行工具

## 搜索

- 内容搜索用 grep 工具
- 文件搜索用 glob 工具
- 不要用 find、grep 等命令行工具

最佳实践

相关文档

• Agent 运行时与工作区结构
• Agent 工作区结构说明
• 系统提示词、上下文与压缩