Package Exports

@unforget-ai/openclaw
@unforget-ai/openclaw/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@unforget-ai/openclaw) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Unforget Memory Plugin for OpenClaw

Long-term memory for your OpenClaw agents. Zero LLM on write. Zero config.

Install

openclaw plugins install @unforget-ai/openclaw

Requires Python 3.12 with unforget-embed:

pipx install unforget-embed --python python3.12

That's it. No API keys. No Docker. No database setup.

How It Works

Auto-Recall: Before each prompt, relevant memories are retrieved and injected into context
Auto-Retain: After each response, conversation turns are stored as memories
Forget/Remember: Say "forget that I like pizza" or "remember my name is Kobi" — handled automatically
4-Channel Retrieval: Semantic + BM25 + entity + temporal search, fused with RRF

Usage

Just chat normally. The plugin handles everything:

You: My name is Alex and I like sushi
Agent: Got it — I'll remember that, Alex.

/new (new session)

You: What's my name and what food do I like?
Agent: Your name is Alex and you like sushi.

You: Forget that I like sushi
Agent: Forgotten.

/new

You: What food do I like?
Agent: You haven't told me any food preferences.

Configuration

The plugin works with zero config. Optional settings in openclaw.json:

{
  "plugins": {
    "entries": {
      "@unforget-ai/openclaw": {
        "enabled": true,
        "config": {
          "orgId": "openclaw",
          "autoRetain": true,
          "autoRecall": true,
          "autoRecallTopK": 10,
          "debug": false
        }
      }
    }
  }
}

External Server

If you already run Unforget or want to use your own PostgreSQL:

{
  "config": {
    "apiUrl": "http://localhost:9077"
  }
}

Architecture

OpenClaw agent
    │ hooks: before_agent_start, agent_end
    ▼
@unforget-ai/openclaw plugin (TypeScript)
    │ HTTP to localhost:9077
    ▼
unforget-embed (auto-started Python daemon)
    ├── unforget core library (4-channel retrieval)
    └── pgserver (embedded PostgreSQL + pgvector)

License

Apache 2.0