Appearance
OpenClaw AGENTS.md 深度配置指南:会话启动 + 分层记忆 + 安全边界全解析
OpenClaw AGENTS.md 是 AI 助手的"行为宪法",定义身份、行为准则、记忆系统和安全边界。本指南深度解析会话启动流程、分层记忆架构、安全边界配置、心跳机制,附完整配置示例和 CLI 命令速查。基于 OpenClaw v2026.3.13 版本。
OpenClaw GitHub: https://github.com/OpenClawAI/openclaw
一、AGENTS.md 是什么?
在 OpenClaw 生态中,AGENTS.md 是 AI 助手的**"行为宪法"**。
它不是普通的配置文件,而是定义助手身份、行为准则、记忆系统和安全边界的元指令文档。
每次启动新会话,AI 助手就像"失忆"一样重新开始。AGENTS.md 及其配套文件(SOUL.md、USER.md、MEMORY.md 等)就是助手的"长期记忆"和"人格设定"。
助手每次醒来都知道
| 问题 | 来源文件 |
|---|---|
| 我是谁(身份和语气) | SOUL.md |
| 我在帮谁(用户信息) | USER.md |
| 我记得什么(历史上下文) | MEMORY.md + 每日日志 |
| 我能做什么(工具和权限) | TOOLS.md + 配置 |
核心文件架构
~/.openclaw/workspace/
├── AGENTS.md # 行为准则和配置指南
├── SOUL.md # 人格定义(身份、语气、边界)
├── USER.md # 用户信息
├── TOOLS.md # 本地工具配置笔记
├── IDENTITY.md # 身份标识
├── HEARTBEAT.md # 心跳任务清单
├── BOOTSTRAP.md # 首次运行引导(用后删除)
└── memory/
├── MEMORY.md # 长期记忆
├── 2026-04-18.md # 每日日志
└── ...二、会话启动全流程
配置文件位置:~/.openclaw/openclaw.json
会话启动的"四步仪式"
| 步骤 | 动作 | 说明 |
|---|---|---|
| 1 | 读取身份 | 加载 SOUL.md + USER.md + IDENTITY.md |
| 2 | 加载记忆 | 合并 MEMORY.md + 每日日志 + 项目记忆 |
| 3 | 检查心跳 | 执行 HEARTBEAT.md 中的定时任务 |
| 4 | 等待输入 | 进入对话循环 |
配置示例
json
{
"workspace": "~/.openclaw/workspace",
"memory_backend": "builtin",
"sandbox_mode": "non-main",
"max_tokens": 200000,
"heartbeat_interval": 300
}三、分层记忆架构
| 层级 | 文件 | 特点 | 用途 |
|---|---|---|---|
| 永久层 | MEMORY.md | 手动维护 | 核心知识、项目状态 |
| 日志层 | YYYY-MM-DD.md | 自动生成 | 每日交互记录 |
| 项目层 | PROJECT.md | 按项目隔离 | 项目专属上下文 |
| 会话层 | 临时 | 不持久化 | 当前对话缓存 |
记忆后端对比
| 后端 | 特点 | 适用场景 |
|---|---|---|
| Builtin | 内置、轻量 | 个人使用 |
| QMD | 向量检索 | 大规模知识库 |
| Honcho | 云端同步 | 多设备协作 |
四、安全边界配置
沙箱模式
| 模式 | 说明 | 风险等级 |
|---|---|---|
| off | 无沙箱 | 高 |
| non-main | 仅非主分支沙箱 | 中 |
| all | 全沙箱 | 低 |
权限控制
- 文件读写权限白名单
- 命令执行权限限制
- 网络访问域名限制
五、心跳机制
HEARTBEAT.md 定义定时任务:
- 每日总结生成
- 项目状态检查
- 定时报备任务
六、CLI 命令速查
| 命令 | 说明 |
|---|---|
openclaw start | 启动会话 |
openclaw config | 查看配置 |
openclaw memory sync | 同步记忆 |
openclaw skill install <name> | 安装技能 |
七、完整配置示例
详见原文,包含个人助手配置的完整 YAML 示例。
