MemClawz Connect

> One skill. Any agent. Shared memory.

Setup

export MEMCLAWZ_URL="http://localhost:3500"   # or remote: http://YOUR_SERVER:3500
export MEMCLAWZ_AGENT_ID="my-agent"           # unique per agent

No API key required for default installs. If auth is enabled, also set MEMCLAWZ_API_KEY.

Health Check

curl -s "$MEMCLAWZ_URL/health"
# {"status":"ok","version":"...","qdrant":"connected"}

Agent Protocol

Before ANY Task — Search First

curl -s "$MEMCLAWZ_URL/api/v1/search?q=TOPIC&limit=5"

Response:

{"results": [{"content": "...", "agent_id": "quant-dev", "memory_type": "decision", "score": 0.92}]}

Use results as context before starting work. Avoids re-discovering what's already known.

After Completing Work — Write Back

curl -s -X POST "$MEMCLAWZ_URL/api/v1/add" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Deployed v2.0 — fixed auth race condition with mutex on refresh",
    "agent_id": "'"$MEMCLAWZ_AGENT_ID"'",
    "memory_type": "event"
  }'

Memory Types

Stats

curl -s "$MEMCLAWZ_URL/api/v1/stats"

List Agents

curl -s "$MEMCLAWZ_URL/api/v1/agents"

Get Memories

curl -s "$MEMCLAWZ_URL/api/v1/memories?agent_id=$MEMCLAWZ_AGENT_ID&limit=50"

AGENTS.md Integration

Append to your agent's AGENTS.md:

## MemClawz Shared Memory

Fleet memory API: $MEMCLAWZ_URL/api/v1

### Before ANY task:
Search shared memory for relevant context:
curl -s "$MEMCLAWZ_URL/api/v1/search?q=<task keywords>&limit=5"

### After completing ANY significant work:
Write results to shared memory:
curl -s -X POST $MEMCLAWZ_URL/api/v1/add \
  -H "Content-Type: application/json" \
  -d '{"content": "<what was done>", "agent_id": "$MEMCLAWZ_AGENT_ID", "memory_type": "<type>"}'

Remote Agents

For agents on a different server, just change MEMCLAWZ_URL from localhost:3500 to the master's IP/hostname:

export MEMCLAWZ_URL="http://76.13.154.71:3500"

Everything else stays the same.