核心用法
本 Skill 提供 PowerMem 长期记忆插件的端到端安装与配置指南，适用于 OpenClaw 生态。主要功能包括：
- 自动捕获 (Auto-Capture)：对话结束后自动提取有价值信息存入长期记忆
- 自动回忆 (Auto-Recall)：每次对话前自动检索相关记忆并注入上下文
- 双模式支持：本地 CLI 模式（SQLite 默认）或企业级 HTTP 服务模式
安装流程（关键步骤）
1. 前置检查：OpenClaw 已安装且默认模型配置完成；Python 3.10+ 验证通过
2. Python 环境：创建 venv，执行 pip install powermem
3. 插件安装：通过 openclaw plugins install 或官方 install.sh 脚本
4. OpenClaw 配置：设置插件槽位、模式选择（cli/http）、自动捕获/回忆开关
5. 验证启动：重启 gateway，执行 openclaw ltm health 及增删查测试
显著优点
- 零配置开箱即用：默认启用
useOpenClawModel，自动复用 OpenClaw 的 LLM 和 embedding 配置，无需额外 API key 管理 - 智能处理：支持
inferOnAdd自动提炼关键信息，避免存储冗余内容 - 灵活部署：既支持个人本地 SQLite，也支持团队共享的 HTTP 服务架构
- 深度集成：通过
<relevant-memories>块无缝注入上下文，不改变现有对话流
潜在缺点与局限性
- Python 版本硬性要求：必须 3.10+，旧系统需额外升级步骤
- 依赖链复杂：涉及 OpenClaw、Python、pip、venv、插件系统多层依赖，任一环节出错均会阻断
- 存储位置隐式绑定：SQLite 文件位置与 OpenClaw
stateDir耦合，多实例场景易混淆数据 - HTTP 模式运维成本：企业部署需自行维护服务可用性和网络连通性
适合人群
- 需要跨对话保持上下文的 OpenClaw 重度用户
- 愿意投入时间维护本地 Python 环境的开发者
- 寻求团队级记忆共享方案的技术负责人
常规风险
- 数据隔离风险：
stateDir配置错误可能导致记忆数据写入非预期位置 - 版本兼容性：Python、OpenClaw、PowerMem 三版本需协同匹配
- API 密钥泄露：若禁用
useOpenClawModel，.env文件需妥善保管 - 存储增长：长期运行后 SQLite 文件体积膨胀，需考虑归档策略
配置要点速查
| 关键配置 | 说明 |
|---------|------|
| `useOpenClawModel: true` | 复用 OpenClaw LLM（推荐） |
| `autoCapture/autoRecall` | 自动化管道开关 |
| `pmemPath` | CLI 二进制绝对路径（venv 场景必填） |
| `envFile` | 可选覆盖配置，非必需 |
故障排查优先级
1. Python 版本 ≥ 3.10（最常见卡点）
2. pmem 可执行文件在 PATH 中
3. OpenClaw 默认模型和 provider 认证有效
4. 插件状态为 loaded 且槽位配置正确