Feishu Chat History Importer#

Import Feishu chat history exports into OpenClaw episodic memory. Converts feishu JSON exports into daily episodic summaries that the Dreaming system can process and display in Imported Insights and Memory Palace views.

Quick Start#

bash

# Dry run — preview what would be imported
python3 skills/feishu-chat-importer/scripts/batch.py --dir memory/Chat-history --dry-run

# Import all Feishu chats
python3 skills/feishu-chat-importer/scripts/batch.py --dir memory/Chat-history

# Import only chats since a date
python3 skills/feishu-chat-importer/scripts/batch.py --dir memory/Chat-history --since 2026-03-01

# Verbose — show every message
python3 skills/feishu-chat-importer/scripts/batch.py --dir memory/Chat-history --dry-run --verbose

How It Works#

1. Read feishu_chat_YYYYMMDD.json files from the source directory
2. Group messages by date (from create_time / millisecond timestamp)
3. Normalize each message to {role, content, timestamp}
   • sender.sender_type = "user" → role = user
   • sender.sender_type = "app" → role = assistant (Feishu bot = AI)
4. Write daily episodic summaries to memory/episodic/YYYY-MM-DD.md
5. Dreaming processes episodic files → appears in Imported Insights + Memory Palace

Output Format#

Writes to memory/episodic/YYYY-MM-DD.md:

markdown

## Feishu Chat: <chat_id> (2026-03-19)
- Messages: <count>
- Participants: user_id, app_id

### user (首长):
message content here...

### assistant (飞书机器人):
message content here...

Key Concepts#

• Daily grouping: All messages from the same YYYYMMDD file land in the same episodic file
• Deduplication: Chat IDs tracked — re-running never creates duplicates
• Role mapping: User messages → user, App/bot messages → assistant
• Content extraction: Handles text and post msg_type automatically
• OPENCLAW_WORKSPACE: Set this env var to point imports to the right agent workspace

Source Format#

Expects Feishu export files named feishu_chat_YYYYMMDD.json with this structure:

json

[
  {
    "message_id": "om_xxx",
    "chat_id": "oc_xxx",
    "create_time": "1773899372102",
    "msg_type": "text|post",
    "sender": {
      "id": "ou_xxx",
      "sender_type": "user|app"
    },
    "body": {
      "content": "{\"text\":\"message text\"}"  // text type
      // or
      "content": "{\"title\":\"\",\"content\":[[{\"tag\":\"text\",\"text\":\"...\"}]]}"  // post type
    }
  }
]