Raven Memory

Persistent causal memory for AI agents. Raven records everything your agent does as a causally-linked chain, including decisions, tool calls, parallel work, and session history. Your agent finally remembers.

Raven gives your OpenClaw agent persistent causal memory that survives across sessions, days, and weeks.

What it does

• Records every significant event as a node in a causal chain
• Loads relevant history at session start via semantic search
• Supports rollback, branching, and parallel task tracking
• Stores everything locally in ~/.raven/raven.db
• Encrypted at rest with SQLCipher (optional)

Tools exposed

• raven_start_session — load context at conversation start
• raven_record_event — write an event to the chain
• raven_end_session — close session with notes
• raven_search — semantic search over full history
• raven_rollback — undo N steps
• raven_get_status — health check

Setup

Install from PyPI:

bash

pip install raven-memory

With semantic search (recommended):

bash

pip install "raven-memory[vec]"

Then install this skill:

bash

clawhub install raven-memory

Add to your OpenClaw system prompt:

text

At the start of every conversation, call raven_start_session with
the user's first message as search_query. Load the returned
summary/nodes into your context before responding. Record events with raven_record_event. End sessions with raven_end_session.