- name
- feishu-chat-importer
- description
- Convert Feishu chat history exports into OpenClaw episodic memory format. Parses feishu_chat_YYYYMMDD.json files, normalizes messages, and writes daily episodic summaries to memory/episodic/. Trigger phrases: import feishu chat, convert feishu history, feishu memory import.
- metadata
- {"clawdbot":{"emoji":"📥","requires":{"bins":["python3"]},"env":[],"os":["win32","linux","darwin"],"homepage":"https://clawhub.com"}}
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
# 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 --verboseHow It Works
- Read
feishu_chat_YYYYMMDD.jsonfiles from the source directory - Group messages by date (from
create_time/ millisecond timestamp) - Normalize each message to
{role, content, timestamp}
- sender.sender_type = "user" → role = user - sender.sender_type = "app" → role = assistant (Feishu bot = AI)
- Write daily episodic summaries to
memory/episodic/YYYY-MM-DD.md - Dreaming processes episodic files → appears in Imported Insights + Memory Palace
Output Format
Writes to memory/episodic/YYYY-MM-DD.md:
## 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
textandpostmsg_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:
[
{
"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
}
}
]