mengram-memory

name	mengram-memory
description	Long-term memory with 3 types (facts, events, workflows). Remember user preferences, past conversations, and learned procedures across sessions. Use when recalling what the user said before, saving important info, getting user context, or tracking completed workflows.
homepage	https://github.com/alibaizhanov/mengram
metadata	{"openclaw":{"emoji":"🧠","requires":{"env":["MENGRAM_API_KEY"],"bins":["curl","python3"]},"primaryEnv":"MENGRAM_API_KEY","files":["scripts/*"]}}

Mengram Memory

Human-like long-term memory for your OpenClaw agent. Remembers facts, events, and workflows across all sessions and channels.

What This Skill Does

Mengram gives you 3 types of memory that work together:

• Semantic Memory — facts about the user (preferences, relationships, work, habits)
• Episodic Memory — events with timestamps and outcomes (meetings, trips, decisions)
• Procedural Memory — learned workflows with success/failure tracking (how-to steps)

All memory persists across sessions and channels. What you learn on WhatsApp is available on Discord.

Tools

This skill uses Bash to run scripts in {baseDir}/scripts/.

When To Use

ALWAYS search memory before answering questions about the user, their preferences, their history, or anything personal. This is critical — check memory first, then respond.

Save to memory after:

• The user shares personal information (name, preferences, habits, relationships)
• A task or event is completed (booking, deployment, purchase)
• A multi-step workflow is finished successfully or fails
• The user corrects you or provides new context

Get profile when:

• Starting a new session or conversation
• The user asks "what do you know about me"
• You need comprehensive context about the user

Scripts

1. Search Memory

Search all 3 memory types for relevant context. Do this before answering personal questions.

bash {baseDir}/scripts/mengram-search.sh "search query here"

Returns facts, past events, and known workflows matching the query. Use specific queries — "coffee preferences" not "stuff about user".

2. Save to Memory

Save conversation messages so Mengram can extract facts, events, and procedures automatically.

bash {baseDir}/scripts/mengram-add.sh "user said: I'm allergic to peanuts and my meeting with Sarah went well yesterday"

You can pass multiple messages. Mengram's AI automatically extracts:

• Facts → semantic memory ("user is allergic to peanuts")
• Events → episodic memory ("meeting with Sarah, yesterday, went well")
• Procedures → procedural memory (if workflow steps are described)

3. Get Cognitive Profile

Get a comprehensive portrait of the user — who they are, what they know, recent events, known workflows.

bash {baseDir}/scripts/mengram-profile.sh

Returns a full context block you can use to personalize responses.

4. Save Workflow

After completing a multi-step task, save it as a reusable procedure with success/failure tracking.

bash {baseDir}/scripts/mengram-workflow.sh "Resolved billing issue: 1) Checked subscription status 2) Found expired card 3) Sent renewal link 4) User confirmed payment"

Next time a similar task comes up, mengram-search.sh will return this workflow with its success rate.

5. Setup Check

Verify the Mengram connection is working:

bash {baseDir}/scripts/mengram-setup.sh

Recommended Behavior

1. Start of session: Run mengram-profile.sh to load user context
2. User asks something personal: Run mengram-search.sh "topic" before answering
3. User shares new info: Run mengram-add.sh with the relevant messages
4. After completing a task: Run mengram-workflow.sh with the steps taken
5. Periodically: Run mengram-add.sh with recent conversation highlights to keep memory updated

Examples

• "What's my favorite restaurant?" → mengram-search.sh "favorite restaurant"
• "Book the usual" → mengram-search.sh "booking usual preferences" to find what "the usual" means
• "I just switched to a new phone, Galaxy S26" → mengram-add.sh "user switched to Samsung Galaxy S26"
• "Remember that I'm vegetarian" → mengram-add.sh "user is vegetarian"
• User asks "what do you know about me?" → mengram-profile.sh

Configuration

Set in ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "mengram-memory": {
        "enabled": true,
        "env": {
          "MENGRAM_API_KEY": "om-your-api-key-here"
        }
      }
    }
  }
}

Get your free API key at https://mengram.io

Security & Privacy

• External endpoint: https://mengram.io/v1/* (only)
• Data sent: conversation text for memory extraction, search queries
• Data stored: extracted facts, events, and procedures on Mengram servers (PostgreSQL + pgvector)
• Environment variables accessed: MENGRAM_API_KEY (only)
• Local files read/written: none

Trust Statement: By using this skill, conversation data is sent to mengram.io for memory extraction and storage. Only install if you trust Mengram with your conversation data. Mengram is open-source: https://github.com/alibaizhanov/mengram