openclaw-logkeeper

Turn-by-turn conversation logger for OpenClaw. Appends every completed agent exchange to daily markdown files — across Discord, TUI, webchat, cron, and any other surface — regardless of which model is running.

Unlike the built-in session-memory hook (which saves a snapshot only when you issue /new or /reset), Scribe writes continuously: one entry per turn, every turn, to a configurable directory.

Output is plain markdown, compatible with QMD and other local search tools.

Install

From ClawHub (recommended):

openclaw plugins install clawhub:openclaw-logkeeper

From npm:

npm install -g openclaw-logkeeper
openclaw plugins install ./node_modules/openclaw-logkeeper

From source:

git clone https://github.com/jsperson/openclaw-logkeeper.git
cd openclaw-logkeeper
npm install && npm run build
openclaw plugins install ./

Required configuration

Scribe requires two things in your ~/.openclaw/openclaw.json:

1. Grant conversation access (required for agent_end hook to fire):

{
  "plugins": {
    "entries": {
      "openclaw-logkeeper": {
        "enabled": true,
        "hooks": {
          "allowConversationAccess": true
        },
        "config": {
          "logDir": "~/your/log/directory"
        }
      }
    }
  }
}

Without allowConversationAccess: true, the hook is silently blocked by OpenClaw and no logs will be written.

2. Set logDir — the directory where daily files are written. Supports ~/ expansion. This field is required; the plugin will not start without it.

Verify it's working: Send a message in any channel, then check your logDir for a file named YYYY-MM-DD-discord.md (or YYYY-MM-DD-tui.md for TUI sessions). It should appear within 30 seconds.

Configuration reference

All options go under plugins.entries.openclaw-logkeeper.config in openclaw.json.

Full example

{
  "plugins": {
    "entries": {
      "openclaw-logkeeper": {
        "enabled": true,
        "hooks": {
          "allowConversationAccess": true
        },
        "config": {
          "logDir": "~/ai-logs",
          "filename": "{date}-{channel}.md",
          "channels": {
            "discord": "{date}-discord.md",
            "tui": "{date}-tui.md"
          },
          "userAlias": "scott",
          "maxLength": 4000,
          "includeCron": false,
          "metadata": false
        }
      }
    }
  }
}

QMD integration

If you use QMD to search your logs, point logDir at the directory QMD's daily-logs collection scans. QMD's **/*.md pattern picks up any filename suffix automatically — no QMD config changes needed.

Example output

~/ai-logs/2026-05-07-discord.md:

# 2026-05-07

### 14:32
**scott:** What's on my calendar today?

**jomama:** You have three items: standup at 09:30, PT at 14:00, and Jason's soccer game at 18:00.

### 15:01
**scott:** Set a reminder to call Mom at 19:00.

**jomama:** Done — reminder added to Apple Reminders.

~/ai-logs/2026-05-07-tui.md:

# 2026-05-07

### 09:15
**scott:** Show me last week's summary.

**jomama:** Here's what happened last week: ...

With metadata: true:

### 14:32
· claude-opus-4-7 · 312↑ 87↓
**scott:** What's on my calendar today?

**jomama:** You have three items: ...

How it works

Scribe uses OpenClaw's agent_end plugin hook, which fires after every completed agent turn — regardless of surface, model, or channel. This makes it:

• Model-agnostic: works with Claude, Qwen, local models, anything OpenClaw supports
• Surface-complete: Discord, TUI, webchat, cron, and future channels all produce logs
• Continuous: one entry per turn, no manual /reset required

The assistant's display name is read from your workspace IDENTITY.md automatically (- Name: YourAgentName).

Compatibility

• OpenClaw 2026.x+ (plugin API >=2026.3.24-beta.2)
• Node.js 22+

Contributing

Bug reports and PRs welcome at github.com/jsperson/openclaw-logkeeper.

License

MIT © Scott Person