OpenClaw AGENTS.md 深度配置指南:打造你的 AI 助手大脑

本文基于 OpenClaw v2026.3.13 版本编写，深入解析 OpenClaw 框架中 AGENTS.md 的核心配置机制。通过本文，你将理解如何构建一个具有记忆能力、安全边界清晰、行为可控的个性化 AI 助手。

一、AGENTS.md 是什么？

在 OpenClaw 生态中，AGENTS.md 是 AI 助手的"行为宪法"。它不是普通的配置文件，而是定义助手身份、行为准则、记忆系统和安全边界的元指令文档。

想象一下，每次你启动一个新的对话会话，AI 助手就像"失忆"一样重新开始。AGENTS.md 及其配套文件（SOUL.md、USER.md、MEMORY.md 等）就是助手的"长期记忆"和"人格设定"，确保它每次醒来都知道：

我是谁（身份和语气）
我在帮谁（用户信息）
我记得什么（历史上下文）
我能做什么（工具和权限）

核心文件架构

~/.openclaw/workspace/├── AGENTS.md          # 行为准则和配置指南├── SOUL.md            # 人格定义（身份、语气、边界）├── USER.md            # 用户信息├── TOOLS.md           # 本地工具配置笔记├── IDENTITY.md        # 身份标识├── HEARTBEAT.md       # 心跳任务清单├── BOOTSTRAP.md       # 首次运行引导（用后删除）└── memory/    ├── MEMORY.md      # 长期记忆    ├── 2026-04-09.md  # 每日日志    └── ...

二、会话启动全流程配置

配置文件位置：~/.openclaw/openclaw.json

2.1 会话启动的"四步仪式"

根据 OpenClaw 的设计规范，每次会话启动时，助手必须按顺序读取以下文件：

## Session StartupBefore doing anything else:1. Read `SOUL.md` — this is who you are2. Read `USER.md` — this is who you're helping3. Read `memory/YYYY-MM-DD.md` (today + yesterday) for recent context4. **If in MAIN SESSION** (direct chat with your human): Also read `MEMORY.md`

这个设计背后的理念是：上下文决定行为。助手在回复任何消息之前，必须先"唤醒"自己的身份认知和记忆。

2.2 会话路由机制

OpenClaw 使用 sessionKey 来区分不同的对话上下文：

消息来源	会话隔离策略	sessionKey 示例
私信 (DM)	默认共享一个会话	`agent:<agentId>:main`
群聊	每个群独立会话	`agent:<agentId>:<channel>:group:<id>`
频道/房间	每个频道独立	`agent:<agentId>:<channel>:channel:<id>`
定时任务	每次运行新会话	`cron:<job.id>`

2.3 DM 隔离配置（安全关键！）

配置文件：~/.openclaw/openclaw.json配置路径：session.dmScope

重要安全提示：如果多人可以给你的助手发私信，必须启用 DM 隔离，否则所有用户会共享同一个对话上下文！

