feat: add OpenClaw plugin and documentation by deshraj · Pull Request #3964 · mem0ai/mem0

deshraj · 2026-02-02T17:51:00Z

Summary

Adds the @mem0/openclaw-mem0 plugin that provides long-term memory for OpenClaw agents
Auto-recall injects relevant memories before agent responses
Auto-capture stores important facts after each turn
Supports both Mem0 Cloud (platform) and self-hosted (open-source) modes
Includes 5 agent tools (memory_search, memory_list, memory_store, memory_get, memory_forget)
Adds integration documentation to the docs site under Integrations > Agent Frameworks

Add the @mem0/openclaw-mem0 plugin that provides long-term memory for OpenClaw agents: - Auto-recall injects relevant memories before agent responses - Auto-capture stores important facts after each turn - Supports both Mem0 Cloud (platform) and self-hosted (open-source) modes - Includes 5 agent tools for explicit memory operations Also adds integration documentation to the docs site. Co-authored-by: Cursor <cursoragent@cursor.com>

whysosaket · 2026-02-02T17:53:28Z

openclaw/index.ts

+// ============================================================================
+// Types
+// ============================================================================
+


interfaces and types can go into a types.ts for better modularity and readibility

whysosaket · 2026-02-02T17:54:03Z

openclaw/index.ts

+  page_size?: number;
+}
+
+interface MemoryItem {


memory item can also contain run_id

whysosaket · 2026-02-02T17:54:36Z

openclaw/index.ts

+}
+
+interface SearchOptions {
+  user_id: string;


entities can be extracted in a single type and then extended in this type

whysosaket · 2026-02-02T17:54:46Z

openclaw/index.ts

+}
+
+interface ListOptions {
+  user_id: string;


Same as above

whysosaket · 2026-02-02T17:55:42Z

openclaw/index.ts

+  private async _init(): Promise<void> {
+    const { default: MemoryClient } = await import("mem0ai");
+    const opts: Record<string, string> = { apiKey: this.apiKey };
+    if (this.orgId) opts.org_id = this.orgId;


This is kind off redundant

whysosaket · 2026-02-02T17:56:54Z

openclaw/index.ts

+    if (options.enable_graph) opts.enable_graph = options.enable_graph;
+    if (options.output_format) opts.output_format = options.output_format;
+
+    const result = await this.client.add(messages, opts);


This can be done async to unblock the execution

Event loop will handle this

whysosaket · 2026-02-02T17:57:54Z

openclaw/index.ts

+// Default Custom Instructions & Categories
+// ============================================================================
+
+const DEFAULT_CUSTOM_INSTRUCTIONS = `Your Task: Extract and maintain a structured, evolving profile of the user from their conversations with an AI assistant. Capture information that would help the assistant provide personalized, context-aware responses in future interactions.


Prompts can go into a separate prompts file

whysosaket · 2026-02-02T17:58:17Z

openclaw/index.ts

+- Raw code snippets (capture the intent/decision, not the code itself)
+- Information the user explicitly asks not to remember`;
+
+const DEFAULT_CUSTOM_CATEGORIES: Record<string, string> = {


This can also go into a constants file

whysosaket · 2026-02-02T17:58:26Z

openclaw/index.ts

+// ============================================================================
+// Config Schema
+// ============================================================================
+


Same as above

whysosaket · 2026-02-02T17:59:07Z

openclaw/index.ts

+    );
+  }
+
+  return new PlatformProvider(cfg.apiKey!, cfg.orgId, cfg.projectId);


Again sending org id and project id is redundant

whysosaket · 2026-02-02T17:59:23Z

openclaw/index.ts

+// ============================================================================
+// Provider Factory
+// ============================================================================
+


This can go into a factory.ts

whysosaket · 2026-02-02T17:59:48Z

openclaw/index.ts

+    // Tools
+    // ========================================================================
+
+    api.registerTool(


a tools.ts would have been better suited here

deshraj · 2026-02-02T18:02:08Z

Thanks Saket. Will incorporate these in the follow up PR. Right now, trying to meet the deadline.

whysosaket · 2026-02-02T18:03:08Z

Thanks Saket. Will incorporate these in the follow up PR. Right now, trying to meet the deadline.

Sounds good! Approved

Zlo7 · 2026-02-12T15:17:50Z

@deshraj thanks for the OpenClaw plugin! I discovered an issue with the auto-recall feature and wanted to bring it to your attention.

Issue: Auto-recall silently fails due to property name mismatch

Problem: Hook returns { systemContext: ... } but OpenClaw expects { prependContext: ... }
Result: Memories are fetched but never injected into prompts
Fix: One-line property rename

I've submitted:

Issue: OpenClaw plugin auto-recall memory injection silently broken due to incorrect property name #4037
PR: OpenClaw plugin: Fix broken auto-recall memory injection #4038

The fix is minimal and maintains all your original functionality. Would appreciate your review when you have a moment! I realize this is a pretty large repo so it isn't critical for mem0 overall, but I believe it's critical for the OpenClaw plugin.

mintlify bot deployed to staging - docs February 2, 2026 17:51 View deployment

whysosaket reviewed Feb 2, 2026

View reviewed changes

openclaw/index.ts

page_size?: number;

}

interface MemoryItem {

Copy link
Copy Markdown

Member

whysosaket Feb 2, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

memory item can also contain run_id

whysosaket reviewed Feb 2, 2026

View reviewed changes

openclaw/index.ts

}

interface ListOptions {

user_id: string;

Copy link
Copy Markdown

Member

whysosaket Feb 2, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same as above

whysosaket reviewed Feb 2, 2026

View reviewed changes

whysosaket approved these changes Feb 2, 2026

View reviewed changes

deshraj merged commit 3d3e875 into main Feb 2, 2026
4 checks passed

deshraj deleted the user/dyadav/add-openclaw branch February 2, 2026 18:04

garciaba79 pushed a commit to garciaba79/mem0 that referenced this pull request Feb 12, 2026

Feature: Add OpenClaw plugin and documentation (mem0ai#3964)

d388ad9

jamebobob pushed a commit to jamebobob/mem0-vigil-recall that referenced this pull request Mar 29, 2026

Feature: Add OpenClaw plugin and documentation (mem0ai#3964)

c2d9df6

Conversation

deshraj commented Feb 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

deshraj commented Feb 2, 2026

Uh oh!

whysosaket commented Feb 2, 2026

Uh oh!

Uh oh!

Zlo7 commented Feb 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

deshraj commented Feb 2, 2026 •

edited

Loading