> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wednesdayai.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Session journal

> Enable per-agent session journals that log conversation summaries and key facts.

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:

```yaml theme={"dark"}
sessionJournal:
  enabled: true
```

Or load it via a hook preset:

```yaml theme={"dark"}
hooks:
  presets:
    - "audit"
```

## 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

```yaml theme={"dark"}
sessionJournal:
  enabled: true
  summarizeEveryN: 5
  extractFacts: true
  maxEntries: 1000
  outputDir: "~/.openclaw/journals"
```

| Key | Type | Default | Description |
| - | - | - | - |
| `enabled` | boolean | `false` | Enable journal for this agent |
| `summarizeEveryN` | integer | `5` | Turns between journal writes |
| `extractFacts` | boolean | `true` | Include LLM-extracted facts per entry |
| `maxEntries` | integer | `1000` | Entries per JSONL file before rotation |
| `outputDir` | string | `~/.openclaw/journals` | Directory for journal files |

## Limitations

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.