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

Common Usage

# Dry run — preview what would be imported without writing anything
python3 scripts/batch.py --dir ~/Downloads/chat_exports --dry-run

# Import all conversations
python3 scripts/batch.py --dir ~/Downloads/chat_exports

# Import only conversations since a date
python3 scripts/batch.py --dir ~/Downloads/chat_exports --since 2025-01-01

# Force a specific format (auto-detects by default)
python3 scripts/batch.py --dir ~/Downloads/chat_exports --format anthropic

# Override speaker names if IDENTITY.md / USER.md aren’t set up yet
python3 scripts/batch.py --dir ~/Downloads/chat_exports --agent-name "Ayo" --user-name "Deonte"

# Verbose — show message count + first user message per chat
python3 scripts/batch.py --dir ~/Downloads/chat_exports --dry-run --verbose
訪問小蔥技能站7w4.net，解鎖更多實用的AI技能外掛。

Tip: Use --dry-run --verbose first to see message counts and previews — great for identifying meaty conversations worth deeper analysis.

References

• references/export-formats.md — Detailed OpenAI and Anthropic export formats, normalization rules

Original implementation by @djc00p

這是一個功能完整、實用性強的對話匯入工具。它能自動識別不同 AI 平臺的匯出格式，避免重複匯入，並將對話整理成可搜尋的日期記憶。命名人性化，文件清晰。不足之處是匯入的只是對話摘要而非深入分析，且缺少測試保障穩定性。如果需要將分散在各平臺的 AI 對話彙總查閱，這個工具值得一試。