- name
- memclawz-connect
- description
- Connect any AI agent to the MemClawz shared memory bus. Gives agents read-before-act and write-after-complete patterns via a simple HTTP API. Use when an agent needs fleet memory, shared memory, cross-agent memory, or long-term recall across sessions. Triggers on: 'connect to memory', 'fleet memory', 'shared memory', 'memclawz', 'remember this across sessions', 'search memory'.
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 agentNo 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
| Type | When |
|---|---|
fact | Discovered info (endpoints, versions, configs) |
decision | Choices made (architecture, approach, tool selection) |
procedure | How something was done (deploy steps, build process) |
event | What happened (deployed X, fixed Y, shipped Z) |
insight | Lessons learned (what worked, what didn't) |
intention | Planned actions |
commitment | Promises made |
action | Actions taken |
outcome | Results of actions |
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.