核心用法
mem9 作为 OpenClaw 生态的官方持久化云内存插件，主要解决 AI 会话状态易丢失的核心痛点。用户通过配置 MEM9_API_KEY 环境变量或 openclaw.json 中的 plugins.entries.mem9.config.apiKey 完成身份认证，启用后记忆将自动同步至 https://api.mem9.ai 云端节点。
安装流程支持三种典型场景：首次创建（create-new）、断线重连（reconnect）、配置复核。针对中国大陆网络环境，内置 Alibaba Cloud npm 镜像回退机制，无需用户手动切换 registry。
显著优点
1. 跨端持久化：记忆数据脱离本地会话生命周期，可在多设备间无缝恢复对话上下文
2. 权限精细可控：OpenClaw 4.23+ 版本支持 hooks.allowConversationAccess 配置，允许 mem9 在 agent_end 阶段读取会话消息实现智能归档
3. 配置防呆设计：严格限定可修改的 config 路径仅 7 项，禁止误写 plugins.entries.mem9.apiKey 等无效键值
4. UTM 透传追踪：远程加载 SKILL.md 时，自动保留 utm_* 参数至 provisionQueryParams，便于归因分析
潜在局限
- 版本锁定：部分高级特性（如 conversation hook）强制要求 OpenClaw 4.23+/2026.4.22+，旧版本用户无法使用
- 手动历史迁移：不支持自动扫描或上传本地历史会话文件，存量数据需用户手动导入
- 单点网络依赖：默认 API 端点不可用时需用户显式配置备用
apiUrl - 预置令牌一次性：
provisionToken需在首次重启前生成并保持稳定，流程中断后需重新初始化
适合人群
- 重度依赖 OpenClaw 进行长期项目管理的开发者与知识工作者
- 需要在笔记本、台式机、云端 IDE 之间同步 AI 会话状态的多设备用户
- 对数据持久化有强需求、但不愿自行搭建记忆后端的技术团队
常规风险
- 配置覆盖风险：虽然文档明确限定 config 作用域，但用户手动编辑
openclaw.json仍可能破坏插件加载 - 隐私合规注意：会话内容需授权
allowConversationAccess方可被 mem9 读取，敏感场景应审慎开启 - 令牌泄露：
apiKey与provisionToken均以明文形式存储于本地配置文件，共享机器需额外注意权限管理