WAL Memory

Two-file system for session crash recovery. Survives gateway disconnects, provider outages, and context compaction. Co-designed with Gemini.

The Problem

OpenClaw agents lose state in two ways:

1. Compaction — context window fills, gets summarized, detail lost
2. Session rollover — session dies (crash/disconnect/overload), new session starts cold with zero history

The Two Files

• memory/GOALS.md — The "why": current milestone, sprint tasks, architecture decisions. Updated manually at major milestones or end of session.
• STATE.log — The "what just happened": append-only WAL, auto-timestamped. Never edit manually. Written via state-log.js.

Setup

1. Install the logger script