OpenClaw Membrain Plugin

Long-term memory for OpenClaw using Membrain.

The plugin automatically captures durable conversation context, recalls relevant memories before AI turns, and exposes memory tools for explicit store/search/forget/profile workflows.

Install

openclaw plugins install @alphanimble/openclaw-membrain

Restart OpenClaw after installing.

Setup

openclaw membrain setup

You will be asked for:

• Membrain API key
• Membrain API URL

Advanced Setup

openclaw membrain setup-advanced

Configure container tag, recall/capture behavior, and custom container routing.

How It Works

• Auto-Recall: before each AI turn, queries Membrain and injects context.
• Auto-Capture: after each successful AI turn, stores the last turn as conversation memory.
• Container Tagging: all plugin-written memories include container.<tag> to isolate/search/wipe cleanly.

Slash Commands

| Command | Description | | ------------------ | ---------------------------------- | | /remember <text> | Manually save something to memory. | | /recall <query> [-- raw/interpreted/both] | Search memories. Add -- interpreted or -- both for LLM summary. |

AI Tools

| Tool | Description | | ----------------- | -------------------------------------------- | | membrain_store | Save information to memory. Optional ingestionScope (tag regex) limits merge/link candidates during ingest only — same contract as Membrain ingestion_scope. | | membrain_search | Search memories by semantic query (+ filters). Optional responseFormat: raw, interpreted, or both. | | membrain_forget | Delete a memory by query or ID. | | membrain_profile| View profile-like summary and recent context. |

CLI Commands

openclaw membrain setup
openclaw membrain setup-advanced
openclaw membrain status
openclaw membrain search <query> [--response-format raw|interpreted|both]
openclaw membrain profile
openclaw membrain wipe

Configuration

Environment variables:

export MEMBRAIN_OPENCLAW_API_KEY="mb_live_..."
export MEMBRAIN_OPENCLAW_API_URL="https://your-membrain-api.com"

Fallback env vars also supported:

export MEMBRAIN_API_KEY="mb_live_..."
export MEMBRAIN_API_URL="https://your-membrain-api.com"

Or configure in ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "openclaw-membrain": {
        "enabled": true,
        "config": {
          "apiKey": "${MEMBRAIN_OPENCLAW_API_KEY}",
          "apiUrl": "${MEMBRAIN_OPENCLAW_API_URL}",
          "containerTag": "my_memory",
          "autoRecall": true,
          "autoCapture": true,
          "maxRecallResults": 10,
          "profileFrequency": 50,
          "captureMode": "all",
          "debug": false,
          "enableCustomContainerTags": true,
          "customContainers": [
            { "tag": "work", "description": "Work-related memories" },
            { "tag": "personal", "description": "Personal memories" }
          ],
          "customContainerInstructions": "Route work items to work and personal details to personal"
        }
      }
    }
  }
}