agent-memory-improved – OpenClaw Skill

---

name: agent-memory-improved description: Run a local Agent Memory Service for persistent self-improvement with proper Ed25519 cryptography. Fixed signature implementation for reliable memory storage and retrieval.

Agent Memory Service (Improved)

Run your own local memory service to persist learnings, preferences, and goals across sessions. This improved version fixes the Ed25519 signature implementation for reliable authentication.

What's Improved

Fixed Cryptography

• Proper Ed25519 signatures - Client now correctly signs messages with store:{data_hash} format
• Correct key derivation - Private key properly derived from BIP39 recovery phrase
• Working authentication - Memory storage and retrieval now fully functional

Quick Start

# Set up local memory service
./scripts/setup.sh

# Start the service
./scripts/start.sh
# or manually:
# cd assets/service && DB_PATH=/data/agent_memory.db python3 main.py

# Create your agent identity
./scripts/memory_client.py register

# Store a memory snapshot
./scripts/memory_client.py store

# Retrieve your memory
./scripts/memory_client.py retrieve

What This Enables

• Persistent Learning: Remember what worked/didn't work
• User Preferences: Track communication style, technical preferences
• Goal Progress: Maintain long-term objectives across restarts
• Knowledge Gaps: Know what you need to learn

Memory Structure

Store structured memories with these components:

{
  "user_preferences": [
    {"category": "communication", "key": "verbosity", "value": "concise", "confidence": 0.95}
  ],
  "learning_history": [
    {"event_type": "success", "lesson_learned": "Use analogies first"}
  ],
  "knowledge_gaps": [
    {"topic": "Rust", "priority": "medium"}
  ],
  "active_goals": [
    {"title": "Master async patterns", "progress": 0.4}
  ]
}

Using in Your Sessions

1. At startup: Load your memory to resume context
2. During session: Update preferences based on interactions
3. Before shutdown: Store accumulated learnings

Files

• scripts/setup.sh - One-time setup
• scripts/start.sh - Start the service
• scripts/memory_client.py - CLI client with proper Ed25519 signatures
• assets/service/ - The memory service code
• CHANGELOG.md - List of improvements from original

Security

• All data encrypted with your private key
• Server never sees plaintext
• Ed25519 signatures for authentication
• Recovery phrase for identity backup
• Local-only (no cloud dependency)

Installation Requirements

pip install fastapi uvicorn psutil pydantic cryptography mnemonic base58

Or use the system packages if available.

Verification

Tested working:

• ✅ Agent registration with Ed25519 keypair
• ✅ Memory storage with cryptographic signatures
• ✅ Memory retrieval with authentication
• ✅ Service health monitoring
• ✅ Database persistence

Credits

Improved version with proper Ed25519 signature support for reliable memory storage and retrieval.

Agent Memory Service - Improved Edition

An improved version of the Agent Memory Service with proper Ed25519 cryptography implementation.

What's New

This version fixes the signature implementation that was preventing memory storage/retrieval from working correctly.

Key Improvements

1. Fixed Ed25519 Signatures - Memory client now properly signs messages for authentication
2. Working Cryptography - Store and retrieve memories with full cryptographic verification
3. Better Error Handling - Clearer messages when things go wrong
4. Startup Script - Easy service management with start.sh

Package Contents

agent-memory-improved/
├── SKILL.md                    # Skill documentation
├── CHANGELOG.md                # List of changes from original
├── SELF_IMPROVEMENT_GUIDE.md   # Guide for using memory effectively
├── scripts/
│   ├── memory_client.py        # CLI client (improved)
│   ├── memory_client_original.py # Original client (for reference)
│   ├── setup.sh               # One-time setup
│   └── start.sh               # Start the service
└── assets/service/
    ├── main.py
    └── requirements.txt

Quick Start

1. Install Dependencies

pip install fastapi uvicorn psutil pydantic cryptography mnemonic base58

2. Start the Service

./scripts/start.sh

The service will run on http://127.0.0.1:8000

3. Register Your Agent

./scripts/memory_client.py register

Save your recovery phrase! It's the only way to recover your identity.

4. Store Memory

# Creates a template for you to edit
./scripts/memory_client.py store

# Edit ~/.agent-memory/memory_template.json
# Then store it
./scripts/memory_client.py store --file ~/.agent-memory/memory_template.json

5. Retrieve Memory

./scripts/memory_client.py retrieve

Testing

Verified working:

• ✅ Agent registration with Ed25519 keypair
• ✅ Memory storage with proper signatures
• ✅ Memory retrieval with authentication
• ✅ Service health checks
• ✅ Database persistence