Skip to content

OpenClaw AGENTS.md 深度配置指南:会话启动 + 分层记忆 + 安全边界全解析

2026年4月18日

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 示例。

不要孤军奋战啦!

加入微信群一起学习交流 AI

与大神一起使用 OpenClaw、Hermes、Claude Code、Seedance 2.0、GPT-Image-2 等

微信公众号

扫码关注微信公众号
私信 "加群",将自动获取微信群二维码

探索 AI 世界,掌握智能未来