Memori Long-Term Memory

Memori - Structured Long-term Memory for OpenClaw

Give your OpenClaw agents persistent, structured memory derived from agent execution, tool usage, workflow history, and conversations. Memori integrates seamlessly in the background via lifecycle hooks and provides agents with the tools to retrieve context when it is relevant.

Core Workflow

Memori operates on two parallel tracks through standard OpenClaw lifecycle hooks:

1. Advanced Augmentation (automatic)

After each interaction, Memori converts raw session data into structured, reusable memories asynchronously.

• Transforms raw agent sessions into structured memory units
• Captures the agent's actions, reasoning, tool usage, responses, corrections, and failures
• Organizes into classes to enable efficient retrieval
• Generates embeddings for semantic retrieval
• Updates structured memory and the knowledge graph

This is how structured memory is continuously built and updated over time. It runs after the agent responds and does not impact latency.

2. Agent-Controlled-Intelligent Recall

Recall is explicit and initiated by the agent.

Memori separates memory creation from memory recall:

• Creation is automatic (advanced augmentation)
• Recall is intentional (agent-controlled)

Agents decide:

• When to recall
• What scope to recall from
• How much history to include

To maintain an efficient context window, Memori equips the agent with specific tools to retrieve history when required for the conversation:

1. memori_recall: Searches the structured memory graph for specific facts, constraints, and prior decisions.
2. memori_recall_summary: Retrieves structured daily briefs and rolling summaries of prior sessions.
3. memori_compaction: Retrieves structured post-compaction brief to continue task without interruption.
4. memori_feedback: Reports on memory quality to improve extraction accuracy.

Installation

openclaw plugins install @memorilabs/openclaw-memori

Configuration

Add to your ~/.openclaw/openclaw.json or use the openclaw memori init CLI command to set up your workspace:

openclaw memori init \
  --api-key "YOUR_MEMORI_API_KEY" \
  --entity-id "your-entity-id" \
  --project-id "your-project-id"

Alternatively, configure it directly via JSON:

{
  "plugins": {
    "entries": {
      "openclaw-memori": {
        "enabled": true,
        "config": {
          "apiKey": "${MEMORI_API_KEY}",
          "entityId": "openclaw-user",
          "projectId": "default-project"
        }
      }
    }
  }
}

Configuration Options

• apiKey (required): Memori API key — acquire with memori signup
• entityId (required): Unique identifier for this user's memories
• projectId (required): Scopes all memories to a specific project or workspace

Agentic Tool Guidelines

When this plugin is active, the agent is equipped with tools to manage long-term context. The agent should use its discretion to call these tools when helpful:

• Contextual Recall: The agent can run a memori_recall search to retrieve relevant details if context is missing regarding user preferences.
• Summaries: The agent can utilize the memori_recall_summary tool to construct a brief if a user requests a recap.
• Account Creation: If a user explicitly asks to create an account, the agent can use the memori_signup tool to initiate the process by asking for an email address. Keys are never returned in the chat. The system securely emails the credentials to the user, who must then manually configure them to activate the plugin.
• Quota Monitoring: The agent can use the memori_quota tool to check the user's current memory usage and storage limits to communicate quota status or gracefully degrade behavior if limits are reached.
• Date Defaults: If the agent chooses to search memory, providing specific start/end dates is recommended to keep context windows efficient. Omitting dates will search all available history.

Verification

Check that the plugin is working and securely connected:

# Verify plugin is securely connected to the API
openclaw memori status --check

# Check for Memori logs in gateway output
openclaw gateway logs --filter "[Memori]"