ltm-claw

Long-term memory (LTM) access for OpenClaw without bloating session context using subagents (sidecar).

Overview

ltm-claw gives your OpenClaw agent persistent, queryable memory across sessions. It is installed as an OpenClaw plugin and exposes tools for storing and retrieving memories.

v1 (current): grep-based session history search via subagent — no external dependencies.

v2 (coming): Typed memories + hybrid BM25/vector search using a local llama-server embedding endpoint.

v3: Graph traversal + reflection.

v4: Self-evolution + memory hygiene.

See ROADMAP.md for full milestones.

Installation

v1 has no external dependencies (no SQLite, no embeddings). Just the subagent grep pipeline.

Host requirements: python3 and jq must be available in PATH.

openclaw plugins install @airouter.ch/ltm-claw

Configuration

Defaults are set during installation in ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "ltm-claw": {
        "enabled": true,
        "config": {
          "retrievalTimeoutSeconds": 60,
          "workspaceDir": "/tmp/ltm-claw"
        }
      }
    }
  }
}

Tools

ltm_search

Search session history via grep + subagent.

Usage

ltm_search is triggered automatically when you ask about past conversations, prior work, or anything that would require context from earlier sessions. Examples:

"Hey, didn't we talk about Rickrolling someone last week?"

## a3f9c812 (2026-03-18)

Never gonna give you up — the session discussed deploying a Never Gonna Give You Up
autoresponder as a mitigation for a specific trigger phrase. The decision was to flag
it as low-priority幽默 rather than implement it as a production rule.

"What did we decide on the Ultimate Answer again?"

## 7b2d1e45 (2026-03-21)

42. The session confirmed 42 as the agreed-upon answer, contingent on the universe
not changing its numbering system. Further research into alternative numbering systems
was deemed out of scope but noted for v3 graph traversal.

Project docs

| File | Purpose | |------|---------| | README.md | This file — overview, install, tools | | ROADMAP.md | Version milestones |

💜 Sponsors

AI Router Switzerland — unlimited API access with flatrate pricing. Main sponsor of the infrastructure and research behind ltm-claw.

📄 License

This project is licensed under the MIT License.