OpenClaw 超级记忆插件

OpenClaw 的长期记忆功能。自动记录对话、召回相关上下文，并构建持久的用户画像——所有这些都由 Supermemory 云端提供支持。无需本地基础设施。

需要 Supermemory Pro 或更高版本 - 为您的 OpenClaw 机器人解锁最先进的记忆能力。

安装

openclaw plugins install @supermemory/openclaw-supermemory

安装完成后，请重启 OpenClaw。

设置

openclaw supermemory setup

输入您在 app.supermemory.ai 上获取的 API 密钥。仅此而已。

高级设置

openclaw supermemory setup-advanced

通过交互式界面配置所有选项：容器标签、自动召回、自动捕获、捕获模式、自定义容器标签等。

工作原理

插件安装完成后，将自动运行：

• 自动召回 — 在每次 AI 回合开始前，向 Supermemory 查询相关记忆并将其作为上下文注入。AI 将看到您的用户画像以及语义上相似的过往对话。
• 自动捕获 — 每次 AI 回合结束后，对话会被发送到 Supermemory 进行提取和长期存储。
• 自定义容器标签 — 您可以定义自定义的记忆容器（例如 work、personal、bookmarks）。当使用记忆工具时，AI 会根据您的指示自动选择合适的容器。

所有操作均在云端完成。Supermemory 负责提取、去重和用户画像的构建。

斜杠命令

命令	描述
/remember <text>	手动将内容保存到记忆中。
/recall <query>	按相似度分数搜索记忆。

AI 工具

AI 会自主使用这些工具。启用自定义容器标签后，所有工具都支持 containerTag 参数，用于将操作路由到特定容器。

工具	描述
supermemory_store	将信息保存到记忆中。
supermemory_search	根据查询搜索记忆。
supermemory_forget	根据查询或 ID 删除记忆。
supermemory_profile	查看用户画像（持久事实 + 近期上下文）。

CLI 命令

openclaw supermemory setup              # 配置 API 密钥
openclaw supermemory setup-advanced     # 配置所有选项
openclaw supermemory status             # 查看当前配置
openclaw supermemory search <query>     # 搜索记忆
openclaw supermemory profile            # 查看用户画像
openclaw supermemory wipe               # 删除所有记忆（需确认）

配置

可通过环境变量设置 API 密钥：

export SUPERMEMORY_OPENCLAW_API_KEY="sm_..."

或者在 ~/.openclaw/openclaw.json 中进行配置：

选项

键	类型	默认值	描述
apiKey	string	—	Supermemory API 密钥。
containerTag	string	openclaw_{hostname}	根记忆命名空间。
autoRecall	boolean	true	在每次 AI 回合前注入相关记忆。
autoCapture	boolean	true	每回合结束后存储对话。
maxRecallResults	number	10	每回合最多注入的记忆数量。
profileFrequency	number	50	每 N 回合注入一次完整用户画像。
captureMode	string	"all"	"all" 过滤短文本，"everything" 则捕获全部内容。
debug	boolean	false	输出详细调试日志。
enableCustomContainerTags	boolean	false	启用自定义容器路由。
customContainers	array	[]	自定义容器，包含 tag 和 description 属性。
customContainerInstructions	string	""	AI 关于容器路由的指导说明。

完整示例

{
  "plugins": {
    "entries": {
      "openclaw-supermemory": {
        "enabled": true,
        "config": {
          "apiKey": "${SUPERMEMORY_OPENCLAW_API_KEY}",
          "containerTag": "my_memory",
          "autoRecall": true,
          "autoCapture": true,
          "maxRecallResults": 10,
          "profileFrequency": 50,
          "captureMode": "all",
          "debug": false,
          "enableCustomContainerTags": true,
          "customContainers": [
            { "tag": "work", "description": "与工作相关的记忆" },
            { "tag": "personal", "description": "个人笔记" }
          ],
          "customContainerInstructions": "将工作任务存入 'work'，个人事务存入 'personal'"
        }
      }
    }
  }
}

OpenClaw Supermemory 快速上手指南

为 OpenClaw 赋予长期记忆能力。该插件基于 Supermemory 云服务，可自动记录对话、检索相关上下文并构建持久的用户画像，无需本地基础设施。

注意：使用前请确保拥有 Supermemory Pro 或以上版本的订阅。

环境准备

• 系统要求：已安装并配置好 OpenClaw 运行环境。
• 前置依赖：
  • 有效的 Supermemory API Key（需 Pro 及以上版本）。
  • 网络连接正常（插件完全基于云端运行）。

安装步骤

1. 执行以下命令安装插件：

   openclaw plugins install @supermemory/openclaw-supermemory
   

2. 安装完成后，重启 OpenClaw 以加载插件。

基本使用

1. 初始化配置

运行设置命令并按提示输入您的 API Key：

openclaw supermemory setup

获取 API Key 请访问：app.supermemory.ai

2. 自动运行

配置完成后，插件将自动工作，无需额外操作：

• 自动回忆 (Auto-Recall)：在 AI 每次回复前，自动检索相关记忆并注入上下文。
• 自动捕获 (Auto-Capture)：在 AI 每次回复后，自动将对话发送至云端进行提取和存储。

3. 手动操作示例

您也可以通过以下斜杠命令与记忆系统交互：

• 手动保存内容到记忆：

  /remember <text>
  

• 搜索相似记忆：

  /recall <query>
  

4. 高级配置（可选）

如需自定义记忆容器（如区分“工作”与“个人”）、调整捕获模式或关闭自动功能，请使用交互式高级设置：

openclaw supermemory setup-advanced