核心用法
mem9 是专为 OpenClaw 智能体设计的云端持久化记忆插件，通过 REST API 将状态化的记忆能力赋予原本无状态（stateless）的 AI 代理。安装后，智能体自动获得 memory_store、memory_search、memory_get、memory_update、memory_delete 五大核心工具，以及三个生命周期钩子：每次 LLM 调用前自动注入相关记忆、会话重置前保存摘要、代理结束时捕获末次响应。
部署流程采用「先预配、后认领」模式：调用 POST /v1alpha1/mem9s 创建租户，获取 id 与 claim_url，用户需在过期前通过浏览器完成认领，否则租户将被销毁。配置阶段通过修改 openclaw.json 将 mem9 注册到 memory 插槽，并填入租户 ID 与 API 端点即可生效。
记忆检索采用混合向量+关键词搜索，支持按标签、来源、关键词等多维度过滤。数据导入支持并行上传 memory/session 文件，默认扫描工作区并自动处理 15 个最新文件。
显著优点
1. 零代码记忆增强：无需修改智能体业务逻辑，通过插件插槽机制自动获得持久记忆能力
2. 智能上下文注入：before_prompt_build 钩子确保每次对话都能召回最相关的历史信息
3. 灵活的导入机制：支持批量迁移历史会话与记忆文件，降低现有工作流迁移成本
4. 无认证设计：简化部署流程，适合快速原型验证与内部工具场景
潜在缺点与局限性
1. 安全模型薄弱：租户 ID 仅通过 URL 路径传递，无额外认证或授权层，存在 ID 泄露后数据暴露风险
2. 认领过期不可逆：租户创建后需人工在浏览器完成认领，无 API 续期机制，自动化部署受限
3. 供应商锁定：API 端点固定为 api.mem9.ai，无自托管选项，依赖第三方服务可用性
4. 版本兼容性复杂：OpenClaw 2.2.0+ 需额外配置 allow 数组，旧版本升级存在配置迁移成本
5. 数据主权不明：未披露数据存储区域、加密标准、合规认证等关键信息
适合人群
- 需要快速为 OpenClaw 智能体添加记忆能力的开发者
- 内部工具、原型验证等对安全要求较低的场景
- 已熟悉 jq/JSON 配置的技术用户
常规风险
| 风险类型 | 描述 | 缓解建议 |
|---------|------|---------|
| 数据泄露 | 租户 ID 泄露即可访问全部记忆数据 | 通过环境变量/密钥管理隔离配置，避免日志泄露 |
| 服务中断 | 云端 API 不可用导致记忆功能失效 | 实现本地降级逻辑，关键记忆做离线备份 |
| 配置错误 | `slots.memory` 指向错误插件导致记忆丢失 | 配置变更后执行端到端记忆读写测试 |
| 租户过期 | 未及时认领导致预配置失败 | 部署流程中增加认领状态检查 |
| 数据迁移失败 | 批量导入时文件格式不兼容 | 导入前验证 JSON Schema，分批次小批量测试 |