evomem-openclaw-plugin

面向 OpenClaw 的长期记忆插件。

1. 环境要求

1. 已安装 OpenClaw
   官方文档: https://docs.openclaw.ai/start/getting-started
2. Python 3.10+

python3 --version

如果网关环境默认是 Python 3.8/3.9，请在插件配置里显式指定：

{
  "bridgePython": "/absolute/path/to/python3.10+"
}

2. 安装（推荐顺序）

openclaw plugins install @senseauto-evomem/evomem-openclaw-plugin --force --dangerously-force-unsafe-install

3. 配置与启用

1. 准备 config.json（示例）

{
  "llmBaseUrl": "",
  "llmModel": "",
  "llmApiKey": "",
  "embeddingBaseUrl": "",
  "embeddingApiKey": "",
  "embeddingModel": "",
  "rerankerBaseUrl": "",
  "rerankerApiKey": ""
}

2. 拷贝到插件目录

cp config.json ~/.openclaw/extensions/evomem-openclaw-plugin/config.json

3. 重启 OpenClaw gateway

4. 新版 OpenClaw 接入说明

OpenClaw 新版对插件介入时机做了升级，本插件已适配：

1. before_agent_reply 作为优先接入点（新版 typed hook）。
2. before_agent_start 作为兼容兜底（旧版/过渡版本）。
3. agent_end 保留为兼容 capture 路径；若未触发，会在下一轮开始时补偿写入上一轮记忆。

日志关键字（用于排查）：

• 收到 OpenClaw before_agent_reply，准备 recall
• before_agent_reply 触发兼容 capture（上一轮）
• 跳过 recall：before_agent_start 重复触发（去重）

5. 卸载

openclaw plugins uninstall @senseauto-evomem/evomem-openclaw-plugin

默认保留数据目录：

~/.openclaw/plugin-data/evomem-openclaw-plugin/