Knowledge

Email Fetcher

_raw/openclaw/p5678-sessions-skills-docs-logs-2026-05-25/skills/email-fetcher/SKILL.md

name: email-fetcher description: Download emails from an IMAP mailbox and save them as .eml files for local analysis. Use this skill when the user wants to fetch, download, or archive emails from their email account (163 mail or other IMAP providers) to local storage in EML format for subsequent analysis.

Email Fetcher

Overview

Connects to an IMAP server via SSL, downloads emails from a specified folder, and saves each email as a .eml file. Configuration is managed via config.env in the skill root.

Quick Start

bash

# 1. Load credentials
source config.env

# 2. Fetch the most recent emails (default: last 10, saved to ./emails/)
python3 scripts/fetch_emails.py

# 3. Custom output dir and limit
python3 scripts/fetch_emails.py --output-dir ./my_emails --limit 50

Configuration

Edit config.env in the skill root to change connection settings:

Variable	Purpose
`MAIL_HOST`	IMAP server hostname
`MAIL_PORT`	IMAP SSL port (default 993)
`MAIL_USER`	Email login address
`MAIL_PASSWORD`	Password or app-specific token
`MAIL_FOLDER`	Folder to fetch from (e.g. INBOX)
`MAIL_FETCH_LIMIT`	Max emails per run (default 10)

Output

Downloaded .eml files are saved to the emails/ folder in the skill root by default. Each file is named <uid>_<subject>.eml. EML files are standard RFC 822 format and can be opened by any email client or parsed with Python's email module for further analysis.

163 Mail Notes

163 mail requires two things for IMAP access:

Authorization code (授权码): Go to 163 mail web → Settings → POP3/SMTP/IMAP → enable IMAP → generate an authorization code. Set MAIL_PASSWORD in config.env to that code (not your login password).
IMAP ID command: 163 mail returns "Unsafe Login" on SELECT unless the client sends an IMAP ID command first. The script handles this automatically.

Script

scripts/fetch_emails.py — main download script; uses only Python stdlib (no pip installs required)