mnemos-setup

mnemos Setup

Persistent memory for AI agents. This skill helps you set up mnemos with any agent platform.

Prerequisites

You need a running mnemo-server instance. See the server README for deployment instructions.

Step 1: Deploy mnemo-server

cd mnemos/server
MNEMO_DSN="user:pass@tcp(host:4000)/mnemos?parseTime=true" go run ./cmd/mnemo-server

Step 2: Provision a tenant

curl -s -X POST http://localhost:8080/v1alpha1/mem9s | jq .
# → { "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "claim_url": "..." }

Save the returned id — this is your tenant ID used in all subsequent API calls.

Step 3: Configure your agent platform

Pick your platform and follow the instructions:

OpenClaw

Add to openclaw.json:

{
  "plugins": {
    "slots": { "memory": "mnemo" },
    "entries": {
      "mnemo": {
        "enabled": true,
        "config": {
          "apiUrl": "http://localhost:8080",
          "tenantID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        }
      }
    }
  }
}

Restart OpenClaw. You should see:

[mnemo] Server mode (tenant-scoped mem9 API)

OpenCode

Set environment variables (add to shell profile or .env):

export MNEMO_API_URL="http://localhost:8080"
export MNEMO_TENANT_ID="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Add to opencode.json:

{
  "plugin": ["mnemo-opencode"]
}

Restart OpenCode. You should see:

[mnemo] Server mode (mnemo-server REST API)

Claude Code

Add to ~/.claude/settings.json:

{
  "env": {
    "MNEMO_API_URL": "http://localhost:8080",
    "MNEMO_TENANT_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}

Install plugin:

/plugin marketplace add qiffang/mnemos
/plugin install mnemo-memory@mnemos

Restart Claude Code.

Verification

After setup, test memory:

1. Ask your agent: "Remember that the project uses PostgreSQL 15"
2. Start a new session
3. Ask: "What database does this project use?"

The agent should recall the information from memory.

Troubleshooting