install-powermem-memory-minimal
# 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](https://github.com/ob-labs/memory-powermem)** 仓库根目录的 **INSTALL.md** 与 **README**。 |
---
## 说明（一句话）
记忆数据默认存在本机 OpenClaw 数据目录下的 SQLite 里；**不需要**你再单独维护一份 PowerMem 的 `.env`，除非你熟悉进阶配置。
标签
skill
ai
