Memory Hub 插件

OpenClaw 通过 MemoryHubProvider 插件与 Memory Hub 集成，实现 Agent 的自动记忆存取。

插件架构

安装与配置

安装插件

cd plugins/openclaw
pnpm install
pnpm build

配置

在 OpenClaw 配置中启用记忆插件：

{
  "memory": {
    "provider": "memory-hub",
    "config": {
      "baseUrl": "https://memory-hub.your-domain.com",
      "apiToken": "your-api-token"
    }
  }
}

TIP

apiToken 可通过 Memory Hub Web 界面的「个人设置 → 生成 API Token」获取。

自动行为

autoCapture（自动捕获）

Agent 会话结束时（agent_end hook），插件自动将对话摘要存储为短期记忆。

• 触发时机：每次 Agent 会话结束
• 存储类型：短期记忆（run_id = sessionKey）
• 自动提取：LLM 从对话中提取关键信息

autoRecall（自动召回）

Agent 会话开始时（before_prompt_build hook），插件自动检索相关记忆注入上下文。

• 触发时机：每次构建提示词之前
• 检索方式：并发查询长期记忆和当前会话短期记忆
• 注入位置：系统提示词中

Agent 主动操作

memory_store 工具

Agent 可以主动调用 memory_store 工具存储记忆：

memory_store(content="用户偏好使用 Go 语言", longTerm=true)

参数	说明
content	要存储的记忆内容
longTerm	true=长期记忆（默认），false=短期记忆

memory_search 工具

Agent 可以主动搜索记忆：

memory_search(query="用户的编程语言偏好")

过滤逻辑

插件内置了记忆过滤机制（filtering.ts），确保：

• 敏感信息不被存储（密码、Token、密钥等）
• 重复记忆自动去重
• 过期短期记忆自动清理

开发与测试

cd plugins/openclaw
pnpm install    # 安装依赖
pnpm build      # 构建
pnpm test       # 运行测试

WARNING

插件开发时请注意：所有记忆内容都不应包含密码、API Key、Token 等敏感信息。插件内置了基础过滤，但开发者应在 Agent 的 SOUL.md 中明确禁止存储敏感数据。