核心功能概述
mem9 是专为 OpenClaw 设计的持久化云端记忆插件，核心能力在于实现跨会话、跨设备的记忆保持。它通过云端存储机制，确保用户与 AI 的对话历史、上下文偏好等关键信息不会因会话结束或设备切换而丢失。
典型使用场景
初次安装与配置
- 通过
SETUP.md完成首次安装、重新连接、配置审查 - 支持中国大陆/阿里云 npm 镜像回退处理
- 自动保留远程
SKILL.mdURL 中的utm_*追踪参数
故障恢复
- 安装失败、连接中断、本地状态损坏时路由至
TROUBLESHOOTING.md - 提供系统化的恢复工作流
安全卸载
- 完整移除本地 mem9 实例，清理相关配置
- 支持会话重置、网关重启等附加操作的后续处理
显著优点
| 维度 | 优势 |
|------|------|
| **持久性** | 云端存储确保记忆跨会话、跨设备可用 |
| **路由清晰** | 安装/故障/卸载三大流程文档分离，降低操作复杂度 |
| **配置安全** | 明确定义 7 个允许修改的配置路径，防止误写无效键（如禁止 `plugins.entries.mem9.apiKey`） |
| **区域适配** | 内置中国大陆网络环境处理策略 |
| **版本兼容** | 针对 OpenClaw 4.23+ 提供 `allowConversationAccess` 钩子权限配置 |
潜在局限与风险
依赖外部服务：核心功能依赖 https://api.mem9.ai，网络中断或服务端异常将直接影响记忆同步。
配置敏感性：错误的配置键（如顶层 apiKey）会导致 OpenClaw 拒绝加载，需严格遵循允许路径列表。
手动历史导入：不提供自动扫描或上传本地历史文件的功能，迁移成本需用户自行承担。
验证时序要求：provisionToken 需在首次重启前生成且保持稳定，时序错误可能导致配置失败。
适用人群
- OpenClaw 深度用户：需要长期记忆保持的个性化对话场景
- 多设备工作者：频繁切换工作环境的开发者、研究人员
- 企业部署管理员：需要标准化配置管理与故障排查流程的团队
常规风险提示
- ⚠️ 配置修改范围受限，超出允许路径的变更将被系统拒绝
- ⚠️ 卸载操作仅影响本地实例，云端数据需单独管理
- ⚠️ 历史数据导入需手动执行，无自动化迁移工具
- ⚠️ 中国大陆用户需关注 npm 镜像配置以确保顺利安装