OpenClaw MemoryOS 记忆管理工具

通过直接操作 MemoryOS 存储文件，并遵循 long_term_user.json 和 long_term_assistant.json 中所采用的 MemoryOS 数据模型，来管理 OpenClaw 的长期记忆。

请优先使用配套脚本执行确定性操作。仅在需要确认磁盘上的目录结构，或解释 MemoryOS 如何映射用户档案、用户知识与助手知识时，才查阅参考文件。

快速开始

请优先使用 scripts/memoryos_admin.py，避免临时的手动编辑。

常用命令如下：

python scripts/memoryos_admin.py summary --data-root "D:pathtomemoryos_data" --user-id alice --assistant-id openclaw
python scripts/memoryos_admin.py search-user --data-root "D:pathtomemoryos_data" --user-id alice --query "project preference"
python scripts/memoryos_admin.py add-user-knowledge --data-root "D:pathtomemoryos_data" --user-id alice --text "User prefers concise technical answers."
python scripts/memoryos_admin.py set-profile --data-root "D:pathtomemoryos_data" --user-id alice --profile-file ".profile.txt"
python scripts/memoryos_admin.py backup --data-root "D:pathtomemoryos_data" --user-id alice --assistant-id openclaw

工作流程

除非用户明确要求执行更窄范围的任务，否则请按以下顺序操作：

1. 定位 OpenClaw 集成所使用的 MemoryOS 数据根目录（data_root）。
2. 运行 summary 命令，检查当前用户档案与知识条目数量。
3. 在执行任何变更操作前，先运行 backup 进行备份。
4. 使用 search-user 或 search-assistant 确认目标记忆是否已存在。
5. 使用 add-user-knowledge、add-assistant-knowledge 或 set-profile 执行有明确意图的记忆更新。
6. 当用户需要可读的审计报告或交接产物时，使用 export-markdown。

数据规则

以下文件被视为权威的长期记忆状态源：

• users//long_term_user.json
• assistants//long_term_assistant.json

其字段含义如下：

• user_profiles..data：当前合成的用户档案
• knowledge_base[]：用户专属的长期知识条目
• assistant_knowledge[]：助手端可复用的知识条目

除非显式添加或替换内容，否则请保留现有时间戳。

请勿手动编辑嵌入向量（embeddings）。配套管理脚本在设计上不存储或更新嵌入向量，因为本能力聚焦于记忆管理、策展、备份与检查。MemoryOS 运行时内部的语义检索能力可在需要时，通过标准 MemoryOS 流程重建或补充嵌入向量。

变更操作指引

仅当用户希望以人工整理后的版本完全替换当前合成的档案时，才使用 set-profile。

使用 add-user-knowledge 添加关于用户的持久性事实，例如偏好、身份信息、重复性任务或 OpenClaw 应持续记住的上下文。

使用 add-assistant-knowledge 添加属于助手而非用户的流程指令、项目背景、团队规范或可复用的操作知识。

在追加一条近似重复的记忆前，请先执行搜索，并确认旧条目应被保留、手动替换，还是在指令模糊时维持不变。

OpenClaw 集成说明

若工作区中未部署 OpenClaw，则将 OpenClaw 视为消费代理（consuming agent），MemoryOS 视为存储后端。关键集成契约包括 MemoryOS 的 data_storage_path，以及选定的 user_id 与 assistant_id。

当将其他代理项目接入 MemoryOS 时，请注意：

• 为每位用户维护稳定的 user_id；
• 为每个 OpenClaw 角色或部署维护稳定的 assistant_id；
• 确保该代理指向相同的 data_storage_path；
• 在修改 Schema 或工作流前，对记忆文件执行备份。

参考文档

如需了解精确的文件布局与字段名称，请查阅 references/memoryos-layout.md。