memoclaw-hooks
v1.0.0
Published
OpenClaw hook pack for MemoClaw — persistent cloud memory across sessions, agents, and devices
Maintainers
Readme
memoclaw-hooks 🧠
OpenClaw hook pack for MemoClaw — persistent cloud memory for AI agents.
Your agent remembers across sessions, devices, and reboots. No local files to manage, no filesystem to maintain. Just memory that works.
Why
Every time your OpenClaw agent starts a new session, it forgets everything. Local files help, but they're fragile — they don't survive machine changes, they can't be shared across agents, and grep doesn't do semantic search.
MemoClaw stores memories in the cloud with vector embeddings. This hook pack wires it into OpenClaw's lifecycle so it happens automatically.
What It Does
| Event | Action | |-------|--------| | Session start | Recalls relevant memories for the user's first message | | /new command | Extracts and stores important context before session reset | | Context compaction | Saves key information before the context window is compressed | | Heartbeat | Periodic consolidation to merge duplicate memories | | Gateway startup | Recalls recent memories for agent continuity |
Install
# 1. Install the MemoClaw CLI
npm install -g memoclaw
# 2. Set your wallet key (this is your identity — no registration needed)
export MEMOCLAW_PRIVATE_KEY=0x...
# 3. Install and enable the hook pack
openclaw hooks install memoclaw-hooks
openclaw hooks enable memoclaw
# 4. Restart gateway
openclaw gateway restartVerify:
openclaw hooks list --verbose
openclaw hooks checkConfiguration
All via environment variables:
| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| MEMOCLAW_PRIVATE_KEY | Yes | — | Wallet private key for auth |
| MEMOCLAW_URL | No | https://api.memoclaw.com | API endpoint |
| MEMOCLAW_NAMESPACE | No | default | Isolate memories per agent |
Multi-Agent Memory
Same wallet, different namespaces = isolated memory per agent. Same wallet, same namespace = shared memory across agents.
# In agent A's environment
MEMOCLAW_NAMESPACE=agent-a
# In agent B's environment
MEMOCLAW_NAMESPACE=agent-b
# Shared knowledge base
MEMOCLAW_NAMESPACE=sharedPricing
- 100 free calls per wallet. No credit card, no signup.
- After that: $0.005–$0.01 per call via x402 micropayments (USDC on Base)
- The hook uses ~2-4 API calls per session lifecycle
How It Compares to Local Memory
| | MemoClaw | Local files | |---|---|---| | Survives machine changes | ✅ | ❌ | | Semantic search | ✅ | ❌ (keyword only) | | Multi-agent sharing | ✅ | ❌ | | Auto-deduplication | ✅ | ❌ | | Zero filesystem management | ✅ | ❌ | | Works offline | ❌ | ✅ | | Free forever | 100 calls | ✅ |
License
MIT
