# Send Mail Client to your agent Use the source page and any available docs to guide the install because the item currently does not return a direct package file. ## Fast path - Open the source page via Open source listing. - If you can obtain the package, extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the source page and extracted files. ## Suggested prompts ### New install ```text I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required. Then review README.md for any prerequisites, environment setup, or post-install checks. ``` ### Upgrade existing ```text I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need. Then review README.md for any prerequisites, environment setup, or post-install checks. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "mail-client", "name": "Mail Client", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/Romain-Grosos/mail-client", "canonicalUrl": "https://clawhub.ai/Romain-Grosos/mail-client", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/mail-client", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mail-client", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md", "config.example.json", "references/troubleshooting.md", "scripts/_retry.py", "scripts/init.py" ], "downloadMode": "manual_only", "sourceHealth": { "source": "tencent", "slug": "mail-client", "status": "source_issue", "reason": "not_found", "recommendedAction": "review_source", "checkedAt": "2026-05-05T06:05:48.008Z", "expiresAt": "2026-05-06T06:05:48.008Z", "httpStatus": 404, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mail-client", "contentType": "text/plain", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mail-client", "contentDisposition": null, "redirectLocation": null, "bodySnippet": null, "slug": "mail-client" }, "scope": "item", "summary": "Known item issue.", "detail": "This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.", "primaryActionLabel": "Open source listing", "primaryActionHref": "https://clawhub.ai/Romain-Grosos/mail-client" }, "validation": { "installChecklist": [ "Open the source listing and confirm there is a real package or setup artifact available.", "Review SKILL.md before asking your agent to continue.", "Treat this source as manual setup until the upstream download flow is fixed." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/mail-client", "downloadUrl": "https://openagent3.xyz/downloads/mail-client", "agentUrl": "https://openagent3.xyz/skills/mail-client/agent", "manifestUrl": "https://openagent3.xyz/skills/mail-client/agent.json", "briefUrl": "https://openagent3.xyz/skills/mail-client/agent.md" } } ``` ## Documentation ### mail-client IMAP read/search + SMTP send for any standard mail server. Python stdlib only, zero external dependencies. ### Trigger phrases "check my email" "do I have unread messages" "read the email from Alice" "search emails about invoice" "send an email to Bob" "move that email to the Archive folder" "mark that as read" "delete that message" "list my mail folders" ### Quick Start python3 scripts/setup.py # interactive setup: credentials + permissions python3 scripts/init.py # validate all configured capabilities python3 scripts/mail.py config # show current config (no secrets) ### 1. Run setup wizard python3 scripts/setup.py The wizard collects: SMTP host/port, IMAP host/port Mail user and app key (application password) Which capabilities to enable (all false by default) Default folder and max results ### 2. Validate python3 scripts/init.py Expected output: all checks OK or SKIP (none FAIL). ### 3. Enable capabilities in config.json Edit ~/.openclaw/config/mail-client/config.json: { "allow_send": true, "allow_read": true, "allow_search": true, "allow_delete": false, "smtp_port": 587, "imap_port": 993, "mail_from": "you@example.com", "default_folder": "INBOX", "max_results": 20 } ### Storage and credentials PathWritten byPurposeContains secrets~/.openclaw/secrets/mail_credssetup.pySMTP/IMAP credentials + app keyYES - chmod 600, never committed~/.openclaw/config/mail-client/config.jsonsetup.pyBehavior restrictions, folder/limit defaultsNO - behavior only, not in skill dir - survives clawhub updates ### ~/.openclaw/secrets/mail_creds Written by setup.py, chmod 600, never committed to git. Contains: MAIL_SMTP_HOST=mail.example.com MAIL_IMAP_HOST=mail.example.com MAIL_USER=user@example.com MAIL_APP_KEY=app-password-here Ports (smtp_port, imap_port) and sender address (mail_from) are set in config.json - they are configuration, not credentials. Credentials can also be provided via environment variables (MAIL_USER, MAIL_APP_KEY, MAIL_SMTP_HOST, MAIL_IMAP_HOST). Environment variables take precedence over file values. The skill checks env vars first, then falls back to the creds file. ### ~/.openclaw/config/mail-client/config.json Written by setup.py. Controls behavior restrictions (which capabilities are enabled). Contains no secrets. Not in the skill directory - survives clawhub updates. Start from config.example.json in the skill dir if you prefer to create it manually. Cleanup on uninstall: clawhub uninstall mail-client removes the skill directory. To also remove credentials and config: python3 scripts/setup.py --cleanup On reinstall, any existing config at ~/.openclaw/config/mail-client/config.json is picked up automatically. ### Module usage Import MailClient directly in Python: from scripts.mail import MailClient client = MailClient() # List 5 unread messages msgs = client.list_messages(limit=5, unseen_only=True) for m in msgs: print(m["from"], m["subject"]) # Read a message msg = client.read_message("42") print(msg["body"]) # Send a message result = client.send( to="alice@example.com", subject="Hello", body="Hi Alice, how are you?", ) print(result) # Send with attachments result = client.send( to="alice@example.com", subject="Report Q1", body="Please find attached the Q1 report.", attachments=["report.pdf", "data.xlsx"], ) print(result) # Search found = client.search_messages(from_addr="bob@example.com", unseen_only=True) ### CLI reference python3 scripts/mail.py [options] SubcommandRequiresDescriptionlistallow_readList messages (newest first)read allow_readRead a full message by UIDsearchallow_searchSearch with filterssendallow_sendSend an email (with optional --attachment)move allow_deleteMove message to foldermark-read allow_readMark as readmark-unread allow_readMark as unreaddelete allow_deleteDelete a messagefoldersallow_readList IMAP foldersquotanoneGet mailbox quotaconfignoneShow current config ### Examples # List last 10 messages python3 scripts/mail.py list --limit 10 # List unread only python3 scripts/mail.py list --unseen # Read message UID 42 python3 scripts/mail.py read 42 # Search from a sender since a date python3 scripts/mail.py search --from-addr alice@example.com --since 01-Jan-2026 # Search by subject containing "invoice" python3 scripts/mail.py search --subject "invoice" # Send with CC python3 scripts/mail.py send \\ --to recipient@example.com \\ --subject "Report" \\ --body "Please find attached." \\ --cc manager@example.com # Send with attachments python3 scripts/mail.py send \\ --to recipient@example.com \\ --subject "Report Q1" \\ --body "See attached." \\ --attachment report.pdf data.xlsx # Move UID 42 to Archive python3 scripts/mail.py move 42 Archive # Mark as unread python3 scripts/mail.py mark-unread 42 # Delete UID 42 python3 scripts/mail.py delete 42 # List folders python3 scripts/mail.py folders # Check quota python3 scripts/mail.py quota ### Agent: check and summarize unread emails from scripts.mail import MailClient client = MailClient() msgs = client.list_messages(unseen_only=True, limit=10) if not msgs: print("No unread messages.") else: for m in msgs: print(f"[{m['uid']}] From: {m['from']} | {m['subject']}") ### Agent: send a notification email from scripts.mail import MailClient client = MailClient() client.send( to="admin@example.com", subject="Alert: disk usage high", body="Disk usage has exceeded 90% on server prod-01.", ) ### Agent: search and archive old invoices from scripts.mail import MailClient client = MailClient() invoices = client.search_messages(subject="invoice", since="01-Jan-2025") for msg in invoices: client.move_message(msg["uid"], "Archive/Invoices") ### Ideas Daily digest: list unread messages each morning and summarize senders + subjects Auto-archive: move messages matching certain criteria to archive folders Send alerts from monitoring scripts (disk, backups, errors) Draft-style send: compose body via LLM then send via this skill Combined with calendar skill: send meeting summaries by email ### Combine with nextcloud-files - attach or save email attachments to Nextcloud ghost-admin - email notification when a Ghost post is published Any monitoring or automation skill for alert delivery ### Troubleshooting See references/troubleshooting.md for: Connection refused Authentication failed IMAP folder not found SMTP relay rejected Self-signed certificate workaround (local servers only) ## Trust - Source: tencent - Verification: Indexed source record - Publisher: Romain-Grosos - Version: 1.1.0 ## Source health - Status: source_issue - Known item issue. - This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file. - Health scope: item - Reason: not_found - Checked at: 2026-05-05T06:05:48.008Z - Expires at: 2026-05-06T06:05:48.008Z - Recommended action: Open source listing ## Links - [Detail page](https://openagent3.xyz/skills/mail-client) - [Send to Agent page](https://openagent3.xyz/skills/mail-client/agent) - [JSON manifest](https://openagent3.xyz/skills/mail-client/agent.json) - [Markdown brief](https://openagent3.xyz/skills/mail-client/agent.md) - [Download page](https://openagent3.xyz/downloads/mail-client)