核心用法
OpenClaw Memory-OS 是一款面向 AI Agent 的本地记忆管理基础设施，当前处于 Phase 1 阶段，专注于对话记录与存储。用户可通过两种模式操作：
手动模式（默认推荐）：通过 CLI 命令如 openclaw-memory-os remember "内容" 主动保存记忆，或使用 collect 批量采集本地文件，search 进行关键词检索。
AUTO-TRIGGER 模式（需手动启用）：在 ~/.memory-os/config.json 中开启后，系统监听「记住/remember/save to memory」等关键词，自动提取对话内容并在用户确认后保存。该模式默认关闭，符合隐私优先设计原则。
所有数据以 JSON 格式存储于用户主目录 ~/.memory-os/，支持 Node.js API 集成，开发者可通过 MemoryOS 类实现程序化调用。
显著优点
极致隐私保护：100% 本地运行，零网络调用、零外部 API 依赖，无需任何 API Key。采用「默认关闭」设计哲学，AUTO-TRIGGER 需用户显式启用，且每次保存前强制确认，避免意外数据收集。
自动敏感信息脱敏：内置隐私过滤器，自动识别并脱敏 API 密钥、邮箱、信用卡号等敏感信息，降低数据泄露风险。
高性能本地存储：<10ms 写入延迟，92% 缓存命中率，支持批量文件采集与会话超时管理（30 分钟），满足高频交互场景需求。
来源可信透明：由 GitHub 组织账号 ZhenRobotics 维护，MIT-0 开源协议，代码与文档完全公开，依赖版本固定至已验证 commit（0ec01bdbaeb7f25542ebb3bde853eff123f6e265）。
合规性完备：通过 GDPR 数据最小化、用户同意机制、数据本地存储、无第三方共享等六项合规检查。
潜在缺点与局限性
功能受限（Phase 1）：当前版本仅支持基础关键词搜索，无 AI 语义搜索、向量化检索、知识图谱或 LLM 洞察能力，这些功能需等待 v0.3.0+ 并引入外部 API Key。
无静态加密：数据以明文 JSON 存储，虽可通过操作系统级磁盘加密（如 BitLocker/FileVault）弥补，但原生缺乏加密-at-rest 能力。
单设备孤岛：无云同步或多设备支持，记忆数据绑定单机，跨设备使用需手动迁移。
版本一致性风险：安全报告发现文档声明版本（0.2.2）与用户请求认证版本（0.1.16）存在差异，实际功能可能因 npm 包版本浮动而不一致。
文件系统依赖：需写入权限至用户主目录，在只读容器或受限环境中可能失败。
适合的目标群体
隐私敏感型用户：对数据主权有严格要求，拒绝任何云端存储或第三方服务介入的个人用户与小型团队。
本地 AI Agent 开发者：正在构建离线优先、边缘部署的 AI 应用，需要可控的记忆层基础设施。
合规驱动型企业：处于强数据监管行业（金融、医疗、政务），需满足 GDPR、等保等合规要求的组织。
技术极客与研究者：希望深度审计记忆系统实现、自定义存储路径与触发逻辑的进阶用户。
使用风险与注意事项
依赖包审计盲区：Skill 本身为纯 Markdown 文档，实际功能由外部 npm 包 openclaw-memory-os 提供。该 npm 包未经过本次 CLS 认证，存在供应链风险。建议固定至已验证 commit 版本，安装前验证 integrity 哈希。
意外触发与误存：若启用 AUTO-TRIGGER，日常对话中可能因关键词误匹配导致意外保存，虽需二次确认，但仍建议先在沙盒环境测试触发效果，定期审查 ~/.memory-os/memories/ 目录内容。
明文存储风险：敏感信息虽经脱敏处理，但原始对话内容以明文留存，建议对存储目录启用全盘加密，并配置定期清理策略。
网络行为验证：尽管声明零网络调用，建议在生产环境部署前使用 tcpdump 等工具进行实际流量抓包验证，确保无隐蔽外联。
版本锁定建议：因文档与 npm 包版本可能存在差异，建议通过 package-lock.json 或 npm ci 严格锁定依赖版本，避免功能漂移。