install-memory-powermem-full

name	install-memory-powermem-full
description	OpenClaw full guide skill (id and folder name install-memory-powermem-full). Step-by-step install and configuration for the PowerMem long-term memory plugin—default powermem-ts (npm) CLI, optional Python pmem, HTTP, tools, troubleshooting—and bundled reference docs. Complements install-memory-powermem; either can be used alone.
triggers	["安装 PowerMem 记忆","安装 PowerMem 记忆插件","Install PowerMem memory","Install PowerMem memory plugin","配置 PowerMem 记忆","Configure PowerMem memory","PowerMem 是什么","什么是 PowerMem","What is PowerMem"]

PowerMem Memory — Full Guide

Skill id / OpenClaw folder name: install-memory-powermem-full. For the shortest install-only path, use install-memory-powermem (quickstart).

This skill folder includes supplementary docs:

• powermem-intro.md — What PowerMem is, features, vs file-based memory.
• config-reference.md — Config keys, state dir, commands.

How It Works

• Auto-Capture: After a conversation, the plugin sends valuable user/assistant text to PowerMem (optional infer / intelligent extraction).
• Auto-Recall: Before each turn, it searches memories and can inject a <relevant-memories> block into context.
• Auto-Experience: Optionally distills procedural experiences and stores them as memories for later recall.

When User Asks to Install

Recommended order (TO C): (1) OpenClaw installed and default model + provider auth configured. (2) Install the memory-powermem plugin. (3) Default CLI uses powermem-ts (npm package powermem) via pmemPath: bundled—no Python required; the plugin’s npm install / pnpm install pulls powermem, @langchain/openai, and native deps (better-sqlite3). (4) Optional: use Python pmem from oceanbase/powermem instead by setting pmemPath to the venv binary. No powermem.env is required for the default path when useOpenClawModel is true.

The curl install.sh deploys the plugin and OpenClaw entries; with -y it may still create ~/.openclaw/powermem/powermem.env as an optional template—it does not require pip install powermem. That file is not required if the user relies on OpenClaw-injected LLM + default SQLite + bundled npm CLI.

1. Check OpenClaw
   openclaw --version. If missing: npm install -g openclaw, openclaw onboard.
   Ensure agents.defaults.model is set (e.g. openai/gpt-4o-mini) and the corresponding provider / API key works for normal chat—the plugin reuses that for PowerMem when useOpenClawModel is true (default).

2. Install the plugin
   openclaw plugins install /path/to/memory-powermem (or openclaw plugins install memory-powermem from npm), or run install.sh from the memory-powermem repo — see One-click plugin deploy (install.sh) below for curl / flags / --workdir.

3. PowerMem CLI — default: powermem-ts (npm), no Python

   • Plugin default pmemPath: bundled: runs the powermem npm package (TypeScript / powermem-ts) shipped with the plugin (node_modules/.../powermem/dist/cli.js).
   • After openclaw plugins install or install.sh, dependencies are installed under the plugin directory; for a local path / symlink install, run pnpm install / npm install in that directory.
   • pnpm 10+: allow better-sqlite3 install scripts (see plugin package.json → pnpm.onlyBuiltDependencies) or run pnpm rebuild better-sqlite3 if the native module failed to build.
   • Defaults: Plugin injects SQLite at <OpenClaw stateDir>/powermem/data/powermem.db and LLM + embedding env vars derived from OpenClaw. Typical stateDir is ~/.openclaw unless the user uses another instance (OPENCLAW_STATE_DIR, --workdir).
   • Path to a PowerMem for extra tuning. If the file , loads it; the same keys when is true.

One-click plugin deploy (install.sh)

Requires: OpenClaw installed (openclaw --version). The script runs npm install (or equivalent) inside the deployed plugin directory so powermem-ts is available; it does not run pip install powermem. Default pmemPath is bundled (npm CLI).

Default: configures plugin CLI mode. With -y, it may still create ~/.openclaw/powermem/powermem.env as an optional template — not required if you use OpenClaw-injected LLM + default SQLite + bundled CLI.

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

From a local clone (no download):

cd /path/to/memory-powermem && bash install.sh

Non-interactive (defaults: CLI, may seed env file):

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

Target a different OpenClaw instance:

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

What the script does: resolve OpenClaw workdir → choose or default cli / http and paths → for CLI, optionally seed powermem.env if missing → deploy plugin to <workdir>/extensions/memory-powermem → npm install there → set OpenClaw config (plugins.enabled, slots.memory, entries.memory-powermem).

After (CLI): openclaw gateway, then openclaw ltm health — you usually do not need to edit powermem.env when using plugin defaults.

