Skip to main content
The session journal hook writes a rolling log of conversation summaries and extracted facts for each agent session.

Enable

Session journal is opt-in per agent:
Or load it via a hook preset:

What it records

  • Timestamp and session ID
  • A short summary of the turn (generated by the model)
  • Key facts extracted from the conversation
  • Token counts for the turn
Journal files are written to ~/.openclaw/journals/<agent-id>/<date>.jsonl.

Configuration

Limitations

  • Entries are written asynchronously — a crash mid-turn may skip an entry
  • extractFacts: true adds a small LLM call per summarized turn