为 OpenClaw 配置长期记忆插件

效果对比

以下两段对话展示同一场景下，默认 Agent 与使用长期记忆插件后的 Agent 行为差异。

工作原理

记忆插件在 OpenClaw Gateway 内运行，通过两个生命周期钩子（before_agent_start和agent_end）与阿里云百炼长期记忆 API 交互。所有读写操作通过 HTTPS 请求发送至阿里云百炼服务端，由阿里云百炼完成提炼、向量化和语义检索。

• 自动记忆捕获（autoCapture）：对话结束后自动提取关键信息存储

• 自动记忆召回（autoRecall）：对话开始前自动检索相关记忆注入上下文

安装与配置插件

openclaw gateway status

openclaw plugins install @modelstudio/modelstudio-memory-for-openclaw

{
  "plugins": {
    "slots": {
      "memory": "modelstudio-memory-for-openclaw"
    },
    "entries": {
      "modelstudio-memory-for-openclaw": {
        "enabled": true,
        "config": {
          "apiKey": "sk-xxx",
          "userId": "user_001",
          "profileSchema": "（此参数非必填）your_profile_schema_id",
          "memoryLibraryId": "（此参数非必填）your_memory_library_id",
          "projectId": "（此参数非必填）your_project_id"
        }
      }
    }
  }
}

# 查看插件信息
openclaw plugins info modelstudio-memory-for-openclaw

# 查看状态
openclaw modelstudio-memory stats

openclaw gateway restart

openclaw plugins info modelstudio-memory-for-openclaw

Memory (Bailian)
id: modelstudio-memory-for-openclaw
Status: loaded
Tools: memory_search, memory_store, memory_list, memory_forget
CLI commands: modelstudio-memory

openclaw modelstudio-memory stats

User: user_001
Total memories: 0
Auto-capture: true
Auto-recall: true
Top-K: 5

至此，长期记忆插件配置完成，Agent 的自动捕获和召回已默认启用，无需任何手动操作。打开 OpenClaw 面板页面（默认地址：http://127.0.0.1:18789）即可与启用记忆的 Agent 开始对话。

在对话中使用记忆工具

除自动捕获和自动召回外，插件还向 Agent 注册了四个工具，Agent 可在对话过程中根据语境主动调用。

• memory_search：语义检索记忆库。接收一个自然语言查询，对记忆库执行语义检索，返回相似度最高的记忆列表。当用户提出 "之前讨论过什么"或"关于数据库的记忆"等回顾性问题时，Agent 会自动选择该工具。

• memory_store：直接写入记忆。将指定内容直接写入记忆库，不经过对话提炼。适用于用户主动要求 Agent 记住某个特定事实的场景，例如"记住我的服务器 IP 是 192.168.1.xxx"。

• memory_list：分页列出记忆。分页列出当前 userId 下的所有记忆条目，用于浏览和管理已有记忆。

• memory_forget：根据记忆 ID 删除指定记忆。Agent 通常先通过 memory_search 定位目标记忆，再调用 memory_forget 执行删除。

CLI 等效命令：

# 语义检索记忆
openclaw modelstudio-memory search "用户偏好"

# 分页列出所有记忆
openclaw modelstudio-memory list --page 1 --size 10

# 查看记忆统计
openclaw modelstudio-memory stats

配额与限制

阿里云百炼长期记忆 API 存在以下速率限制：

性能指标：

• SearchMemory 端到端延迟：200–500ms

• AddMemory 延迟：500–1000ms

• 自动捕获异步执行，不影响响应速度

常见问题

1. Gateway 重启后插件状态为 not loaded？

   检查 openclaw.json 中 plugins.entries.modelstudio-memory-for-openclaw.enabled 是否为 true，以及 plugins.slots.memory 是否指向 "modelstudio-memory-for-openclaw"。修正后再次执行 openclaw gateway restart。

2. 日志中出现 InvalidApiKey 错误？

   DashScope API Key 无效或已过期。登录阿里云百炼控制台确认 API Key 状态，必要时重新创建。若使用环境变量引用，确认 DASHSCOPE_API_KEY 已正确设置且 Gateway 进程能读取到该变量。

3. 支持配置阿里云百炼 Coding Plan 的 API Key？

   不支持。

4. 如何查看插件运行日志？

   OpenClaw Gateway 的日志文件按日期存储在系统临时目录中，文件名格式为 openclaw-YYYY-MM-DD.log

   # Linux / macOS
   tail -f /tmp/openclaw/openclaw-$(date +%F).log | grep modelstudio-memory
   # Windows PowerShell
   Get-Content "$env:TEMP\openclaw\openclaw-$(Get-Date -Format 'yyyy-MM-dd').log" -Wait | Select-String "modelstudio-memory"

   本文档完成了从安装到验证的完整流程。插件的自动捕获与自动召回机制已覆盖大部分使用场景，无需额外干预。后续可关注记忆数据在记忆库中的增长情况，并根据业务规模调整 topK 和缓存策略。

相关文档