OpenClaw 插件接入

更新时间:
复制为 MD 格式

为 OpenClaw 个人 AI 助理平台接入企业级长期记忆能力,无需修改 OpenClaw 源码。

前置条件

  • 拥有阿里云账号,并已开通 AgentLoop 记忆库服务。

  • 已在控制台创建 Workspace 和记忆库。

  • 获取阿里云账号 AccessKey ID / Secret。

  • 已安装并配置好 OpenClaw。

步骤一:安装插件

在 OpenClaw 项目目录下执行:

npm install openclaw-plugin-agentloop-memory

步骤二:配置插件

在 OpenClaw 的配置文件中添加以下内容:

{
  "memory-agentloop": {
    "endpoint": "${ENDPOINT}",
    "accessKeyId": "${ALIBABA_CLOUD_ACCESS_KEY_ID}",
    "accessKeySecret": "${ALIBABA_CLOUD_ACCESS_KEY_SECRET}",
    "workspace": "your-workspace-name",
    "memoryStore": "your-memory-store-name"
  }
}

配置说明

参数

必填

说明

endpoint

API 端点,根据地域填写,例如cms.cn-hangzhou.aliyuncs.com

accessKeyId

阿里云 AK,支持 ${ENV_VAR} 语法

accessKeySecret

阿里云 SK,支持 ${ENV_VAR} 语法

workspace

工作空间名称

memoryStore

记忆库名称

userId

用户级数据隔离标识

agentId

Agent 级数据隔离标识

autoCapture

自动提取记忆(默认开启)

autoRecall

自动召回记忆(默认开启)

步骤三:配置环境变量

export ALIBABA_CLOUD_ACCESS_KEY_ID=your_access_key_id
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=your_access_key_secret

插件提供的能力

Agent 工具

插件为 Agent 注册了 3 个记忆操作工具:

工具名

功能

memory_recall

语义检索记忆库中的相关记忆

memory_store

将重要信息主动写入记忆库

memory_forget

删除指定记忆(按 ID 或模糊匹配)

自动化钩子

  • autoRecall:每次 Agent 轮次开始前,自动检索相关记忆并注入上下文。

  • autoCapture:每次 Agent 轮次结束后,自动提取有价值信息写入记忆库。

CLI 命令

# 搜索记忆
openclaw agentloop search "用户偏好"

# 添加记忆
openclaw agentloop add "用户喜欢深色主题"

# 列出所有记忆
openclaw agentloop list

# 删除记忆
openclaw agentloop delete <memory_id>

# 检查服务连通性
openclaw agentloop ping

验证

启动 OpenClaw 后,与 Agent 进行以下对话测试:

对话 1 - 建立记忆

用户:我是一名前端开发者,主要使用 React 和 TypeScript
Agent:好的,我记住了您是前端开发者,擅长 React 和 TypeScript。

对话 2 - 新会话验证记忆

用户:帮我写一个组件
Agent:(自动调用 memory_recall)
      根据我对您的了解,您使用 React + TypeScript,我来为您创建一个 TSX 组件...

如果 Agent 在新会话中能够记住之前的偏好,说明插件配置成功。