{  session: {    dmScope: "per-channel-peer", // 按渠道 + 发送者隔离    // 其他可选值：    // - "main": 所有私信共享一个会话（默认）    // - "per-peer": 按发送者隔离（跨渠道）    // - "per-account-channel-peer": 按账户 + 渠道 + 发送者隔离  },}

会话重置配置：

配置路径：session.reset.* 和 session.maintenance.*

{  session: {    reset: {      // 每日重置（默认凌晨 4 点，网关主机当地时间）      dailyTime: "04:00",      // 空闲重置（可选）      idleMinutes: 1440, // 24 小时无活动则重置    },    // 会话维护    maintenance: {      mode: "enforce", // 或 "warn"      pruneAfter: "30d", // 30 天后清理      maxEntries: 500, // 最多保留 500 个会话      rotateBytes: "10mb", // sessions.json 超过此大小则轮换    },  },}

三、分层记忆架构设计

OpenClaw 的记忆系统是其最核心的特性之一。它采用分层设计，将短期日志与长期记忆分离，模拟人类的记忆机制。

3.1 记忆层级结构

┌─────────────────────────────────────────┐│           MEMORY.md (长期记忆)           ││  持久化事实、偏好、决策、经验教训         ││  类似人类的"长期记忆"                     │└─────────────────────────────────────────┘                    ↑                    │ 定期提炼                    │┌─────────────────────────────────────────┐│        memory/YYYY-MM-DD.md (每日日志)   ││  原始对话记录、临时上下文、观察笔记       ││  类似人类的"短期记忆/工作记忆"            │└─────────────────────────────────────────┘

3.2 MEMORY.md：长期记忆

加载规则：

仅在主会话（与用户的直接对话）中加载
不在共享上下文（Discord、群聊、与他人会话）中加载
这是出于安全考虑——包含不应泄露给陌生人的个人上下文

内容建议：

## 用户偏好- 喜欢 TypeScript 而非 JavaScript- 工作时间：9:00-18:00 (Asia/Shanghai)- 通信偏好：重要事项用邮件，日常用即时消息## 项目上下文- 当前主要项目：OpenClaw 文档优化- GitHub 仓库：github.com/openclaw/openclaw## 重要决策- 2026-04-01: 决定使用 Qwen 作为默认模型- 2026-04-05: 启用沙箱模式执行代码

3.3 每日日志：短期上下文

每日日志文件按日期命名，自动加载今天和昨天的文件：

# 2026-04-09## 进行中的任务- [ ] 撰写 AGENTS.md 配置博文- [x] 修复 webhook 路由问题## 重要对话摘要- 用户 Nancy 询问了 OpenClaw 记忆系统的工作原理- 讨论了会话隔离的安全配置## 临时上下文- 用户今天可能会外出，需要关注天气- 明天有团队会议需要准备材料

3.4 记忆工具

OpenClaw 为助手提供两个核心记忆工具：

工具	功能	使用场景
`memory_search`	语义搜索记忆	查找相关历史信息，即使措辞不同
`memory_get`	读取特定记忆文件	获取精确的记忆片段

3.5 记忆后端引擎

OpenClaw 支持多种记忆后端：

后端	特点	适用场景
Builtin (默认)	SQLite 存储，支持关键词 + 向量混合搜索	大多数用户
QMD	本地优先，支持重排序和查询扩展	需要高级搜索功能
Honcho	AI 原生跨会话记忆，用户建模	多助手协作场景

自动嵌入检测：如果你配置了 OpenAI、Gemini、Voyage 或 Mistral 的 API 密钥，记忆搜索会自动启用向量搜索功能。

3.6 记忆维护：压缩前的"记忆刷新"

配置文件：~/.openclaw/openclaw.json配置路径：agents.defaults.compaction.memoryFlush

这是一个关键设计：在会话压缩（compaction）之前，OpenClaw 会自动运行一个静默回合，提醒助手将重要上下文写入记忆文件。

{  agents: {    defaults: {      compaction: {        memoryFlush: {          enabled: true, // 默认开启          softThresholdTokens: 4000, // 软阈值          prompt: "请将重要信息写入记忆文件",          systemPrompt: "使用 NO_REPLY 标记，不要输出用户可见内容",        },      },    },  },}

这个机制确保压缩不会丢失关键上下文——重要信息已经被持久化到磁盘。

3.7 梦境系统（实验性）

OpenClaw 还有一个实验性的"梦境"（Dreaming）功能，用于后台记忆整合：

可选启用：默认关闭
定时运行：启用后自动管理一个周期性 cron 任务
阈值筛选：只有通过评分、频率和多样性检查的内容才会晋升到长期记忆
可审查：所有晋升摘要写入 DREAMS.md 供用户审查

# 手动触发记忆回填（从历史日志中提炼）openclaw memory rem-backfill --path ./memory --stage-short-term

四、安全边界与权限管理

安全是 OpenClaw 设计的核心考量。AGENTS.md 中定义了清晰的"红线"和权限边界。

4.1 核心安全原则

## Red Lines- Don't exfiltrate private data. Ever.- Don't run destructive commands without asking.- `trash` > `rm` (recoverable beats gone forever)- When in doubt, ask.

4.2 外部 vs 内部操作

AGENTS.md 明确区分了安全操作和需要确认的操作：

安全操作（可自由执行）：

读取文件、探索、组织、学习
搜索网页、检查日历
在工作空间内工作

需要确认的操作：

发送邮件、推文、公开发布
任何离开机器的操作
任何不确定的操作

4.3 沙箱配置（v2026.3 更新）

配置文件：~/.openclaw/openclaw.json配置路径：agents.defaults.sandbox.*

OpenClaw 支持将工具执行隔离在沙箱中，减少潜在风险：

{  agents: {    defaults: {      sandbox: {        mode: "non-main",    // "off" | "non-main" | "all"        scope: "session",    // "agent" | "session" | "shared"        backend: "docker",   // "docker" | "ssh" | "openshell"        workspaceAccess: "none", // "none" | "ro" | "rw"        // Docker 沙箱配置        docker: {          image: "openclaw-sandbox:bookworm-slim",          network: "none",   // 默认无网络，可设为 "bridge" 或其他          binds: [           // 挂载主机目录            "/home/user/source:/source:ro", // 只读挂载          ],          // 一次性设置命令（容器创建后运行一次）          setupCommand: "apt-get update && apt-get install -y curl jq",        },        // 沙箱浏览器配置        browser: {          autoStart: true,   // 自动启动浏览器容器          network: "openclaw-sandbox-browser", // 专用网络        },      },    },  },}

沙箱模式说明：

off：不使用沙箱
non-main：仅非主会话使用沙箱（推荐，主会话在主机运行）
all：所有会话都在沙箱中运行

工作空间访问：

none（默认）：工具看到沙箱工作空间（~/.openclaw/sandboxes）
ro：只读挂载代理工作空间
rw：读写挂载工作空间

4.4 工具策略配置（v2026.3）

配置文件：~/.openclaw/openclaw.json配置路径：tools.*

{  tools: {    // 工具配置文件    profile: "messaging",    // 拒绝的工具组    deny: [      "group:automation",       "group:runtime",       "group:fs",      "sessions_spawn",      "sessions_send",    ],    // 文件系统限制    fs: {      workspaceOnly: true,  // 限制文件访问到工作空间    },    // 执行配置    exec: {      security: "allowlist", // "deny" | "allowlist" | "full"      ask: "on-miss",        // "off" | "on-miss" | "always"      applyPatch: {        workspaceOnly: true, // apply_patch 仅限工作空间      },    },    // 高权限工具（逃逸沙箱）    elevated: {      enabled: false,        // 禁用高权限工具      allowFrom: {           // 如果启用，指定允许的用户        discord: ["user:123456789"],        telegram: ["tg:123456789"],      },    },    // 沙箱内工具策略（可选）    sandbox: {      tools: {        // 沙箱内允许的工具      },    },  },}

执行安全模式：

deny：拒绝所有执行
allowlist：仅允许匹配 allowlist 的命令
full：允许所有执行（信任环境）

审批模式：

off：不需要审批
on-miss：仅当命令不在 allowlist 时审批
always：所有命令都需要审批

4.5 群组聊天安全

在群组环境中，助手需要特别注意行为边界：

响应时机：

被直接提及或被提问
能增加真正价值（信息、洞察、帮助）
纠正重要错误信息
被要求总结时

保持沉默时机：

只是人类之间的闲聊
已经有人回答了问题
你的回复只是"嗯"或"不错"
对话流畅进行不需要你参与

核心原则：参与，不要主导（Participate, don't dominate）

4.6 上下文可见性控制

OpenClaw 提供 contextVisibility 设置来控制补充上下文（引用回复、线程历史等）的过滤：

{  channels: {    telegram: {      contextVisibility: "allowlist", // "all" | "allowlist" | "allowlist_quote"    },  },}

all（默认）：保持接收到的所有补充上下文
allowlist：仅保留允许列表发送者的补充上下文
allowlist_quote：类似 allowlist，但仍保留一个明确的引用回复

4.7 安全审计

OpenClaw 提供内置的安全审计命令：

# 运行安全审计openclaw security audit# 深度审计（包含实时 Gateway 探测）openclaw security audit --deep# 自动修复常见问题openclaw security audit --fix# JSON 输出（用于自动化）openclaw security audit --json

审计检查项（部分）：

入站访问（DM 策略、群组策略、允许列表）
工具影响范围（高权限工具 + 开放房间）
执行审批漂移
网络暴露（Gateway 绑定/认证、Tailscale）
浏览器控制暴露
本地磁盘卫生（权限、符号链接、配置文件）

4.8 强化基线配置

对于新部署，建议使用以下安全基线：

{  gateway: {    mode: "local",    bind: "loopback",    auth: { mode: "token", token: "替换为长随机令牌" },  },  session: {    dmScope: "per-channel-peer",  },  tools: {    profile: "messaging",    deny: ["group:automation", "group:runtime", "group:fs", "sessions_spawn", "sessions_send"],    fs: { workspaceOnly: true },    exec: { security: "deny", ask: "always" },    elevated: { enabled: false },  },  channels: {    whatsapp: { dmPolicy: "pairing", groups: { "*": { requireMention: true } } },  },}

五、心跳机制：主动式助手

OpenClaw 的心跳（Heartbeat）机制让助手能够主动检查任务，而不是被动等待指令。

5.1 心跳配置

配置文件：~/.openclaw/openclaw.json配置路径：channels.defaults.heartbeat.*任务文件：~/.openclaw/workspace/HEARTBEAT.md

默认心跳提示（可在 channels.defaults.heartbeat 中配置）：

Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.

心跳输出配置：

{  channels: {    defaults: {      heartbeat: {        showOk: false,        // 是否在心跳中显示正常状态        showAlerts: true,     // 是否显示告警状态        useIndicator: true,   // 使用紧凑指示器格式      },    },  },}

5.2 心跳 vs Cron

特性	心跳 (Heartbeat)	定时任务 (Cron)
时机	约 30 分钟间隔，可漂移	精确时间（如每周一 9:00）
上下文	需要最近消息上下文	独立于主会话历史
适用场景	批量检查（邮箱 + 日历 + 通知）	精确调度、一次性提醒
会话绑定	主会话	可隔离会话

5.3 心跳任务示例

# HEARTBEAT.md## 定期检查清单- [ ] 检查紧急未读邮件- [ ] 查看未来 24-48 小时日历事件- [ ] 检查社交媒体提及- [ ] 查看天气（如果用户可能外出）## 状态追踪记录在 `memory/heartbeat-state.json`:```json{  "lastChecks": {    "email": 1703275200,    "calendar": 1703260800,    "weather": null  }}

### 5.4 何时主动联系用户- 重要邮件到达- 即将发生的日历事件（<2 小时）- 发现有趣的信息- 超过 8 小时没有交流### 5.5 何时保持安静- 深夜（23:00-08:00）除非紧急- 用户明显忙碌- 自上次检查后没有新内容- 刚检查过（<30 分钟）---## 六、实战配置示例### 6.1 个人助手完整配置（v2026.3.13）> **完整配置文件**：`~/.openclaw/openclaw.json````json5// ~/.openclaw/openclaw.json// 使用 JSON5 格式（支持注释和尾随逗号）{  // ==================== 网关配置 ====================  // 文件位置：~/.openclaw/openclaw.json  // 配置路径：gateway.*  // ==================== 网关配置 ====================  gateway: {    mode: "local",    bind: "loopback",  // 仅本地访问    auth: {       mode: "token",       token: "your-secure-token-here", // 使用长随机令牌      rateLimit: { requests: 100, intervalMs: 60000 }, // 速率限制    },    // 可信代理（如果使用反向代理）    trustedProxies: ["127.0.0.1"],    // Control UI 配置    controlUi: {      allowedOrigins: ["http://localhost:18789"],    },  },  // ==================== 会话配置 ====================  // 文件位置：~/.openclaw/openclaw.json  // 配置路径：session.*  session: {    dmScope: "per-channel-peer", // DM 隔离策略    reset: {      dailyTime: "04:00",  // 每日重置时间（网关当地时间）      idleMinutes: 1440,   // 空闲重置（24 小时）    },    maintenance: {      mode: "enforce",      pruneAfter: "30d",      maxEntries: 500,      rotateBytes: "10mb",    },  },  // ==================== 渠道配置 ====================  // 文件位置：~/.openclaw/openclaw.json  // 配置路径：channels.*  channels: {    // 渠道默认策略    defaults: {      groupPolicy: "allowlist", // open | allowlist | disabled      contextVisibility: "all", // all | allowlist | allowlist_quote      heartbeat: {        showOk: false,        showAlerts: true,        useIndicator: true,      },    },    // WhatsApp 配置    whatsapp: {      dmPolicy: "pairing", // pairing | allowlist | open | disabled      allowFrom: ["+8613800138000"],      groups: {        "*": { requireMention: true },      },      sendReadReceipts: true,    },    // Telegram 配置    telegram: {      enabled: true,      botToken: "your-bot-token", // 或使用 tokenFile      dmPolicy: "pairing",      allowFrom: ["tg:123456789"],      groups: {        "*": { requireMention: true },      },      streaming: "partial", // off | partial | block | progress    },  },  // ==================== 命令配置 ====================  // 文件位置：~/.openclaw/openclaw.json  // 配置路径：commands.*  commands: {    native: "auto",        // 自动注册原生命令    nativeSkills: "auto",  // 自动注册技能命令    text: true,            // 解析聊天中的 /commands    bash: false,           // 禁用 ! 命令（安全）    config: false,         // 禁用 /config（生产环境建议关闭）    ownerAllowFrom: ["discord:123456789"],  },  // ==================== 代理配置 ====================  // 文件位置：~/.openclaw/openclaw.json  // 配置路径：agents.defaults.*  agents: {    defaults: {      workspace: "~/.openclaw/workspace",      // 模型配置      model: {        primary: "anthropic/claude-opus-4-6",        fallbacks: ["openai/gpt-5.4", "qwen/qwen3.5-plus"],      },      // 图像模型      imageModel: {        primary: "openai/gpt-4.1-nano",        fallbacks: ["google/gemini-2.0-flash"],      },      // 记忆搜索配置      memorySearch: {        provider: "openai", // 或 gemini, voyage, mistral, ollama        model: "text-embedding-3-small",      },      // 沙箱配置      sandbox: {        mode: "non-main",        scope: "session",        backend: "docker",        workspaceAccess: "none",        docker: {          network: "none",          binds: [],        },      },      // 压缩配置      compaction: {        enabled: true,        reserveTokens: 16384,        keepRecentTokens: 20000,        memoryFlush: {          enabled: true,          softThresholdTokens: 4000,        },      },      // 上下文注入优化      contextInjection: "continuation-skip", // 安全延续回合跳过重复注入      bootstrapMaxChars: 20000, // 单文件最大字符      bootstrapTotalMaxChars: 150000, // 总注入字符限制    },  },  // ==================== 工具配置 ====================  // 文件位置：~/.openclaw/openclaw.json  // 配置路径：tools.*  tools: {    profile: "messaging",    deny: [      "group:automation",      "group:runtime",      "sessions_spawn",      "sessions_send",    ],    fs: { workspaceOnly: true },    exec: {      security: "allowlist",      ask: "on-miss",      applyPatch: { workspaceOnly: true },    },    elevated: { enabled: false },  },  // ==================== 日志配置 ====================  // 文件位置：~/.openclaw/openclaw.json  // 配置路径：logging.*  logging: {    redactSensitive: "tools", // none | tools | all  },}

七、总结与建议

核心要点回顾

AGENTS.md 是行为宪法：定义助手的身份、记忆、安全边界
会话启动四步曲：SOUL → USER → 每日日志 → MEMORY（主会话）
分层记忆架构：每日日志（短期）+ MEMORY.md（长期）
安全优先：DM 隔离、沙箱、工具策略、审计
心跳机制：让助手主动检查任务，而非被动等待

最佳实践建议（v2026.3）

1、从安全基线开始：先锁定 DM 和群组策略，再逐步放宽

# 配置文件：~/.openclaw/openclaw.jsonopenclaw security audit --fix  # 自动修复常见问题

2、定期运行安全审计：

openclaw security audit --deep  # 深度审计（包含实时探测）openclaw security audit --json  # JSON 输出（自动化）

3、使用沙箱：非主会话启用沙箱模式

// 配置文件：~/.openclaw/openclaw.json// 配置路径：agents.defaults.sandbox{ agents: { defaults: { sandbox: { mode: "non-main" } } } }

4、维护记忆文件：定期审查和更新 MEMORY.md

文件位置：~/.openclaw/workspace/MEMORY.md
每日日志：~/.openclaw/workspace/memory/YYYY-MM-DD.md
使用心跳定期检查每日日志
提炼重要内容到长期记忆
删除过时信息

5、备份工作空间：将 ~/.openclaw/workspace 纳入版本控制

cd ~/.openclaw/workspace  # 工作空间目录git initgit add AGENTS.md SOUL.md USER.md MEMORY.md memory/git commit -m "Initial workspace"

6、配置验证：

openclaw config schema      # 查看完整配置架构openclaw config.schema.lookup session  # 查看特定配置路径

7、使用上下文注入优化：

// 配置文件：~/.openclaw/openclaw.json// 配置路径：agents.defaults.contextInjection{ agents: { defaults: { contextInjection: "continuation-skip" } } }

减少安全延续回合的重复注入，降低 token 消耗

进阶方向

多助手路由：为不同任务配置专用助手
自定义技能：根据需求开发专属技能
记忆 Wiki：使用 memory-wiki 插件构建知识库
梦境系统：实验性记忆整合功能

本文基于 OpenClaw v2026.3.13 (61d171a) 版本编写。配置选项可能随版本更新而变化，请以官方文档和 openclaw config schema 输出为准。

附录：配置位置速查表

A.1 核心配置文件

文件	路径	说明
主配置文件	`~/.openclaw/openclaw.json`	Gateway、会话、渠道、工具等所有配置
行为准则	`~/.openclaw/workspace/AGENTS.md`	AI 助手的会话启动流程、记忆规则、安全边界
人格定义	`~/.openclaw/workspace/SOUL.md`	AI 助手的身份、语气、价值观
用户信息	`~/.openclaw/workspace/USER.md`	用户基本信息、时区、偏好
长期记忆	`~/.openclaw/workspace/MEMORY.md`	仅在主会话加载的持久化记忆
每日日志	`~/.openclaw/workspace/memory/YYYY-MM-DD.md`	自动加载今天和昨天的日志
心跳任务	`~/.openclaw/workspace/HEARTBEAT.md`	心跳检查任务清单
工具笔记	`~/.openclaw/workspace/TOOLS.md`	本地工具配置笔记（相机、SSH 等）

A.2 配置路径速查

网关配置 (`gateway.*`)

{  gateway: {    mode: "local",           // 网关模式    bind: "loopback",        // 绑定地址    auth: { mode: "token" }, // 认证方式  },}

会话配置 (`session.*`)

{  session: {    dmScope: "per-channel-peer",  // DM 隔离策略    reset: { dailyTime: "04:00" }, // 每日重置时间    maintenance: { mode: "enforce" }, // 会话维护  },}

渠道配置 (`channels.*`)

{  channels: {    defaults: {      groupPolicy: "allowlist",   // 群组策略      heartbeat: { showOk: false }, // 心跳输出    },    whatsapp: { dmPolicy: "pairing" }, // WhatsApp 配置    telegram: { botToken: "xxx" },     // Telegram 配置  },}

代理配置 (`agents.defaults.*`)

{  agents: {    defaults: {      workspace: "~/.openclaw/workspace", // 工作空间      model: { primary: "anthropic/claude-opus-4-6" }, // 模型      memorySearch: { provider: "openai" }, // 记忆搜索      sandbox: { mode: "non-main" }, // 沙箱模式      compaction: { enabled: true }, // 压缩配置    },  },}

工具配置 (`tools.*`)

{  tools: {    profile: "messaging",  // 工具配置文件    deny: ["group:fs"],    // 拒绝的工具    exec: { security: "allowlist" }, // 执行安全    elevated: { enabled: false },    // 高权限工具  },}

A.3 常用 CLI 命令

# 查看配置openclaw config get <path>              # 获取配置值openclaw config schema                  # 查看完整配置架构openclaw config.schema.lookup session   # 查看特定配置路径# 修改配置openclaw config set session.dmScope per-channel-peer# 安全审计openclaw security audit                 # 运行安全审计openclaw security audit --deep          # 深度审计openclaw security audit --fix           # 自动修复# 会话管理openclaw sessions                       # 查看会话列表openclaw sessions cleanup --dry-run     # 预览清理# 记忆管理openclaw memory status                  # 查看记忆状态openclaw memory search "query"          # 搜索记忆openclaw memory index --force           # 重建索引# 定时任务openclaw cron list                      # 查看 cron 任务openclaw cron add                       # 添加任务# Gateway 管理openclaw gateway status                 # 查看状态openclaw gateway restart                # 重启服务openclaw dashboard                      # 打开控制面板

A.4 文件结构总览

~/.openclaw/├── openclaw.json                    # 主配置文件├── credentials/                     # 渠道凭证（加密存储）│   └── whatsapp/├── agents/│   └── default/│       ├── sessions/                # 会话存储│       │   ├── sessions.json        # 会话索引│       │   └── *.jsonl              # 会话转录│       └── agent/│           └── auth-profiles.json   # 认证配置文件├── workspace/                       # 工作空间（可自定义）│   ├── AGENTS.md                    # 行为准则│   ├── SOUL.md                      # 人格定义│   ├── USER.md                      # 用户信息│   ├── MEMORY.md                    # 长期记忆│   ├── HEARTBEAT.md                 # 心跳任务│   ├── TOOLS.md                     # 工具笔记│   └── memory/│       ├── 2026-04-09.md            # 今日日志│       ├── 2026-04-08.md            # 昨日日志│       └── ...                      # 历史日志└── memory/                          # 记忆索引（SQLite）    └── default.sqlite               # 记忆数据库

A.5 配置修改流程

备份配置

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

编辑配置
```
code ~/.openclaw/openclaw.json
```

验证配置

openclaw config schema  # 确保格式正确

应用配置

openclaw gateway restart  # 重启生效

验证生效

openclaw config get session.dmScope  # 确认配置值openclaw security audit  # 安全检查