PowerMem 记忆 · 极简安装（个人用户）#

你只要记住几件事： OpenClaw 能正常聊天、 Python 先确认 ≥ 3.10、 本机装好 PowerMem、 装上插件。不用手写 powermem.env，记忆用的模型和 Key 会跟你在 OpenClaw 里配的一样。

---

你要做什么（按顺序）#

1. 确认 OpenClaw 已经能用

   终端执行 openclaw --version，并且你已经在 OpenClaw 里配好了 平时对话用的模型（能正常回复即可）。

2. 先检查 Python 版本（必须 ≥ 3.10）

   在创建虚拟环境或执行 pip install 之前 必须先确认版本，否则后续容易装失败或运行异常： bash

   python3 --version
   
   

   输出应为 Python 3.10.x、3.11.x、3.12.x 等（次版本号 ≥ 10）。也可用下面命令做一次硬性校验（不通过会报错退出）： bash

   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 ...）。

3. 安装 PowerMem（Python）

   建议用虚拟环境，然后安装： bash

   python3 -m venv ~/.openclaw/powermem/.venv
   source ~/.openclaw/powermem/.venv/bin/activate
   pip install powermem
   
   

   装好后执行 pmem --version，能输出版本就行。

4. 让网关能找到 pmem

   如果你启动 openclaw gateway 的终端 没有 激活上面的 venv，有两种简单办法二选一：

   • 每次开网关前先 source ~/.openclaw/powermem/.venv/bin/activate；或
   • 在插件配置里把 pmemPath 写成 venv 里 pmem 的 完整路径（装完后可用 which pmem 查看）。

5. 一键装插件（推荐）

   在 Mac / Linux 上执行（需已安装 OpenClaw）： bash

   curl -fsSL https://raw.githubusercontent.com/ob-labs/memory-powermem/main/install.sh | bash -s -y
   
   

   脚本会把插件放进 OpenClaw，并打开「用 OpenClaw 的模型驱动记忆」等默认选项。

6. 重启网关并检查 bash

   openclaw gateway
   
   

   另开终端， 先 确认插件已被网关加载： bash

   openclaw plugins list
   
   

   输出里要有 memory-powermem，且其状态为 loaded（已加载）。若只有安装记录、状态不是 loaded，先按下面「若某一步失败」处理， 不要 跳过这步直接去测 ltm。

   通过后再检查记忆健康并试写读： bash

   openclaw ltm health
   
   

   显示健康后试一句： bash

   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，除非你熟悉进阶配置。