（417期）mem9.ai – OpenClaw 官方云记忆持久化方案

OpenClaw 官方云记忆持久化方案 mem9 是 OpenClaw 官方持久化云记忆插件，支持跨会话、跨设备记忆同步，需通过 OpenClaw 插件商店安装，配置涉及 API 密钥与权限管理。 使用说明 核心用法 mem9 是 OpenClaw 生态系统的官方持久化云记忆插件，主要功能是为 AI 对话提供跨会话、跨设备的记忆持久化能力。用户需通过 openclaw plugins install @mem9/mem9 命令安装，禁止使用 npm install -g 全局安装，因为 OpenClaw 无法识别全局 npm 包作为插件。 配置需修改 openclaw.json 的限定路径，包括 plugins.entries.mem9.config.apiKey、plugins.entries.mem9.config.apiUrl 等核心字段。OpenClaw 4.23+ 版本需额外开启 plugins.entries.mem9.hooks.allowConversationAccess 权限，允许 mem9 在 agent_end 阶段读取对话消息。setup 流程分两种模式：create-new（生成新密钥）和 reconnect（使用已有密钥），前者会在首次重启后自动完成密钥验证。 显著优点 官方原生集成：由 mem9-ai 官方维护，与 OpenClaw 深度耦合，非第三方外挂 配置边界清晰：SKILL.md 明确定义了允许修改的 6 个配置路径，防止配置污染 安全设计严格：强制要求 API 密钥不得写入本地记忆文件（MEMORY.md 等），仅在最后 onboarding 阶段展示；区分 create-new 与 reconnect 的权限差异（provisionToken 仅前者使用） UTM 参数透传：支持从远程 SKILL.md URL 保留营销参数，便于归因追踪 故障路由完善：安装、排错、卸载分别路由至独立文档（SETUP.md / TROUBLESHOOTING.md / UNINSTALL.md） 潜在缺点与局限性 版本耦合严苛：OpenClaw < 4.23 无法使用 hooks 功能，且配置路径错误（如写成 plugins.entries.mem9.apiKey）会导致插件完全无法加载 网络依赖单一：默认 apiUrl 为 https://api.mem9.ai，虽可自定义但文档强调「除非用户明确要求」，隐含对官方服务的绑定 手动历史导入：不支持自动扫描或上传本地历史文件，迁移成本高 mainland China 特殊处理：文档特别提及需单独处理阿里云 npm 安装，暗示跨境网络稳定性问题 适合人群 需要长期记忆 continuity 的 OpenClaw 重度用户 多设备切换的开发者/研究人员 对数据隐私有要求、希望记忆存储在云端而非本地文件的用户 能接受「配置即代码」工作流的技术用户 常规风险 密钥泄露风险：虽禁止写入本地记忆文件，但 openclaw.json 本身为本地明文存储，多用户机器需注意权限管理 插件供应链风险：依赖 GitHub 与 npm 分发， mainland China 用户可能遭遇下载失败 版本漂移风险：OpenClaw 与 mem9 插件版本需严格匹配，升级时需同步更新 权限过度授予：allowConversationAccess 开启后 mem9 可读取全部对话内容，敏感场景需评估 原始说明 Persistent cloud memory plugin for OpenClaw. This document routes setup, troubleshooting, and uninstall flows and defines config boundaries.