Chat History Importer

Import years of AI conversations into searchable episodic memory. Parse ChatGPT and Claude exports and create dated daily memory files your agent can search and reference. Perfect for onboarding new agents with rich historical context or preserving important conversations for future recall. Pairs well with the chat-learnings-extractor skill for a complete conversation analysis workflow.

Quick Start

1. Export from OpenAI: Settings → Data Controls → Export data → conversations.json
2. Export from Anthropic: Settings → Privacy → Export data → conversations.json in zip
3. Dry run first: python3 scripts/batch.py --dir ~/Downloads/chat_exports --dry-run
4. Import: python3 scripts/batch.py --dir ~/Downloads/chat_exports

Key Concepts

• Auto-detection: Identifies OpenAI vs Anthropic format automatically — no flags needed
• Episodic memory: Writes daily summaries to memory/episodic/YYYY-MM-DD.md
• Deduplication: Chat IDs tracked — re-running the same export never creates duplicates
• OPENCLAW_WORKSPACE: Set this env var to point imports to the right agent workspace
• Human speaker names: Memories are written as Kael: / Deonte: instead of assistant: / user: — auto-read from IDENTITY.md and USER.md in the workspace, making imported history feel like recalled conversations rather than raw log files