@pentatonic-ai/openclaw-memory-plugin

Persistent, searchable memory for OpenClaw. Local (Docker + Ollama) or hosted (Pentatonic TES).

⚠️ The local-mode config below targets a deprecated backend

The database_url / embedding_url / llm_url config fields shown in this README configure the legacy packages/memory/ Postgres+ Ollama+pgvector MCP server, which is being retired in favour of the 7-layer memory engine at packages/memory-engine/. Both backends still work; the legacy one will be removed in v1.0.

For new installs, prefer:

"pentatonic-memory": {
  "enabled": true,
  "config": {
    "mode": "local",
    "memory_url": "http://localhost:8099"
  }
}

…with the engine brought up via docker compose up -d from packages/memory-engine/. See the top-level SDK README for the walkthrough.

Install

openclaw plugins install @pentatonic-ai/openclaw-memory-plugin

Setup

Tell OpenClaw:

Set up pentatonic memory

Or configure manually in openclaw.json:

{
  "plugins": {
    "slots": { "contextEngine": "pentatonic-memory" },
    "entries": {
      "pentatonic-memory": {
        "enabled": true,
        "config": {
          "database_url": "postgres://memory:memory@localhost:5433/memory",
          "embedding_url": "http://localhost:11435/v1",
          "embedding_model": "nomic-embed-text",
          "llm_url": "http://localhost:11435/v1",
          "llm_model": "llama3.2:3b"
        }
      }
    }
  }
}

What it does

Every lifecycle event is handled automatically:

• Ingest — every message stored with embeddings + HyDE query expansion
• Assemble — relevant memories injected as context before every prompt
• Compact — decay cycle when context window fills
• After turn — high-access memories consolidated to semantic layer

Plus tools: memory_search, memory_store, memory_layers

Local vs Hosted

Local: Fully private. Requires Docker (Postgres + pgvector + Ollama). Run npx @pentatonic-ai/ai-agent-sdk memory to set up.

Hosted: Connect to Pentatonic TES for higher-dimensional embeddings, team memory, and analytics. Run npx @pentatonic-ai/ai-agent-sdk init.

License

MIT