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

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

你要做什么（按顺序）

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

2. 先检查 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 ...）。

3. 安装 PowerMem（Python）
   建议用虚拟环境，然后安装：

   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）：

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

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

6. 重启网关并检查

   openclaw gateway
   

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

   openclaw plugins list
   

   输出里要有 memory-powermem，且其状态为 loaded（已加载）。若只有安装记录、状态不是 loaded，先按下面「若某一步失败」处理，不要跳过这步直接去测 ltm。
   通过后再检查记忆健康并试写读：

   openclaw ltm health
   

   显示健康后试一句：

   openclaw ltm add "我喜欢喝美式"
   openclaw ltm search "咖啡"
   

若某一步失败

说明（一句话）

记忆数据默认存在本机 OpenClaw 数据目录下的 SQLite 里；不需要你再单独维护一份 PowerMem 的 .env，除非你熟悉进阶配置。