核心用法
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 可读取全部对话内容，敏感场景需评估