Migrate from Zep

Switch from Zep to MemoClaw — simpler auth, pay-per-request pricing.

Zep provides memory and knowledge graphs for AI assistants. MemoClaw offers similar capabilities with wallet-based identity — no API keys to manage.

Key Differences

Feature	Zep	MemoClaw
Authentication	API key + project	Wallet signature / x402
Pricing	Subscription	Pay-per-request (variable per endpoint)
Memory model	Session-based	Content-based with namespaces
Knowledge graph	Built-in	Relations (5 types)
Fact extraction	Automatic	Via /ingest or /extract

Concept Mapping

Zep	MemoClaw
client.memory.add(session_id, messages)	client.ingest(messages=messages)
client.memory.search(text)	client.recall(query)
Session	session_id parameter
User	Wallet address (automatic)
Collection	namespace

Migration Steps

1. Install MemoClaw

   Python

   pip install memoclaw
   

   npm install memoclaw
   # or pnpm add memoclaw
   
2. Replace session-based memory

   Zep (before)

   from zep_cloud.client import Zep
   client = Zep(api_key="z_...")
   client.memory.add(session_id="s1", messages=[
       {"role": "user", "content": "I prefer dark mode"},
   ])
   results = client.memory.search("preferences", limit=5)
   

   from memoclaw import MemoClaw
   client = MemoClaw()
   client.ingest(
       messages=[{"role": "user", "content": "I prefer dark mode"}],
       session_id="s1",
       auto_relate=True,
   )
   results = client.recall("preferences", limit=5)
   
3. Migrate knowledge graph to relations

   client.create_relation(
       memory_id_1,
       target_id=memory_id_2,
       relation_type="related_to",
   )
   

What You Gain

• Simpler auth — no API keys to rotate
• Predictable costs — pay exactly what you use
• 100 free calls (many endpoints are completely free) — try before you pay
• Memory types with decay — corrections persist longer than observations
• Consolidation — auto-merge redundant memories