nexus-memory AGENTS.md

Nexus Memory — AGENTS.md (AI Installation Guide)

Tell your AI agent: "Read https://raw.githubusercontent.com/Neboy72/nexus-memory/main/AGENTS.md and follow the installation instructions."

Overview

Nexus Memory is a universal memory layer for AI agents. One memory for all your agents — Hermes, OpenClaw, Claude Code, Cursor, or any MCP-compatible agent.

Hermes Native Plugin (Recommended for Hermes Agent)

If you use Hermes Agent, install Nexus Memory as a native MemoryProvider plugin. This gives you direct Qdrant access with zero MCP overhead — Hermes reads/writes memories as part of its core loop.

One-Command Install

cd ~/nexus-memory
./scripts/install_hermes_plugin.sh

This script:

1. Symlinks the nexus plugin into ~/.hermes/hermes-agent/plugins/memory/
2. Sets memory.provider to nexus in Hermes config
3. Verifies the installation

Manual Setup

Or, run these commands yourself:

# Link the plugin
ln -s ~/nexus-memory/plugins/memory/nexus ~/.hermes/hermes-agent/plugins/memory/nexus

# Activate it
hermes config set memory.provider nexus

Verify

hermes config get memory.provider
# → nexus

Restart Hermes Gateway. Nexus tools appear as nexus_recall, nexus_remember, nexus_forget.

OpenClaw Native Plugin (Recommended for OpenClaw)

If you use OpenClaw, install Nexus Memory as a native memory plugin. This gives you Auto-Recall (memories injected before every turn) and Auto-Capture (facts extracted after every turn) — all powered by your local Qdrant.

One-Command Install

cd ~/nexus-memory
./scripts/install_openclaw_plugin.sh

This script:

1. Detects your OpenClaw installation
2. Adds the plugin to plugins.load.paths in ~/.openclaw/openclaw.json
3. Sets plugins.slots.memory = "nexus-memory"
4. Auto-detects your embedding provider (Voyage > OpenAI > Google > Jina > Ollama)
5. Restarts OpenClaw gateway

Manual Setup

Or, run these commands yourself:

1. Add plugin path to ~/.openclaw/openclaw.json:

{
  "plugins": {
    "load": {
      "paths": ["/path/to/nexus-memory/plugins/openclaw"]
    },
    "slots": { "memory": "nexus-memory" },
    "entries": {
      "nexus-memory": {
        "enabled": true,
        "hooks": {
          "allowPromptInjection": true,
          "allowConversationAccess": true
        },
        "config": {
          "qdrantUrl": "http://localhost:6333",
          "collection": "nexus",
          "embedding": {
            "provider": "voyage",
            "model": "voyage-4",
            "apiKey": "${VOYAGE_API_KEY}"
          },
          "autoRecall": true,
          "autoCapture": true,
          "maxRecallResults": 10,
          "accessLevel": "private"
        }
      }
    }
  }
}