> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mengram.io/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw Plugin

> Give your OpenClaw agent persistent memory with auto-recall, auto-capture, and 12 memory tools.

## Install

```bash theme={null}
openclaw plugins install openclaw-mengram
```

## Setup

1. Get a free API key at [mengram.io](https://mengram.io)

2. Add to `~/.openclaw/openclaw.json`:

```json theme={null}
{
  "plugins": {
    "entries": {
      "openclaw-mengram": {
        "enabled": true,
        "config": {
          "apiKey": "${MENGRAM_API_KEY}"
        }
      }
    },
    "slots": {
      "memory": "openclaw-mengram"
    }
  }
}
```

3. Set your API key:

```bash theme={null}
export MENGRAM_API_KEY="om-your-key-here"
```

4. Restart OpenClaw. Memory works automatically.

## How It Works

**Auto-recall:** Before every agent turn, relevant memories are injected into context via `before_agent_start` hook. No manual tool calls needed.

**Auto-capture:** After every turn, new information is automatically extracted and stored via `agent_end` hook. Nothing is lost.

## Tools

The agent can use these 12 tools explicitly:

| Tool | Purpose |
| - | - |
| `memory_search` | Search all 3 memory types with Graph RAG |
| `memory_store` | Save text to long-term memory |
| `memory_forget` | Delete a memory entity by name |
| `memory_profile` | Get cognitive profile (who the user is) |
| `memory_procedures` | List or search learned workflows |
| `memory_feedback` | Record workflow success/failure (triggers evolution) |
| `memory_episodes` | Search or list past events with date filtering |
| `memory_timeline` | Get chronological timeline of memory events |
| `memory_triggers` | Get smart triggers (reminders, contradictions, patterns) |
| `memory_insights` | Get AI-generated reflections and patterns |
| `memory_agents` | Run maintenance agents (curator, connector, digest) |
| `memory_graph` | Get the knowledge graph (entities + connections) |

## Slash Commands

| Command | Action |
| - | - |
| `/remember <text>` | Save to memory |
| `/recall <query>` | Search memory |
| `/forget <entity>` | Delete from memory |

## CLI

```bash theme={null}
openclaw mengram search "coffee preferences"   # Search all 3 memory types
openclaw mengram stats                          # Memory usage statistics
openclaw mengram profile                        # Cognitive profile
openclaw mengram procedures                     # List learned workflows
openclaw mengram episodes                       # List past events
openclaw mengram timeline                       # Chronological event timeline
openclaw mengram triggers                       # Smart triggers
openclaw mengram insights                       # AI-generated reflections
openclaw mengram agents                         # Run maintenance agents
openclaw mengram graph                          # Knowledge graph
openclaw mengram feed                           # Activity feed
openclaw mengram reindex                        # Reindex embeddings
openclaw mengram dedup                          # Deduplicate memories
openclaw mengram merge <source> <target>        # Merge two entities
```

## Configuration

| Option | Default | Description |
| - | - | - |
| `apiKey` | `$MENGRAM_API_KEY` | API key from mengram.io |
| `baseUrl` | `https://mengram.io` | Custom URL for self-hosted |
| `autoRecall` | `true` | Inject memories before each turn |
| `autoCapture` | `true` | Store memories after each turn |
| `topK` | `5` | Max results per search |
| `graphDepth` | `2` | Knowledge graph hops (0=off, 1, 2) |
| `injectProfile` | `false` | Include cognitive profile periodically |
| `profileFrequency` | `25` | Profile injection every N turns |
| `maxFactsPerEntity` | `5` | Max facts shown per entity in context |
| `maxRelationsPerEntity` | `5` | Max relationships shown per entity |
| `maxEpisodes` | `5` | Max episodic memories in context |
| `maxProcedures` | `3` | Max procedures in context |
| `maxStepsPerProcedure` | `8` | Max steps shown per procedure |
| `captureMessageCount` | `10` | Messages to capture after each turn |
| `maxTriggers` | `10` | Max triggers shown |
| `maxTimelineItems` | `20` | Max timeline items shown |
| `requestTimeout` | `15000` | HTTP timeout in milliseconds |
| `debug` | `false` | Verbose logging |

## Links

* [npm: openclaw-mengram](https://www.npmjs.com/package/openclaw-mengram)
* [GitHub: openclaw-mengram](https://github.com/alibaizhanov/openclaw-mengram)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.