Lord1Egypt 163 Email Monitor
Key Insight: Coremail ID Command
163/126/yeah.net use Coremail which requires an IMAP ID command before any mailbox operation, otherwise returns "Unsafe Login" even with valid credentials.
Setup
Prerequisites
Credentials in ~/.openclaw/email-monitor/.env:
IMAP_SERVER=imap.163.com
IMAP_PORT=993
SMTP_SERVER=smtp.163.com
SMTP_PORT=465
EMAIL_ADDRESS=your@163.com
EMAIL_PASSWORD=your_auth_code
The EMAIL_PASSWORD is the 授权码 (authorization code), not the login password. Users obtain it from: 163 Mail → Settings → POP3/SMTP/IMAP → Enable IMAP → Get authorization code.
Server Reference
| Provider | IMAP Server | SMTP Server |
|---|---|---|
| 163.com | imap.163.com:993 | smtp.163.com:465 |
| 126.com | imap.126.com:993 | smtp.126.com:465 |
| yeah.net | imap.yeah.net:993 | smtp.yeah.net:465 |
Usage
All operations use scripts/mail_client.py:
# Read unread emails
python3 scripts/mail_client.py read --unread
# Read latest N emails
python3 scripts/mail_client.py read --latest 10
# Search emails by keyword
python3 scripts/mail_client.py search "amazon"
# Search by sender
python3 scripts/mail_client.py search --from "no-reply@amazon.com"
# Search by date range
python3 scripts/mail_client.py search --since 2026-03-01 --before 2026-03-23
# Send email
python3 scripts/mail_client.py send --to recipient@example.com --subject "Hello" --body "Content here"
# Send with attachment
python3 scripts/mail_client.py send --to recipient@example.com --subject "Report" --body "See attached" --attach /path/to/file.pdf
Pass --env /path/to/.env to override default config location.
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
Unsafe Login |
Missing ID command | Use this skill's script (handles automatically) |
AUTHENTICATIONFAILED |
Wrong auth code | Regenerate 授权码 in 163 web settings |
LOGIN failed |
IMAP not enabled | Enable IMAP in 163 Mail → Settings |