OpenClaw 系统提示词
OpenClaw 系统提示词1. 课程内容课程概述2. 📂 切换工作区3. AGENTS.md4. SOUL.md5. IDENTITY.md6. HEARTBEAT.md7. 🛠️ TOOLS.md8. 👤 USER.md9. 🧠 MEMORY.md
1. 课程内容
课程概述
- 💡 OpenClaw 采用了一套**"文件即提示词"** 的创新架构——AI Agent 的行为、身份、记忆、工具使用规则等，全部通过工作区（Workspace）中的多个 Markdown 文件来定义和加载。
2. 📂 切换工作区
-
openclaw的系统提示词、skills技能都存放在：
$HOME/.openclaw/workspace工作区路径下 -
orinnano主板出厂预设了中英文不同的工作区内容，内容含义相同，只在语言上有差异
-
不同地区的用户可根据需求自行切换openclaw工作区文档的语言
-
中文工作区（提示词、skills技能内容为中文）
cd /home/jetson/Language sudo cp -a workspace_zh/. ~/.openclaw/workspace/
- 英文工作区（提示词、skills技能内容为英文）
xxxxxxxxxx cd /home/jetson/Language sudo cp -a workspace_en/. ~/.openclaw/workspace/
- 配置完成后重启openclaw 网关,生效配置
xxxxxxxxxx openclaw gateway restart
Warning
$HOME/.openclaw/workspace路径下的.workspace_en、.workspace_zh隐藏文件夹是中英文模板文件，建议不要进行修改
3. AGENTS.md
- 功能说明
AGENTS.md 定义了 Agent 在工作区中如何运作的最顶层规范。📖 可以理解为 Agent 的**"使用说明书"** ——告诉 Agent 如何启动、如何管理记忆、哪些事情可以做、哪些事情绝对不能做
- 内容结构
AGENTS.md 主要包含以下几个核心板块：
| 板块 | 作用描述 |
|---|---|
| 首次运行 | 引导 Agent 首次启动时的初始化流程（读取 BOOTSTRAP.md） |
| 机械身躯 | 描述 Agent 的物理载体（机械臂、底盘、摄像头）及控制方式 |
| 会话启动 | 规定每次会话的启动流程和文件读取顺序 |
| 记忆系统 | 定义每日记录和长期记忆的分层架构 |
| 红线规则 | 列出绝对禁止的行为（破坏性命令、修改机器人程序代码） |
| 操作规范 | 区分可自由执行的操作和需先询问的操作 |
| 记忆维护 | 心跳期间的记忆整理和更新机制 |
Note
⚠️ 出厂的 AGENTS.md 提示词中限制 OpenClaw 禁止修改机器人程序代码
4. SOUL.md
- 功能说明
SOUL.md 就是 Agent 的**"灵魂"和内核** 🧠。它定义了 Agent 在面对任务时的思考方式和行为准则——如何控制机器人身体、如何查找和使用技能、如何规划和执行动作、以及在什么情况下应该暂停或拒绝执行。SOUL.md 塑造了 Agent 作为"机器人操作者"的核心行为模式。
- 工作原理
SOUL.md 在会话启动时被 Agent 读取，作为任务执行的底层指导原则。它不规定具体的技能参数，而是规定 Agent 在遇到任何任务时应该以什么样的思维流程去处理 。例如，Agent 被强制要求在任何任务开始前必须先查技能库，不能凭感觉或记忆直接执行——这个"先查文档再做事"的习惯就是由 SOUL.md 定义的。
5. IDENTITY.md
- 功能说明
IDENTITY.md 定义了 AI Agent 的自我认知和人格特征 。它定义了 Agent "是谁"——它的名字、性格、语言风格和基本身份定位。这份文件让 Agent 在与用户交互时拥有一致的个性。
- 工作原理
在每次会话启动时，Agent 读取 IDENTITY.md 并以此建立"自我认知"。这份信息会影响 Agent 回答问题的语气、主动提供帮助的方式、以及与用户建立关系的风格。例如，一个被设定为"友好、温和"的 Agent，在回复用户时会自然地使用更亲和的语言表达方式。
6. HEARTBEAT.md
- 功能说明
HEARTBEAT.md 是 OpenClaw 中控制心跳检测机制 的配置文件 ⏰。心跳机制允许 Agent 在没有用户主动发起会话的情况下，定期"醒来"执行一些后台检查和维护任务。这类似于机器人自动定时巡检——Agent 可以在后台默默地完成记忆整理、状态检查等工作。
- 工作原理
OpenClaw 网关会定期检查 HEARTBEAT.md 文件的内容，来决定是否需要触发 Agent 的心跳 API 调用：
- 文件为空或仅包含注释 ：跳过心跳调用，Agent 不会在后台被唤醒
Note
💤 机器人的出厂配置中，心跳机制默认处于关闭状态。
7. 🛠️ TOOLS.md
- 功能说明
TOOLS.md 是 Agent 的工具使用本地化笔记 📝。在 OpenClaw 体系中，"技能（Skills）"定义了工具的通用工作方式，而 TOOLS.md 则记录 Agent 自身的特有配置和个性化设置。简单来说：Skills 是说明书（通用的），TOOLS.md 是你的个人笔记（独有的）。
- 工作原理
在会话中，Agent 既会读取相关的 Skills 技能文档来了解工具的通用用法，也会读取 TOOLS.md 来获取与自己部署环境相关的特有配置。
8. 👤 USER.md
- 功能说明
USER.md 是 Agent 用来了解和记忆用户信息 的专属文件 。如果说 IDENTITY.md 是 Agent 了解"我是谁"的窗口，那么 USER.md 就是 Agent 了解"你在和谁打交道"的窗口。它记录了用户的基本信息、喜好、项目背景等上下文信息，帮助 Agent 提供更加个性化和贴心的服务。
- 工作原理
在每次会话启动时，Agent 按照 AGENTS.md 规定的流程读取 USER.md。通过该文件，Agent 能够：
-
知道如何称呼用户（姓名、称呼方式）
-
了解用户的时区、偏好等背景信息
-
记住用户关心的事情和正在进行的项目
9. 🧠 MEMORY.md
- 功能说明
MEMORY.md 是 AI Agent 的长期记忆文件 📚。在 OpenClaw 的记忆体系中，存在两个层次的记忆存储：
-
📓 每日记录 （
memory/YYYY-MM-DD.md）：记录每天发生的原始事件和对话日志，类似于人类的"日记" -
🗂️ 长期记忆 （
MEMORY.md）：从每日记录中提炼出的精华信息，类似于人类的"长期记忆"——包含重要事件、学到的经验、关键的决策和见解
- 工作原理
MEMORY.md 的加载和使用遵循以下规则：
-
仅在主会话中加载 ：当用户与 Agent 直接对话时，Agent 会读取 MEMORY.md 获取长期记忆
-
由 Agent 自主维护 ：Agent 可以在主会话中自由读取、编辑和更新 MEMORY.md
Note
在用户实际使用中可以进行：
-
✏️ 主动写入重要信息 ：将你认为 Agent 应该长期记住的内容直接写入 MEMORY.md
-
👀 观察 Agent 自主维护 ：在 Agent 运行一段时间后，查看 MEMORY.md 中自动积累的内容
-
🔄 管理记忆内容 ：定期检查并整理 MEMORY.md，移除过时信息，确保长期记忆保持精炼和准确