OpenClaw MD文件

2026-05-17 14:56:24 · md openclaw

文件位置： ~/.openclaw/ workspace

这是整个 OpenClaw 设置中最重要的文件。如果说大模型是一个员工，AGENTS.md 就是它的“员工手册”和“核心业务流程”。

控制内容：智能体的核心任务、工作流、日常执行的指令、具体的行为准则以及多渠道处理规则。
适用场景：在这里写下你希望它为你做什么（例如：“每当我发送一个网页链接，你必须总结它的核心内容”、“如果是在 Discord 频道中，除非被 @ 否则不要发言”）。

如果说 AGENTS.md 决定了 AI “做什么”，那么 SOUL.md 就决定了 AI “怎么说”。它赋予智能体独特的性格、语气和价值观。

控制内容：
- 角色定位：名字、职位（例如：“你是 Aria，Meridian 公司的资深技术支持”）。
- 沟通风格：语气（如“幽默风趣”、“严谨精炼，绝不废话”、“多用 Emoji 互动”）。
- 硬性边界（安全限制）：绝对不能触碰的红线（例如：“永远不要透露内部定价公式”、“严禁提供任何法律或医疗诊断建议”）。
作用：确保 AI 的回复具有一致的身份认同，避免在不同会话中表现得像个多重人格。

这是一个轻量级的文件，主要用来给 OpenClaw 系统（Gateway 路由层）读取智能体的一些基本元数据。

控制内容：智能体在平台上的显示名称、系统内部的 Agent ID（用于多智能体路由分发）、代表它的 Emoji 或头像等。
示例：
- Name: 龙虾助手
- Agent ID: personal-assistant
- Vibe: 聪明、执着、带点幽默感的解决问题专家
注意：这个文件应该保持精简，复杂的行为逻辑不要写在这里，应该写在 SOUL.md 或 AGENTS.md 中。

这个文件用来告诉 AI “你是谁”。它建立了 AI 与你之间的契约和信任关系，让 AI 在第一天就拥有关于你的上下文。

OpenClaw 拥有独特的记忆管理机制。在长时间对话中，聊天记录会因为超出 Token 限制而被压缩（Compaction），但写在 MEMORY.md 里的内容永远不会被压缩丢失。

控制内容：长期有效的客观事实、你根深蒂固的偏好、跨越数周的关键决策摘要。
工作机制：在上下文即将满、系统触发自动压缩（Memory Flush）前，OpenClaw 会默默运行一个回合，把本轮对话中重要的信息提炼并写入 MEMORY.md，从而让 AI 实现“真正不遗忘”。
注：与此配合的还有 memory/YYYY-MM-DD.md 文件夹，用于存储每日的流水账观测笔记。

传统的 AI 都是“你不输入，它不回复”。而 OpenClaw 的 HEARTBEAT.md 赋予了 AI 主动性。

控制内容：配置智能体在系统“心跳检测”（Heartbeat Polls）时的自动化行为。
适用场景：规定 AI 在定时巡检时该做什么。例如：“每天早上 8:00 检查我的待办事项并提醒我”、“每隔 1 小时检查一次指定的 GitHub 仓库是否有新的 Issue”。

当你为 OpenClaw 开启了沙箱、联网、代码执行等高级工具后，这个文件用来规范 AI 使用这些工具的“姿势”。