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