Agent skill
qqmail
Manage QQ Mail (QQ邮箱) via IMAP/SMTP. Use when the user wants to read, send, search, or manage emails from their QQ mailbox. Supports reading inbox, sending emails with attachments, searching by subject/sender/date, and listing folders.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/qqmail
Metadata
Additional technical details for this skill
- openclaw
-
{ "os": [ "win32", "linux", "darwin" ], "requires": { "bins": [ "python3" ] }, "primaryEnv": "QQMAIL_AUTH_CODE" }
SKILL.md
QQ Mail Manager
Manage QQ邮箱 via standard IMAP/SMTP protocols using Python scripts.
Prerequisites
The user must enable IMAP/SMTP in QQ Mail settings and obtain an authorization code (授权码):
- Log in to mail.qq.com → Settings (设置) → Account (账户)
- Enable IMAP/SMTP service
- Generate an authorization code (授权码) — this is NOT the QQ password
Configuration
The skill reads credentials from environment variables:
QQMAIL_USER— QQ email address (e.g.[email protected])QQMAIL_AUTH_CODE— Authorization code from QQ Mail settings (授权码)
Available Operations
Read recent emails
python3 {baseDir}/scripts/qqmail.py inbox --limit 10
Shows: sender, subject, date, and a text preview of each email.
Read a specific email by index
python3 {baseDir}/scripts/qqmail.py read --index 1
Shows the full email content (text body).
Send an email
python3 {baseDir}/scripts/qqmail.py send --to "[email protected]" --subject "Hello" --body "Email content here"
Send with attachment
python3 {baseDir}/scripts/qqmail.py send --to "[email protected]" --subject "Report" --body "See attached" --attachment "/path/to/file.pdf"
Search emails
python3 {baseDir}/scripts/qqmail.py search --subject "keyword"
python3 {baseDir}/scripts/qqmail.py search --from "[email protected]"
python3 {baseDir}/scripts/qqmail.py search --since "2026-01-01"
python3 {baseDir}/scripts/qqmail.py search --subject "meeting" --since "2026-02-01" --limit 5
List mail folders
python3 {baseDir}/scripts/qqmail.py folders
Read from a specific folder
python3 {baseDir}/scripts/qqmail.py inbox --folder "Sent Messages" --limit 5
Error Handling
- If authentication fails: verify QQMAIL_USER and QQMAIL_AUTH_CODE are set correctly.
- If IMAP is not enabled: guide the user to enable it in QQ Mail settings.
- Connection errors may indicate network issues or proxy requirements.
Notes
- QQ Mail IMAP server:
imap.qq.com:993(SSL) - QQ Mail SMTP server:
smtp.qq.com:465(SSL) - All scripts use Python 3 standard library only (no pip install needed).
- Email content is decoded with charset detection for proper Chinese display.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?