PowerMem 记忆 · 快速安装(个人用户)
本 skill 在 OpenClaw 中的标识与建议目录名为 install-memory-powermem。若需要 HTTP/多实例、工具表与详细排错,请改用 install-memory-powermem-full(仓库内 skills/install-memory-powermem-full/,需一并拷贝该目录下全部 .md)。
你只要记住几件事:OpenClaw 能正常聊天、装上 memory-powermem 插件。默认走 powermem-ts(npm 包名 powermem,由插件依赖提供,不需要先装 Python)。不用手写 powermem.env,记忆用的模型和 Key 会跟你在 OpenClaw 里配的一样。
你要做什么(按顺序)
确认 OpenClaw 已经能用
终端执行openclaw --version,并且你已经在 OpenClaw 里配好了平时对话用的模型(能正常回复即可)。安装 memory-powermem 插件
任选其一:- registry:
openclaw plugins install memory-powermem - 一键脚本(Mac / Linux):
已克隆本仓库时可在根目录执行curl -fsSL https://raw.githubusercontent.com/ob-labs/memory-powermem/main/install.sh | bash -s -ybash install.sh(可加-y;多实例:bash -s -- --workdir ~/.openclaw-second)。 - 本地克隆:
openclaw plugins install /path/to/memory-powermem或openclaw plugins install -l(软链开发)
默认pmemPath: bundled:使用插件依赖里的 powermem-ts(npm 包名powermem)提供的 CLI,不需要本机pip install powermem。
- registry:
若从本地路径安装:在插件目录安装 Node 依赖
从 npm registry 安装或install.sh已在插件目录执行过依赖安装时,可跳过本步。否则进入 OpenClaw 指向的插件目录(或克隆根目录),执行pnpm install/npm install,确保拉取powermem、@langchain/openai等。使用 pnpm 10+ 时若better-sqlite3未编译,可执行pnpm rebuild better-sqlite3(仓库package.json已配置pnpm.onlyBuiltDependencies时一般可自动构建)。(可选)改用 Python 版
pmem
若你希望使用 oceanbase/powermem 的 Python CLI:Python ≥ 3.10,pip install powermem,并在插件配置里将pmemPath设为 venv 中pmem的绝对路径。详见install-memory-powermem-full与 config-reference.md。重启网关并检查
openclaw gateway restart另开终端,先确认插件已被网关加载:
openclaw plugins list输出里要有 memory-powermem,且其状态为 loaded(已加载)。若只有安装记录、状态不是 loaded,先按下面「若某一步失败」处理,不要跳过这步直接去测
ltm。
通过后再检查记忆健康并试写读:openclaw ltm health显示健康后试一句:
openclaw ltm add "我喜欢喝美式" openclaw ltm search "咖啡"
若某一步失败
| 情况 | 怎么办 |
|---|---|
pmem / CLI 找不到、ERR_MODULE_NOT_FOUND(如 @langchain/openai) |
在插件目录执行 pnpm install / npm install;路径安装用 openclaw plugins install -l 时确保依赖完整。 |
better-sqlite3 未编译(pnpm 忽略构建脚本) |
在插件目录 pnpm rebuild better-sqlite3,或配置 pnpm.onlyBuiltDependencies 后重装依赖(见仓库 package.json)。 |
坚持用 Python pmem 但找不到命令 |
激活 venv,或配置 pmemPath 为 which pmem 的绝对路径。 |
plugins list 没有 memory-powermem,或状态不是 loaded |
确认已执行安装脚本或 openclaw plugins install;plugins.enabled 为 true、plugins.slots.memory 为 memory-powermem;改完后重启 gateway,再执行 openclaw plugins list 复查。 |
ltm health 不健康 |
确认 OpenClaw 里默认模型和 API Key 本身能聊天;升级 OpenClaw 到较新版本后再试。 |
想要更多选项(多实例、HTTP、install.sh 细节、工具与排错表等) |
使用 install-memory-powermem-full skill(含 config-reference.md),或查阅 memory-powermem 的 README。 |
说明(一句话)
记忆数据默认存在本机 OpenClaw 数据目录下的 SQLite 里;默认 CLI 为 powermem-ts(npm);不需要你再单独维护一份 PowerMem 的 .env,除非你熟悉进阶配置。userId/agentId 未配置会自动生成并持久化。HTTP + dualWrite 场景可选 localVector(sqlite-vec)提升本地兜底搜索质量。