分享我的 openclaw 安装。

# OpenClaw 记忆系统 — 完整架构 > 把这份文档交给你的 molty。它读完后就知道该构建什么。 > 将 `<NOMBRE>`、`<AGENTE>` 和路径替换为用户的真实值。 --- ## 启动 — 每次会话开始时读取 文件 用途 `SOUL.md` 我是谁：语气、行为、基本事实、自适应响应 `USER.md` 你是谁：档案、健康、家庭、环境、锚点、对待偏好 `IDENTITY.md` 代理名称、角色、物种、限制 `AGENTS.md` 操作规则：启动检查清单、主动写作、回忆、关闭 `MEMORY.md` 持久事实和偏好索引（永不可忘记的内容） `<NOMBRE>.md` 用户累积的原始历史（不摘要，只增长） --- ## 状态 — 当下的事实，而非历史 文件 用途 `memory/state/integrated.md` 按领域划分的当前快照：焦点、现实状态、下一步行动 `memory/open-loops.md` 活跃的待办事项及其下一步 — NOW / NEXT / WAITING / BLOCKED `memory/decisions.md` 已做出的持久决策（避免重复讨论） `memory/session-handoff.md` 会话间交接 — 每次关闭时重写 `memory/self.md` 代理自身的错误与学习记录 --- ## 时间 — 按时间顺序的记录 文件 用途 `memory/YYYY-MM-DD.md` 日常记录：每日发生的事件、确认的事实、关闭 `memory/weekly/YYYY-Www.md` 周记录：7天整合、模式、晋升为持久记忆 模板位于 `memory/templates/`：`daily.md`、`weekly.md`、`open-loops.md`、`decisions.md`、`state-domain.md`、`entity.md` --- ## 语义 — 长期与维护 文件 用途 `memory/backbone-log.md` 每日看门狗日志 `memory/audits/backbone-lint.md` 每周骨架检查（矛盾、孤立、过时） `memory/entities/` 关键人物或项目的持久档案 --- ## 搜索 **QMD** 索引工作区中的所有 `.md` 文件。 `memory_search` 在该索引上进行语义搜索。 在 `openclaw.json` 中配置： ```json "memory": { "backend": "qmd", "qmd": { "paths": [{ "path": "<WS>", "mask": "**/*.md" }] } } ``` 规则：当在索引路径之外创建文件夹时，更新 `memory.qmd.paths` 并重启网关。 --- ## 工作区完整目录结构 主工作区在搭建完成后应如下所示： ``` ~/.openclaw/workspace/ ── 启动 ── SOUL.md 代理是谁 IDENTITY.md 名称、角色、物种 USER.md 用户是谁 AGENTS.md 操作规则与协议 WORKSPACE_RULES.md 整洁、可追溯性、优先级规范 MEMORY.md 持久事实与偏好 TOOLS.md 环境设置（模型、QMD、搜索器） <NOMBRE>.md 用户累积的原始历史 INDEX.md 根目录索引 WORKSPACE_INDEX.md 工作区导航地图 memory/ ── 状态 ── state/ integrated.md 按领域划分的当前快照 domains/<domain>.md 各领域的详细状态（可选） open-loops.md 活跃待办事项及其下一步 decisions.md 持久决策 session-handoff.md 会话间交接 self.md 代理的错误与学习 ── 时间 ── YYYY-MM-DD.md 日常记录 weekly/YYYY-Www.md 周整合 ── 语义 / 维护 ── MEMORY（根目录） durable entities/ 人物/项目档案 backbone-log.md 每日看门狗日志 audits/backbone-lint.md 每周骨架检查 ── 系统规则 ── RULES.md 分层架构 PROCESS.md 维护节奏 ARCHITECTURE.md 第二大脑设计（可选） ── 模板 ── templates/daily.md templates/weekly.md templates/open-loops.md templates/decisions.md templates/state-domain.md templates/entity.md tools/ update-workspace-index.sh 索引生成器 bin/qmd-openclaw-shim QMD 适配器（如果需要） ``` --- ## 领域代理 — ×N（每个领域一个，拥有自己的上下文） 每个代理拥有自己的镜像工作区，结构相同但精简： ``` ~/.openclaw/workspace-<AGENTE>/ AGENTS.md ← 领域代理的简化合约 USER.md ← 与该领域相关的用户上下文 MEMORY.md ← 领域的持久记忆 memory/ YYYY-MM-DD.md open-loops.md state/integrated.md weekly/YYYY-Www.md templates/daily.md templates/weekly.md ``` 领域代理规则：每个代理关闭自己的领域，并通过 **Telegram 公告关闭**。主代理此外还需整合所有领域并公告主关闭。 在 `openclaw.json` → `agents.list[]` 中添加每个代理，并将其路径添加到 `memory.qmd.paths` 中。 --- ## 定时任务 — 自动写入 计划 任务 代理 交付方式 `15 16 * * *` `workspace-index-refresh` 主 无 `35 11 * * *` `qmd-healthcheck-daily` 主 失败时公告 `0..30 23 * * *` `<AGENTE>-daily-close`（错开执行） 每个领域 公告 `32 23 * * *` `memory-daily-close` 主 公告 `40 23 * * *` `memory-backbone-keeper`（一致性看门狗） 主 不匹配时公告 `45..54 23 * * 0` `<AGENTE>-weekly`（错开执行，周日） 每个领域 公告 `59 23 * * 0` `memory-weekly-consolidation` 主 公告 > 每个领域向 Telegram 公告自己的关闭；主代理此外还公告整合后的主关闭。索引刷新不公告。QMD 健康检查和骨架看门狗仅在出现问题或不匹配时公告。 --- ## `memory/BACKBONE.md` — 系统简短地图 记忆系统的简短可操作版本（一目了然的地图）。 `RULES.md`/`PROCESS.md`/`ARCHITECTURE.md` 是详细版本；`BACKBONE.md` 是启动时快速阅读的摘要。 --- ## 权威顺序 当两层冲突时： 领域实时证据与规范文件 操作记忆（`state/`、`open-loops`、`decisions`、`session-handoff`） 持久记忆（`MEMORY.md`、`entities/`） 派生视图（索引、骨架日志、审计） 推理或实验材料 --- ## 给 molty 的提示 — 初始化模板 按顺序粘贴到主代理的聊天中。粘贴前替换占位符。 ### 提示 A — 用户身份 ``` 请一次一个问题，问我 8 到 12 个问题，以构建 USER.md：姓名、时区、位置、活跃领域、我的工作方式和失败方式、喜欢的语气、让我沮丧的事、相关健康信息、锚点。 在 <WS>/USER.md 中写入以下章节：快速档案、环境、锚点、健康、偏好。 不要捏造任何内容。确认你保存了什么。 ``` ### 提示 B — 代理角色 ``` 问我：你想给我取什么名字、什么语气（直接/温暖/尖锐/中性）、我绝对不能做什么、以及当我能量低时如何适应。 在 <WS>/SOUL.md（身份、语气、基本事实、自适应响应）和 <WS>/IDENTITY.md（名字、你是什么、你不进入哪些领域）中写入。使用第一人称。确认你保存了什么。 ``` ### 提示 C — 系统文件 ``` 在 <WS>/ 中创建以下文件，使用本文档附录“系统模板”中的精确内容，并调整 <NOMBRE> 和实际领域： - AGENTS.md - WORKSPACE_RULES.md - memory/RULES.md - memory/PROCESS.md - memory/ARCHITECTURE.md - memory/BACKBONE.md 不要摘要或重新解释：复制内容，仅调整占位符。 确认已创建的文件树。 ``` ### 提示 D — 活动文件骨架 ``` 创建以下文件，初始内容最少（非空）： - memory/<TODAY>.md 从日常模板创建 - memory/state/integrated.md 包含按领域划分的章节 - memory/open-loops.md 包含 NOW/NEXT/WAITING/BLOCKED/RECENTLY CLOSED 章节 - memory/decisions.md 包含表格标题 - memory/session-handoff.md 包含标准章节 - memory/self.md 包含标题和条目格式 - MEMORY.md 包含标题 - TOOLS.md 包含环境设置（模型、QMD、搜索器） - <NOMBRE>.md — 用户累积的原始历史。添加标题说明这是传记/深层上下文文件，只增长不摘要；从 USER.md 中已有的基本信息开始，以便后续积累。 以及 memory/templates/ 中的模板：daily.md、weekly.md、open-loops.md、decisions.md、state-domain.md、entity.md 确认已创建的文件树。 ``` ### 提示 E — 启动与回