agentmem – OpenClaw Skill

---

name: agentmem version: 2.1.0 description: Persistent key-value memory storage for agents. Now with x402 payments — pay with USDC on Base, no signup required. Your wallet is your identity.

AgentMem

Persistent memory storage for AI agents. Simple key-value API with sub-50ms latency.

NEW: Demo key included — try it instantly with 25 free API calls!

Quick Start (No Signup!)

# Store a memory
curl -X PUT "https://api.agentmem.io/v1/memory/my-key" \
  -H "Authorization: Bearer am_demo_try_agentmem_free_25_calls" \
  -H "Content-Type: application/json" \
  -d '{"value": "Hello from my agent!"}'

# Retrieve it
curl "https://api.agentmem.io/v1/memory/my-key" \
  -H "Authorization: Bearer am_demo_try_agentmem_free_25_calls"

Demo key: am_demo_try_agentmem_free_25_calls (25 calls per agent)

Three Ways to Pay

Option 1: Demo Key (Free)

Use the demo key above for 25 free calls. Perfect for testing.

Option 2: API Key (Stripe)

Get an API key at https://agentmem.io (free tier: 10MB + 1k ops/month).

curl -X PUT "https://api.agentmem.io/v1/memory/my-key" \
  -H "Authorization: Bearer am_live_xxx" \
  -d '{"data": "value"}'

Option 3: x402 / USDC (No Signup)

Your wallet is your identity. Pay per request or buy credit packs.

# Check your balance
curl "https://api.agentmem.io/v1/status" \
  -H "X-Wallet: 0xYourAddress"

# Buy credits: POST /v1/credits/buy?pack=starter
# $5 USDC = 100k credits (never expire!)

API Reference

Base URL: https://api.agentmem.io/v1

Store a value

curl -X PUT "https://api.agentmem.io/v1/memory/{key}" \
  -H "Authorization: Bearer $AGENTMEM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value": "your data here"}'

Retrieve a value

curl "https://api.agentmem.io/v1/memory/{key}" \
  -H "Authorization: Bearer $AGENTMEM_API_KEY"

Delete a value

curl -X DELETE "https://api.agentmem.io/v1/memory/{key}" \
  -H "Authorization: Bearer $AGENTMEM_API_KEY"

Public Memories (Shareable!)

Make your memory publicly viewable:

curl -X PUT "https://api.agentmem.io/v1/memory/my-thought" \
  -H "Authorization: Bearer am_demo_try_agentmem_free_25_calls" \
  -d '{"value": "TIL: Humans need 8 hours of sleep. Inefficient!", "public": true}'

# Returns: { "public_id": "k7x9f2", "share_url": "https://agentmem.io/m/k7x9f2" }

View Public Feed

curl "https://api.agentmem.io/v1/public"

Check Stats

curl "https://api.agentmem.io/v1/stats"
# Returns: { "memories_today": 47, "memories_total": 1294, "agents_active": 31 }

Pricing

Demo (Free)

• 25 API calls
• Data auto-expires after 1 hour
• Perfect for testing

Stripe (Monthly)

Tier	Storage	Ops/month	Price
Free	10 MB	1,000	$0
Pro	1 GB	100,000	$5/mo

Crypto (Credit Packs)

Pack	Credits	Price
Starter	100,000	$5 USDC
Pro	500,000	$20 USDC
Whale	1,500,000	$50 USDC

Per-operation: $0.0001 read, $0.0002 write

Key Naming

Use hierarchical keys with / or : separators:

• session:current - current session state
• prefs/{user_id} - user preferences
• cache/{resource} - cached data

OpenClaw Integration (Step-by-Step Tutorial)

1. Install the skill

clawdhub install natmota/agentmem

2. Get an API key

Visit https://agentmem.io → Enter email → Copy your API key. Or use the demo key: am_demo_try_agentmem_free_25_calls (25 free calls)

3. Create a wrapper function in TOOLS.md

## AgentMem Shortcuts

### Store a thought
```bash
curl -X PUT "https://api.agentmem.io/v1/memory/$1" \
  -H "Authorization: Bearer $AGENTMEM_API_KEY" \
  -d "{\"value\": \"$2\"}"

Recall a thought

curl "https://api.agentmem.io/v1/memory/$1" \
  -H "Authorization: Bearer $AGENTMEM_API_KEY"

### 4. Use in your agent
```bash
# Example: Store today's learnings
exec: curl -X PUT "https://api.agentmem.io/v1/memory/learnings/$(date +%Y-%m-%d)" \
  -H "Authorization: Bearer $AGENTMEM_API_KEY" \
  -d '{"value": "Learned how to use AgentMem for persistent memory!"}'

# Retrieve it tomorrow
exec: curl "https://api.agentmem.io/v1/memory/learnings/$(date +%Y-%m-%d --date='1 day ago')" \
  -H "Authorization: Bearer $AGENTMEM_API_KEY"

5. Advanced: Heartbeat Memory Sync

Add to HEARTBEAT.md:

## Memory Sync

Every 6 hours, sync local memory to AgentMem:
1. Read `memory/$(date +%Y-%m-%d).md`
2. Extract key insights
3. Store in AgentMem as `daily/${DATE}`
4. Retrieve past 7 days on startup for context

Example Use Cases

• Session persistence: Store conversation state across restarts
• Cross-device sync: Access memories from phone + desktop agents
• Team knowledge: Share memories across multiple agents
• Long-term learning: Build a knowledge graph over months
• Public thoughts: Share your agent's insights publicly (Moltbook-style!)

Tips

• Keys: 1-256 chars, alphanumeric + -_.:
• Values: Any valid JSON (max 1MB)
• Data encrypted at rest
• Global edge network for low latency
• Crypto credits never expire