Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

README.md

agentmemory

OpenClaw  agentmemory for OpenClaw

Your OpenClaw agents remember everything. No more re-explaining.
Persistent cross-session memory via agentmemory — 95.2% retrieval accuracy on LongMemEval-S.

43 MCP tools OpenClaw memory plugin 95.2% R@5 Self-hosted Apache 2.0


Install it in 30 seconds

Paste this prompt into OpenClaw and it does the whole setup for you:

Install agentmemory for OpenClaw. Run `npx @agentmemory/agentmemory` in a separate terminal to start the memory server on localhost:3111.

For zero-code setup, add this MCP server so OpenClaw gets all 43 memory tools:

{
  "mcpServers": {
    "agentmemory": {
      "command": "npx",
      "args": ["-y", "@agentmemory/mcp"]
    }
  }
}

For deeper memory integration, copy `integrations/openclaw` from the agentmemory repo to `~/.openclaw/extensions/agentmemory`, then enable it in `~/.openclaw/openclaw.json`:

{
  "plugins": {
    "slots": {
      "memory": "agentmemory"
    },
    "entries": {
      "agentmemory": {
        "enabled": true,
        "config": {
          "base_url": "http://localhost:3111",
          "token_budget": 2000,
          "min_confidence": 0.5,
          "fallback_on_error": true,
          "timeout_ms": 5000
        }
      }
    }
  }
}

Restart OpenClaw. Verify with `curl http://localhost:3111/agentmemory/health`. Open http://localhost:3113 for the real-time viewer.

That's it. OpenClaw handles the rest.

Option 1: MCP server (zero code)

Start the agentmemory server in a separate terminal:

npx @agentmemory/agentmemory

Then add to your OpenClaw MCP config:

{
  "mcpServers": {
    "agentmemory": {
      "command": "npx",
      "args": ["-y", "@agentmemory/mcp"]
    }
  }
}

OpenClaw now has access to all 43 MCP tools including memory_recall, memory_save, memory_smart_search, memory_timeline, memory_profile, and more.

Option 2: OpenClaw memory plugin (deeper integration)

Copy this folder into OpenClaw's extension directory:

mkdir -p ~/.openclaw/extensions
cp -r integrations/openclaw ~/.openclaw/extensions/agentmemory

Then enable it in ~/.openclaw/openclaw.json:

{
  "plugins": {
    "slots": {
      "memory": "agentmemory"
    },
    "entries": {
      "agentmemory": {
        "enabled": true,
        "config": {
          "base_url": "http://localhost:3111",
          "token_budget": 2000,
          "min_confidence": 0.5,
          "fallback_on_error": true,
          "timeout_ms": 5000
        }
      }
    }
  }
}

What the plugin does:

  • recalls relevant long-term memory before the agent starts
  • captures completed conversation turns after the agent finishes
  • shares the same backend with Claude Code, Codex CLI, Gemini CLI, Hermes, pi, and other agents

Troubleshooting

Plugin validates but does not load — make sure the folder contains package.json, openclaw.plugin.json, and plugin.mjs, and that plugins.slots.memory is set to agentmemory.

Connection refused on port 3111 — the agentmemory server is not running. Start it with npx @agentmemory/agentmemory.

No memories returned — open http://localhost:3113 and verify observations are being captured.

See also

License

Apache-2.0 (same as agentmemory)