All ClawAll Claw
Back to Catalog
OpenClaw Chat History Import logo
skills

OpenClaw Chat History Import

An OpenClaw skill (with companion conversation-history skill) that imports chat histories from ChatGPT, Claude, and other sources into OpenClaw's archive, daily memory files, and MEMORY.md for seamless migration and long-term context retention.

Overview

This is a dedicated OpenClaw skill created by @dashhuang to solve one of the most common migration pains: bringing years of conversations from proprietary AI platforms (especially ChatGPT and Claude) into your self-hosted OpenClaw instance without losing context.

The skill bundle consists of two closely related skills:

  • chat-history-import: Handles inspection, normalization, and distillation of external chat exports into OpenClaw's archive and memory system.
  • conversation-history: Enables searching and retrieving old conversations from the imported archive (exact wording, decisions, links, timelines).

It normalizes raw history into logs/message-archive-raw/, creates daily summary files in memory/YYYY-MM-DD.md, and prepares candidate content for your main MEMORY.md file (which you can review and merge).

Key Features

  • Direct support for official exports:
    • ChatGPT: ZIP containing conversations.json (via Settings → Data controls → Export)
    • Claude: ZIP with conversations.json, memories.json, projects.json, etc. (via Settings → Privacy → Export data)
  • Handles Slack-style transcripts and other semi-structured chat archives
  • Interactive, review-first workflow — inspect and approve before final integration
  • Model-assisted parsing for non-standard or custom formats
  • Generates searchable, chronological archive when paired with conversation-archive plugin (recommended)
  • Preserves long-term context for better agent personalization and continuity

Installation

  1. Clone or download the repo
  2. Copy the skill folders to your OpenClaw workspace:
    • Workspace install: <workspace>/skills/chat-history-import and <workspace>/skills/conversation-history
    • Shared (global) install: ~/.openclaw/skills/chat-history-import and ~/.openclaw/skills/conversation-history
  3. Validate: 
    openclaw skills info chat-history-import
openclaw skills info conversation-history
  4. (Optional) Publish to ClawHub for easier sharing/updates

Avoid duplicate installs of conversation-history — local overrides global; always check active version.

Usage Workflow

  1. Export your data from ChatGPT or Claude (download the ZIP)
  2. Run the import skill in your OpenClaw session (via chat command or TUI)
  3. Skill inspects files → normalizes to archive → distills daily memories → stages MEMORY.md candidates
  4. Review staged content → approve/merge into your main memory file
  5. Use conversation-history skill to query old chats when needed

Benefits

  • Migrate 3+ years of ChatGPT/Claude conversations (as demoed by the author)
  • Avoid "amnesia" — your OpenClaw agent remembers past projects, preferences, decisions
  • Builds a unified, searchable personal knowledge archive
  • Future-proof: portable data you control

Related Resources

  • Repository: https://github.com/dashhuang/openclaw-chat-history-import
  • Author post: https://x.com/DashHuang/status/2034809297486717330 (shows real import of 3+ years of history)
  • Main OpenClaw repo: https://github.com/openclaw/openclaw
  • Recommended companion: conversation-archive plugin

Actively maintained (latest commit March 19, 2026). MIT licensed. Perfect for users transitioning to fully self-hosted AI agents.

Tags

openclawskillchat-historyimportmigrationchatgptclaudememoryarchivepython