163 Email Monitor
/install 163-email-monitor
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 protected]
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 "[email protected]"
# 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 [email protected] --subject "Hello" --body "Content here"
# Send with attachment
python3 scripts/mail_client.py send --to [email protected] --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 |
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install 163-email-monitor - After installation, invoke the skill by name or use
/163-email-monitor - Provide required inputs per the skill's parameter spec and get structured output
What is 163 Email Monitor?
Connect to 163/126/yeah.net (Coremail) email via IMAP, read inbox, search emails, and send emails via SMTP. Activate when user asks to check email, read mail... It is an AI Agent Skill for Claude Code / OpenClaw, with 163 downloads so far.
How do I install 163 Email Monitor?
Run "/install 163-email-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 163 Email Monitor free?
Yes, 163 Email Monitor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 163 Email Monitor support?
163 Email Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 163 Email Monitor?
It is built and maintained by Emory Sermon (@hanyuhh); the current version is v1.0.1.