OpenClaw接入Agent Memory服务

前提条件

接入前需满足以下条件：

• 已在 AMS 控制台添加 Agent 身份，并复制该 Agent 对应的 API Key。

• 已在 AMS 控制台创建接入点，并获取接入点别名。

• OpenClaw 已安装，Gateway 可正常启动。

• 本地已安装 OpenClaw CLI，可执行 openclaw --version。

• OpenClaw 版本与 openclaw-mem0 插件版本匹配。不同版本的配置差异见版本兼容说明。

AMS Mem0 兼容地址按以下格式配置：

http://<接入点别名>:1995/mem0

其中 1995 为固定端口，/mem0 为 Mem0 兼容协议前缀。

接入信息说明

版本兼容说明

• 推荐版本：OpenClaw v2026.4.24 及以上版本，@mem0/openclaw-mem0 1.0.11。

• 旧版 OpenClaw 如 v2026.3.23 可使用 @mem0/openclaw-mem0 1.0.6 做兼容接入，具体见常见问题旧版 OpenClaw 如何接入。

步骤一：安装插件

执行以下命令安装 OpenClaw Mem0 插件：

openclaw plugins install @mem0/openclaw-mem0

安装完成后查看插件信息：

openclaw plugins inspect openclaw-mem0

如需确认 OpenClaw 版本：

openclaw --version

步骤二：配置插件

在 OpenClaw 配置文件中启用 openclaw-mem0。配置文件通常位于：

~/.openclaw/openclaw.json

自动采集 session 对话时，建议使用 autoCapture 和 autoRecall。较新的 OpenClaw 版本需要在插件条目中加入 hooks.allowConversationAccess。

{
  "plugins": {
    "slots": {
      "memory": "openclaw-mem0"
    },
    "entries": {
      "openclaw-mem0": {
        "enabled": true,
        "config": {
          "mode": "platform",
          "apiKey": "${MEM0_API_KEY}",
          "baseUrl": "http://<接入点别名>:1995/mem0",
          "userId": "openclaw-user",
          "autoCapture": true,
          "autoRecall": true,
          "topK": 5
        },
        "hooks": {
          "allowConversationAccess": true
        }
      }
    }
  }
}

配置说明：

环境变量示例：

export MEM0_API_KEY="<AMS API Key>"

步骤三：重启 Gateway

修改配置后，重启 OpenClaw Gateway：

openclaw gateway restart

验证配置文件格式：

openclaw config validate

查看插件连接状态：

openclaw mem0 status --json

返回结果中 connected 为 true，表示插件已连通 AMS：

{
  "ok": true,
  "mode": "platform",
  "connected": true,
  "userId": "openclaw-user"
}

步骤四：验证接入

验证 OpenClaw session 自动采集时，建议固定一个 session。全程使用同一个 session 对话，再用 /reset 触发当前 session 结束。

如果全程在 WebUI 中对话，可打开以下地址：

http://localhost:18789/chat?session=ams-openclaw-demo

如果使用 CLI 对话，再到 WebUI 中输入 /reset，需打开 CLI explicit session 对应的地址：

http://localhost:18789/chat?session=agent%3Amain%3Aexplicit%3Aams-openclaw-demo

其中 agent:main:explicit:ams-openclaw-demo 对应 CLI 的 --session-id ams-openclaw-demo。

CLI 对话示例：

  openclaw agent --session-id ams-openclaw-demo \
  --message "最近在写 OpenClaw 接 AMS 的接入文档，里面有个小例子叫「南屏茶歇0527」。我想把步骤写得像平时聊天。" \
  --thinking off

自动采集使用 openclaw.json 中的 config.userId，本文示例为 openclaw-user。

示例对话：

最近在写 OpenClaw 接 AMS 的接入文档，里面有个小例子叫「南屏茶歇0527」。我想把步骤写得像平时聊天：先聊几句，再打 /reset，然后看看记忆是不是进去了。

在同一个 session 中输入 /reset，选择 Reset the current session。不要通过新建 session 代替 /reset，新建 session 不会结束当前 session。
再补一句，这个例子里我想强调：baseUrl 用 AMS 控制台拿到的接入点别名，Mem0 地址后面带上 :1995/mem0，别写成本地测试地址。

在同一个 session 中输入 /reset，选择 Reset the current session。不要通过新建 session 代替 /reset，新建 session 不会结束当前 session。

随后在同一个 session 中换一个话题：

换个轻松点的话题。我周末可能就在西溪附近待半天，想找一个能喝咖啡、慢慢走路、但别太网红的地方。最好树多一点，人少一点，适合下午三四点过去。

刚才想了一下，周末半天我就定「花坞慢走0527」这个小计划：下午三点从西溪花坞入口进去，沿水边慢慢走，找家安静小店喝杯冰美式。我不想赶景点，树荫多、人少就好。

换个话题，周末计划先放一边。我晚上准备把 AMS QuickStart 里的 curl 示例再过一遍，主要看看 baseUrl 有没有写成控制台接入点别名加 :1995/mem0。

查看后台事件：

openclaw mem0 event list --json

事件状态为 SUCCEEDED，且 payload.messages 中包含本次 session 的对话内容，表示 autoCapture 已将会话发送到 AMS：

{
  "ok": true,
  "events": [
    {
      "event_type": "ADD",
      "status": "SUCCEEDED",
      "payload": {
        "user_id": "openclaw-user",
        "run_id": "<user_id_hash>_group"
      }
    }
  ]
}

如需确认长期记忆已经生成，可在事件成功后等待后台处理完成，再搜索对话中的稳定关键词：

openclaw mem0 search "花坞慢走0527" --user-id openclaw-user --top-k 5 --json

返回结果中包含对应关键词，表示 AMS 已完成记忆提取和检索索引写入：

[
  {
    "scope": "long-term",
    "categories": ["travel"],
    "memory": "用户选定「花坞慢走0527」计划..."
  }
]

插件提供的能力

# 检查连接
openclaw mem0 status --json

# 查看后台事件
openclaw mem0 event list --json
openclaw mem0 event status <event_id> --json

# 列出记忆
openclaw mem0 list --user-id openclaw-user --top-k 10 --json

# 搜索记忆
openclaw mem0 search "用户偏好" --user-id openclaw-user --top-k 5 --json

# 手动写入一条记忆
openclaw mem0 add "用户偏好：技术文档使用中文，并保持阿里云帮助中心风格。" --user-id openclaw-user --json

常见问题

openclaw plugins install @mem0/openclaw-mem0@1.0.6

npm install -g @mem0/openclaw-mem0@1.0.6
npm root -g
openclaw plugins install /path/to/node_modules/@mem0/openclaw-mem0

~/.openclaw/extensions/openclaw-mem0/openclaw.plugin.json

{
  "plugins": {
    "slots": {
      "memory": "openclaw-mem0"
    },
    "entries": {
      "openclaw-mem0": {
        "enabled": true,
        "config": {
          "mode": "platform",
          "baseUrl": "http://<接入点别名>:1995/mem0",
          "apiKey": "<AMS API Key>",
          "userId": "openclaw"
        }
      }
    }
  }
}