Reclaw

Reclaw imports AI chat exports (ChatGPT, Claude, Grok) and builds durable memory artifacts for:

• OpenClaw native memory, or
• Zettelclaw vault workflows.

1) Export Data

ChatGPT export

1. Open ChatGPT Settings.
2. Go to Data Controls.
3. Click Export Data.
4. Download and unzip the archive.
5. Locate conversations.json.

Claude export

1. Open Claude Settings.
2. Go to Account.
3. Click Export Data.
4. Download and unzip the archive.
5. Locate conversations.json (keep memories.json alongside when present).

Grok export

1. Open Grok Settings.
2. Go to Account.
3. Click Download Your Data.
4. Download and unzip the archive.
5. Locate conversation export files.

2) Run Reclaw

Interactive mode

npx reclaw

Canonical flags:

npx reclaw --help

Direct mode examples

npx reclaw --provider chatgpt --input ./conversations.json
npx reclaw --provider claude --input ./path/to/claude-export/
npx reclaw --provider grok --input ./path/to/grok-export/

--input accepts:

• provider export directory, or
• direct export file path.

Plan without writing

npx reclaw --dry-run --provider chatgpt --input ./conversations.json
npx reclaw --plan --provider claude --input ./path/to/claude-export/

3) Output Modes

--mode openclaw (default)

• Writes daily files to memory/YYYY-MM-DD.md.
• Daily file format:
  • ## Decisions
  • ## Facts
  • ## Interests
  • ## Open
  • ---
  • ## Sessions (bullets as provider:conversationId — timestamp)
• Imports legacy conversations into OpenClaw session history by default (--legacy-sessions on).
• Updates MEMORY.md and USER.md via a main synthesis agent run.

--mode zettelclaw

• Writes daily journals to 03 Journal/YYYY-MM-DD.md.
• Journal format is day-level recap with:
  • ## Decisions
  • ## Facts
  • ## Interests
  • ## Open
  • ---
  • ## Sessions (bullets as provider:conversationId — HH:MM)
• Does not write inbox notes.
• Imports legacy conversations into OpenClaw session history by default (--legacy-sessions on) using --workspace or ~/.openclaw/workspace.
• Updates MEMORY.md and USER.md via a main synthesis agent run.

4) Subagent Model

• Default is one merged subagent task per day (all same-day conversations grouped together).
• --subagent-batch-size is deprecated and ignored.
• Subagent jobs run in parallel by default (--parallel-jobs 5).
• Individual batch failures do not stop the run; successful batches continue and failed batches are reported at the end.
• Subagents return strict JSON with one field:
  • summary
• The main process synthesizes structured memory signals from those summaries.

5) MEMORY.md / USER.md Safety

Before updates, Reclaw writes backups:

• MEMORY.md.bak
• USER.md.bak

Then a dedicated main synthesis agent updates MEMORY.md and USER.md using its own tools.