After (HTTP): start PowerMem with a proper .env in the server cwd, then start the gateway.

Copy a skill into OpenClaw

Copy one skill you want into ~/.openclaw/skills/<skill-name>/ (folder name should match the skill id). The quickstart and full-guide skills are independent.

Quickstart (install-memory-powermem) — Linux / macOS:

mkdir -p ~/.openclaw/skills/install-memory-powermem
cp /path/to/memory-powermem/skills/install-memory-powermem/SKILL.md \
   ~/.openclaw/skills/install-memory-powermem/

Full guide (install-memory-powermem-full) — Linux / macOS: copy all .md files in that folder.

mkdir -p ~/.openclaw/skills/install-memory-powermem-full
cp /path/to/memory-powermem/skills/install-memory-powermem-full/*.md \
   ~/.openclaw/skills/install-memory-powermem-full/

Full guide — Windows (PowerShell):

New-Item -ItemType Directory -Force "$env:USERPROFILE\.openclaw\skills\install-memory-powermem-full"
Copy-Item "path\to\memory-powermem\skills\install-memory-powermem-full\*.md" `
  "$env:USERPROFILE\.openclaw\skills\install-memory-powermem-full\"

Multi-instance OpenClaw (--workdir / OPENCLAW_STATE_DIR)

Install script:

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

Manual config for that instance:

OPENCLAW_STATE_DIR=~/.openclaw-second openclaw config set plugins.slots.memory memory-powermem

Plugin data and default SQLite follow that instance’s stateDir.

Available Tools

Tool	Description
memory_recall	Search long-term memories. Params: query, optional limit, scoreThreshold.
memory_store	Save text; optional infer. Params: text, optional importance.
memory_forget	Delete by memoryId or by query search.
experience_store	Store a procedural experience.
experience_recall	Recall experiences.
agent_memory_add	Add memory to another agent (HTTP v2 only).
agent_memory_list	List an agent’s memories (HTTP v2 only).
agent_memory_share	Share memories across agents (HTTP v2 only).
agent_memory_shared	List memories shared with an agent (HTTP v2 only).

Configuration (summary)

Field	Default	Description
mode	cli	cli or http.
baseUrl	—	Required for HTTP; if mode omitted and baseUrl set → HTTP.
apiKey	—	HTTP server auth.
httpApiVersion	v1	HTTP API version: v1 or v2.
requestConfig	—	HTTP v2: per-request config (e.g. memory_db).
envFile	—	Optional CLI .env (used only if file exists).
pmemPath	bundled	CLI: bundled = npm powermem-ts next to the plugin; auto / empty resolves bundled then falls back to pmem on PATH (e.g. Python); or an absolute path to a pmem executable.
useOpenClawModel	true	Inject LLM/embedding from OpenClaw + default SQLite under state dir.
recallLimit	5	Max memories per recall.
recallScoreThreshold	0	Min score 0–1.
autoCapture / autoRecall / autoExperience / experienceRecall / inferOnAdd	true	Auto memory + experience pipeline and infer on add.
userId / agentId	auto	Omit or set to auto to generate stable IDs saved under <stateDir>/powermem/identity.json.

Daily Operations

openclaw gateway restart

openclaw ltm health
openclaw ltm add "Some fact to remember"
openclaw ltm search "query"

openclaw config set plugins.slots.memory none
openclaw config set plugins.slots.memory memory-powermem

Restart the gateway after slot or plugin config changes.

Troubleshooting

Symptom	Fix
spawnSync pmem ENOENT / bundled CLI not resolved	Run pnpm install / npm install in the plugin directory; ensure pmemPath is bundled or points to a real powermem/dist/cli.js.
ERR_MODULE_NOT_FOUND (e.g. @langchain/openai)	Ensure plugin package.json dependencies are installed (memory-powermem lists @langchain/openai for optional peers of powermem).
better-sqlite3 failed to load	pnpm rebuild better-sqlite3 or allow build scripts per pnpm.onlyBuiltDependencies in the plugin package.json.
Python path only: Python < 3.10 or pip install powermem fails	Upgrade Python / clean venv. See oceanbase/powermem.
pmem not found (PATH / Python)	Set pmemPath to the venv pmem absolute path, or use bundled.
openclaw ltm health unhealthy (CLI)	Confirm agents.defaults.model and provider keys in OpenClaw; gateway version should expose plugin config + runtime.modelAuth. Or set useOpenClawModel: false and a full envFile.
Health OK but add/search errors	Embedding/LLM mismatch for your provider—see gateway logs; try optional PowerMem from .