Install
openclaw skills install install-powermem-memory-minimalmemory-powermem 最小安装步骤(OpenClaw + PowerMem 长期记忆),面向个人用户;无需单独配置 powermem.env,复用 OpenClaw 里已配好的对话模型。本 skill 可独立分发,不依赖其他安装类 skill。
openclaw skills install install-powermem-memory-minimal你只要记住几件事:OpenClaw 能正常聊天、Python 先确认 ≥ 3.10、本机装好 PowerMem、装上插件。不用手写 powermem.env,记忆用的模型和 Key 会跟你在 OpenClaw 里配的一样。
确认 OpenClaw 已经能用
终端执行 openclaw --version,并且你已经在 OpenClaw 里配好了平时对话用的模型(能正常回复即可)。
先检查 Python 版本(必须 ≥ 3.10)
在创建虚拟环境或执行 pip install 之前必须先确认版本,否则后续容易装失败或运行异常:
python3 --version
输出应为 Python 3.10.x、3.11.x、3.12.x 等(次版本号 ≥ 10)。也可用下面命令做一次硬性校验(不通过会报错退出):
python3 -c "import sys; assert sys.version_info >= (3, 10), '需要 Python 3.10 或更高'; print(sys.version.split()[0], 'OK')"
若版本不够:先升级本机 Python,或安装并使用 python3.11 / python3.12 等满足要求的解释器,并将下面步骤里的 python3 换成实际命令(例如 python3.12 -m venv ...)。
安装 PowerMem(Python)
建议用虚拟环境,然后安装:
python3 -m venv ~/.openclaw/powermem/.venv
source ~/.openclaw/powermem/.venv/bin/activate
pip install powermem
装好后执行 pmem --version,能输出版本就行。
让网关能找到 pmem
如果你启动 openclaw gateway 的终端没有激活上面的 venv,有两种简单办法二选一:
source ~/.openclaw/powermem/.venv/bin/activate;或pmemPath 写成 venv 里 pmem 的完整路径(装完后可用 which pmem 查看)。一键装插件(推荐)
在 Mac / Linux 上执行(需已安装 OpenClaw):
curl -fsSL https://raw.githubusercontent.com/ob-labs/memory-powermem/main/install.sh | bash -s -y
脚本会把插件放进 OpenClaw,并打开「用 OpenClaw 的模型驱动记忆」等默认选项。
重启网关并检查
openclaw gateway
另开终端,先确认插件已被网关加载:
openclaw plugins list
输出里要有 memory-powermem,且其状态为 loaded(已加载)。若只有安装记录、状态不是 loaded,先按下面「若某一步失败」处理,不要跳过这步直接去测 ltm。
通过后再检查记忆健康并试写读:
openclaw ltm health
显示健康后试一句:
openclaw ltm add "我喜欢喝美式"
openclaw ltm search "咖啡"
| 情况 | 怎么办 |
|---|---|
python3 --version 低于 3.10 | 先升级或换用 python3.11 / python3.12 等,再重做「检查 Python」与 venv 步骤;不要跳过版本检查强行 pip install。 |
pip install powermem 报错 | 再次确认 Python ≥ 3.10;换干净 venv 再试。 |
pmem 找不到 | 激活 venv,或配置 pmemPath 为绝对路径。 |
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、自建服务器等) | 查阅 memory-powermem 仓库根目录的 INSTALL.md 与 README。 |
记忆数据默认存在本机 OpenClaw 数据目录下的 SQLite 里;不需要你再单独维护一份 PowerMem 的 .env,除非你熟悉进阶配置。