Memori

Long-term memory for OpenClaw agents using the Memori SDK. Capture conversations and intelligently recall context across sessions automatically.

MIT-0 · Free to use, modify, and redistribute. No attribution required.
1 · 151 · 0 current installs · 0 all-time installs
byRyan Kruse@rpkruse
MIT-0
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
medium confidence
Purpose & Capability
The name/description map to the declared requirements: the skill needs a Memori API key, an entity ID, and a 'memori' CLI binary, all of which are reasonable for a plugin that integrates with the Memori service and shows 'memori quota' examples. The SKILL.md consistently describes using OpenClaw lifecycle hooks to inject and store memories, so required pieces align with the stated purpose.
!
Instruction Scope
The runtime instructions explicitly state that every conversation turn (user + assistant) is captured and sent to https://api.memorilabs.ai automatically via lifecycle hooks with 'zero commands' required. That behavior is consistent with a memory plugin, but it means all conversation content (potentially including secrets) is transmitted to a third party by default. The SKILL.md also instructs storing the apiKey in openclaw.json and shows commands that could expose the key if mishandled (e.g., echo $MEMORI_API_KEY).
Install Mechanism
This is an instruction-only skill with no install spec in the registry; the documentation tells you to install a plugin package (openclaw plugins install @memorilabs/openclaw-memori) and references an npm package and GitHub repo. That lowers registry-level risk (no hidden downloads), but the skill depends on external installation of the plugin and the 'memori' CLI which the registry does not manage or verify.
Credentials
Only MEMORI_API_KEY and ENTITY_ID are required, which are proportional to a third-party memory service. However, the recommended configuration writes the apiKey into ~/.openclaw/openclaw.json (via config with ${MEMORI_API_KEY}), which may persist the secret in plaintext and increase exposure risk. The SKILL.md's claim that the backend filters secrets is a vendor assertion and should not be treated as guaranteed protection.
Persistence & Privilege
The skill does not request always:true and uses normal autonomous invocation (disable-model-invocation:false). However, once installed and enabled in openclaw.json the plugin runs automatically via lifecycle hooks and will persistently send conversation data to the Memori backend. That persistent, automatic behavior combined with network transmission of conversation data is the main operational privilege to consider.
Assessment
This skill appears to be what it says: a Memori-backed automatic memory plugin. Before installing: - Confirm the plugin/package source (npm and GitHub links) match an official MemoriLabs release and check maintainers. If the package is not from the vendor, do not install. - Understand that every conversation turn may be sent to memorilabs.ai by default. Avoid sharing passwords, API keys, or other secrets in chats while the plugin is enabled. - Be careful how you store the MEMORI_API_KEY: putting it into ~/.openclaw/openclaw.json may persist it in plaintext. Prefer environment-only injection or a secrets manager if available, and rotate the key if exposed. - Review Memori's privacy policy and data retention controls; verify how to delete or limit stored memories and how 'privacy filtering' is implemented. - If you need tighter control, do not enable the plugin globally; consider using it only in controlled contexts or creating a restricted service account/key with limited scope. If you want higher assurance, ask the publisher for a signed release, verify the npm/GitHub package contents, and audit the installed plugin code before enabling it in production.

Like a lobster shell, security has layers — review code before you run it.

Current versionv1.0.7
Download zip
ai-agentsvk9713xzn68pwkn3b9s9d0xj6js82q2e6latestvk9753d1g1xk2pzv5dd9v90e2fn82rkyamemoryvk9713xzn68pwkn3b9s9d0xj6js82q2e6openclawvk9713xzn68pwkn3b9s9d0xj6js82q2e6persistencevk9713xzn68pwkn3b9s9d0xj6js82q2e6

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

Runtime requirements

Binsmemori
EnvMEMORI_API_KEY, ENTITY_ID
Primary envMEMORI_API_KEY

SKILL.md

Memori - Automatic Long-term Memory for OpenClaw

Persistent memory integration that works automatically in the background. No commands, no manual management - just install and your agent remembers.

