Session Persistence

What it does

OpenClaw stores session data in JSONL files that are difficult to search and easy to lose track of. Session Persistence imports every message into a local SQLite database with full-text search, making the agent's entire history queryable — across all sessions, all channels, all time.

Inspired by lossless-claw's SQLite message persistence layer, which stores every message with sequence numbers, token counts, and structured message parts.

When to invoke

• Automatically every 15 minutes (cron) — incremental import of new messages
• When the agent needs to search past conversations — use --search
• After a crash or session rollover — verify all messages are persisted
• For analytics — message counts, session timelines, activity patterns

How to use