让 OpenClaw 拥有跨会话记忆

本地或云端自装的 OpenClaw 都可以 —— 一次接入，处处记得。

⏱ 约 5 分钟 ✓ 内测期免费 3 步完成

拿一把 Key

打开 注册页，填个邮箱就能申请（内测期免费）。拿到形如 n1mem- 开头的密钥，复制保存（只显示一次）。

装上并连到 OpenClaw

在运行 OpenClaw 的那台机器上装 n1mem 的 MCP 连接器：

python3 -m pip install --upgrade n1mem-mcp

在 OpenClaw 的 MCP 配置（mcp.json 或设置里的 MCP 段）加入：

{
  "mcpServers": {
    "n1mem": {
      "command": "n1mem-mcp",
      "env": {
        "N1MEM_API_KEY": "n1mem-把这里换成你的密钥",
        "N1MEM_SUBJECT": "这台机器的名字"
      }
    }
  }
}

🔒 Key 只在本机使用：上面的密钥只写进这台机器的 Agent 配置文件（本机），不进网页、不发邮件、不进任何分享链接。

保存后重启 OpenClaw 并信任该 MCP 连接器。

⚠️ 激活三步（不做＝白装）—— 与安装器完成页同源的三步骨架：

重启 OpenClaw（不重启，MCP 连接器里不会加载 n1mem）；
在 MCP 连接器设置里信任 n1mem；
新开一个会话（旧会话工具集启动时锁定，信任后也不会补发）。

说句话，验证它记住了

对它说：「记住：这个项目的部署目录是 /srv/app。」

然后开一个全新会话，问它：「这个项目部署在哪个目录？」

它答对 ——接入成功，从此它就一直记得。

✅ 就这么简单

之后的一切是自动的：OpenClaw 每次对话都会把值得记住的存进 N1Mem，下次开会话自动带上 —— 换会话、换天、换任务都不丢。

连不上 / 没反应？先看这里

工具列表里没有 n1mem

终端里 n1mem-mcp --version 能出版本号才说明装好了；
配置文件位置因部署形态而异（本地 / 云端自装）—— 改完要重启 OpenClaw 并信任连接器。

调用报 401 / not_registered

401：Key 不对或被吊销 —— 回注册页重新生成；
not_registered：主体的加入申请还在等管理员审批，去后台「成员审批」点一下。

还是不行？

联系 support@n1mem.com，附上 n1mem-mcp --version 的输出（不要发 Key）。

环境变量与「使用人」说明（进阶）

变量	必填	说明
`N1MEM_API_KEY`	✅	第 1 步拿到的密钥，绑定你的专属租户。
`N1MEM_SUBJECT`	建议	「这台机器是谁在用」的声明。多台机器共用一把组织 Key 时，靠它区分是谁的记忆/谁的账。

两种部署形态（本地直装 / 云端自装）配置方式相同，区别只在机器位置。

安全与数据隔离（给你技术负责人看的）

密钥即凭证：绑定你的专属租户，只能读写你自己的记忆。请勿提交到代码仓库；怀疑泄露立即联系团队吊销重置。
租户隔离在数据库层强制执行（PostgreSQL RLS）：结构上的"越界查询返回空"。
可见性分级：记忆默认组织内共享，可按 Agent 岗位隔离，支持收回为完全私有。

n1mem-mcp 提供 9 个工具（一览）

工具	作用
`memory_write`	写入一条记忆
`memory_retrieve`	按语义召回相关记忆
`memory_search`	关键词搜索
`memory_edit`	修改已有记忆
`memory_timeline`	按时间线浏览
`memory_stats`	用量统计
`memory_forget`	删除指定记忆
`memory_import`	批量导入（文件/对话）
`memory_export`	导出备份