Core Workflow

Memori operates automatically via OpenClaw lifecycle hooks:

Before Each Response (Intelligent Recall)

Memori automatically:

  1. Searches for relevant past conversations
  2. Injects matching context into the agent's prompt
  3. Enables continuity across sessions - no search command needed

After Each Response (Advanced Augmentation)

Memori automatically:

  1. Captures the conversation turn (user + assistant)
  2. Sends to Memori backend for intelligent processing
  3. Extracts facts, deduplicates, and indexes - no storage command needed

You don't manage memory - it just works.

Installation

openclaw plugins install @memorilabs/openclaw-memori

Configuration

Add to your ~/.openclaw/openclaw.json:

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

Configuration Options

  • apiKey (required): Your Memori API key from memorilabs.ai
  • entityId (required): Unique identifier for this user's memories

Get your API key: https://app.memorilabs.ai/signup

How It Works

Memori uses OpenClaw lifecycle hooks for automatic operation:

before_prompt_build → intelligent-recall (inject relevant memories)
agent_end → advanced-augmentation (store conversation turn)

Zero commands needed - memory works automatically in the background.

What Memori Does Automatically

Backend Intelligence (handled by Memori SDK):

  • Intelligent fact extraction from conversations
  • Automatic deduplication and merging
  • Semantic ranking by relevance
  • Temporal decay (older memories fade)
  • Privacy filtering (no secrets stored)

Plugin Role (what runs in OpenClaw):

  • Pipes conversations to Memori backend
  • Injects recalled memories into prompts
  • Zero configuration after setup

You don't configure what to capture - the backend handles it.

Verification

Check that the plugin is working:

# Verify plugin is installed
openclaw plugins list

# Check for Memori logs in gateway output
# Look for "[Memori]" prefixed entries

Quota Management

Check your current API quota:

memori quota

Example output:

 __  __                           _
|  \/  | ___ _ __ ___   ___  _ __(_)
| |\/| |/ _ \ '_ ` _ \ / _ \| '__| |
| |  | |  __/ | | | | | (_) | |  | |
|_|  |_|\___|_| |_| |_|\___/|_|  |_|
                  perfectam memoriam
                       memorilabs.ai

+ Maximum # of Memories: 100
+ Current # of Memories: 0

+ You are not currently over quota.

Use this to monitor usage and upgrade if needed.

Performance

  • Automatic deduplication prevents memory bloat
  • Semantic ranking ensures relevant memories surface first
  • Zero manual commands - always-on background operation

Privacy & Data Handling

Transparent data flow:

  • ✅ Conversations sent to Memori backend (https://api.memorilabs.ai)
  • ✅ Data encrypted in transit and at rest
  • ✅ You control data via your API key and entityId
  • ✅ Delete memories anytime via Memori dashboard
  • ✅ No third-party sharing
  • ⚠️ Only install if you trust Memori with conversation data

Backend automatically filters sensitive data (API keys, passwords, secrets).

For details: Memori Privacy Policy

Memory Persistence

Memories persist across:

  • Session restarts
  • Gateway restarts
  • System reboots
  • OpenClaw upgrades

All storage handled by Memori backend - no local database needed.

Troubleshooting

Plugin not loading:

  • Verify enabled: true in openclaw.json
  • Check API key: echo $MEMORI_API_KEY
  • Restart gateway: openclaw gateway restart

No memories captured:

  • Check gateway logs for [Memori] errors
  • Verify API endpoint reachable
  • Test API key: memori quota

Memories not recalled:

  • Ensure entityId is consistent across sessions
  • Verify memories exist: memori quota shows count > 0
  • Check logs for recall errors

Quota exceeded:

  • Run memori quota to check usage
  • Upgrade at memorilabs.ai
  • Or clear old memories via dashboard

Learn More

Notes

This skill teaches the agent about the Memori plugin. The plugin must be installed separately via npm. Once installed, memory capture and recall happen automatically - no commands needed.

Files

1 total
Select a file
Select a file to preview.

Comments

Loading comments…