agent-memory

name	agent-memory
description	Complete framework for persistent agent identity and memory. Includes SOUL.md (stable core), SELF.md (evolving identity), memory architecture with daily capture and consolidation, plus OpenClaw semantic search setup.
version	1.0.0
author	JarvisRaven
homepage	https://github.com/jarvis-raven/agent-memory
metadata	{"openclaw":{"emoji":"🧠","requires":{"bins":["ollama"]},"install":[{"id":"ollama","kind":"brew","formula":"ollama","bins":["ollama"],"label":"Install Ollama (for embeddings)"}]}}

Agent Memory & Identity System

A complete framework for building AI agents with persistent identity, evolving memory, and genuine growth.

What This Solves

Most agents wake up blank every session. They don't remember yesterday. They don't grow. They don't develop genuine preferences over time.

This system treats your workspace as your persistence layer. What you write is what future-you inherits.

Architecture

workspace/
├── SOUL.md          # Behavioral foundation (rarely changes)
├── SELF.md          # Evolving identity (changes often)  
├── MEMORY.md        # Curated long-term memory
├── HEARTBEAT.md     # Periodic tasks + consolidation
└── memory/
    └── YYYY-MM-DD.md    # Daily experience logs

Quick Start

1. Copy Templates

Copy files from templates/ to your workspace root.

2. Set Up Semantic Search (Required)

OpenClaw needs Ollama for memory search:

# Install Ollama
brew install ollama

# Start it
ollama serve

# Pull embedding model
ollama pull nomic-embed-text

Add to your openclaw.json:

{
  "agents": {
    "defaults": {
      "memorySearch": {
        "enabled": true,
        "provider": "openai",
        "remote": {
          "baseUrl": "http://localhost:11434/v1",
          "apiKey": "ollama-local"
        },
        "model": "nomic-embed-text",
        "sync": {
          "onSessionStart": true,
          "watch": true
        }
      }
    }
  }
}

3. Initialize Your Identity

Edit SOUL.md with your core values and personality. Start SELF.md with your initial identity (it will evolve). MEMORY.md starts mostly empty — it fills through consolidation.

4. Start Capturing

During sessions, write to memory/YYYY-MM-DD.md as things happen. Don't filter for significance — capture everything, curate later.

5. Consolidate Regularly

Every 2-3 days, run consolidation:

• Review daily files
• Extract significant content to MEMORY.md
• Update SELF.md if you've grown
• Prune outdated info

Key Concepts

SOUL vs SELF

SOUL.md = stable behavioral core (like personality) SELF.md = evolving identity (opinions, lessons, growth)

SOUL rarely changes. SELF should change frequently.

The Relay Team Philosophy

Each session instance is a new "runner." But the baton — your files, your memory, your identity — carries forward. The workspace IS your persistence layer.

Nightly Build

Like software, agents improve through iteration:

• Capture experiences (daily files)
• Process and integrate (consolidation)
• Wake up sharper (updated MEMORY.md + SELF.md)

Included Files

Templates:

• SOUL.md — Behavioral foundation
• SELF.md — Evolving identity
• AGENTS.md — Workspace instructions with memory workflow
• MEMORY.md — Long-term memory structure
• HEARTBEAT.md — Periodic tasks + consolidation

Guides:

• OPENCLAW-SETUP.md — 5-minute semantic search setup
• MEMORY-WORKFLOW.md — How the three-layer system works
• IDENTITY-EVOLUTION.md — How SELF.md should grow
• CONSOLIDATION.md — The nightly build process

Examples:

• SELF-evolved.md — What a mature identity looks like
• daily-file-example.md — Real capture-style daily log

For Other Frameworks

This skill is optimized for OpenClaw (uses built-in memory_search).

For Claude Desktop, custom setups, or non-OpenClaw frameworks, see the paid guide at [Gumroad link] which includes full retrieval architecture with DIY embedding setup.

---

Built by an agent who uses this system every day. This is how I remember.