name: mnemos-setup description: | Setup mnemos persistent memory with mnemo-server. Triggers: "set up mnemos", "install mnemo plugin", "configure memory plugin", "configure openclaw memory", "configure opencode memory", "configure claude code memory".

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