# Send imap-smtp-email to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "imap-smtp-email", "name": "imap-smtp-email", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/gzlicanyi/imap-smtp-email", "canonicalUrl": "https://clawhub.ai/gzlicanyi/imap-smtp-email", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/imap-smtp-email", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=imap-smtp-email", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "setup.sh", "package.json", "scripts/config.js", "scripts/smtp.js", "scripts/imap.js" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/imap-smtp-email" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "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/imap-smtp-email", "downloadUrl": "https://openagent3.xyz/downloads/imap-smtp-email", "agentUrl": "https://openagent3.xyz/skills/imap-smtp-email/agent", "manifestUrl": "https://openagent3.xyz/skills/imap-smtp-email/agent.json", "briefUrl": "https://openagent3.xyz/skills/imap-smtp-email/agent.md" } } ``` ## Documentation ### IMAP/SMTP Email Tool Read, search, and manage email via IMAP protocol. Send email via SMTP. Supports Gmail, Outlook, 163.com, vip.163.com, 126.com, vip.126.com, 188.com, vip.188.com, and any standard IMAP/SMTP server. ### Configuration Run the setup script to configure your email account: bash setup.sh Configuration is stored at ~/.config/imap-smtp-email/.env (survives skill updates). If no config is found there, the skill falls back to a .env file in the skill directory (for backward compatibility). ### Config file format # Default account (no prefix) IMAP_HOST=imap.gmail.com IMAP_PORT=993 IMAP_USER=your@email.com IMAP_PASS=your_password IMAP_TLS=true IMAP_REJECT_UNAUTHORIZED=true IMAP_MAILBOX=INBOX SMTP_HOST=smtp.gmail.com SMTP_PORT=587 SMTP_SECURE=false SMTP_USER=your@email.com SMTP_PASS=your_password SMTP_FROM=your@email.com SMTP_REJECT_UNAUTHORIZED=true # File access whitelist (security) ALLOWED_READ_DIRS=~/Downloads,~/Documents ALLOWED_WRITE_DIRS=~/Downloads ### Multi-Account You can configure additional email accounts in the same config file. Each account uses a name prefix (uppercase) on all variables. ### Adding an account Run the setup script and choose "Add a new account": bash setup.sh Or manually add prefixed variables to ~/.config/imap-smtp-email/.env: # Work account (WORK_ prefix) WORK_IMAP_HOST=imap.company.com WORK_IMAP_PORT=993 WORK_IMAP_USER=me@company.com WORK_IMAP_PASS=password WORK_IMAP_TLS=true WORK_IMAP_REJECT_UNAUTHORIZED=true WORK_IMAP_MAILBOX=INBOX WORK_SMTP_HOST=smtp.company.com WORK_SMTP_PORT=587 WORK_SMTP_SECURE=false WORK_SMTP_USER=me@company.com WORK_SMTP_PASS=password WORK_SMTP_FROM=me@company.com WORK_SMTP_REJECT_UNAUTHORIZED=true ### Using a named account Add --account before the command: node scripts/imap.js --account work check node scripts/smtp.js --account work send --to foo@bar.com --subject Hi --body Hello Without --account, the default (unprefixed) account is used. ### Account name rules Letters and digits only (e.g., work, 163, personal2) Case-insensitive: work and WORK refer to the same account The prefix in .env is always uppercase (e.g., WORK_IMAP_HOST) ALLOWED_READ_DIRS and ALLOWED_WRITE_DIRS are shared across all accounts (always unprefixed) ### Common Email Servers ProviderIMAP HostIMAP PortSMTP HostSMTP Port163.comimap.163.com993smtp.163.com465vip.163.comimap.vip.163.com993smtp.vip.163.com465126.comimap.126.com993smtp.126.com465vip.126.comimap.vip.126.com993smtp.vip.126.com465188.comimap.188.com993smtp.188.com465vip.188.comimap.vip.188.com993smtp.vip.188.com465yeah.netimap.yeah.net993smtp.yeah.net465Gmailimap.gmail.com993smtp.gmail.com587Outlookoutlook.office365.com993smtp.office365.com587QQ Mailimap.qq.com993smtp.qq.com587 Important for Gmail: Gmail does not accept your regular account password You must generate an App Password: https://myaccount.google.com/apppasswords Use the generated 16-character App Password as IMAP_PASS / SMTP_PASS Requires Google Account with 2-Step Verification enabled Important for 163.com: Use authorization code (授权码), not account password Enable IMAP/SMTP in web settings first ### check Check for new/unread emails. node scripts/imap.js [--account ] check [--limit 10] [--mailbox INBOX] [--recent 2h] Options: --limit : Max results (default: 10) --mailbox : Mailbox to check (default: INBOX) --recent