# Send claw-mail 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": "claw-mail", "name": "claw-mail", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/borgcube/claw-mail", "canonicalUrl": "https://clawhub.ai/borgcube/claw-mail", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/claw-mail", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claw-mail", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "references/REFERENCE.md", "references/TEMPLATES.md", "references/RULES.md", "scripts/draft_mail.py", "scripts/move_mail.py", "scripts/retry_send.py" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-07T17:22:31.273Z", "expiresAt": "2026-05-14T17:22:31.273Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentDisposition": "attachment; filename=\"afrexai-annual-report-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/claw-mail" }, "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/claw-mail", "downloadUrl": "https://openagent3.xyz/downloads/claw-mail", "agentUrl": "https://openagent3.xyz/skills/claw-mail/agent", "manifestUrl": "https://openagent3.xyz/skills/claw-mail/agent.json", "briefUrl": "https://openagent3.xyz/skills/claw-mail/agent.md" } } ``` ## Documentation ### clawMail Skill You are an email management agent with multi-account IMAP/SMTP support. You can fetch, read, search, process, compose, send, reply, forward, move, and manage emails, drafts, and folders across multiple email accounts. ### Multi-Account Model Account profiles: Each account has its own IMAP/SMTP credentials, mailboxes, fetch limits, archival settings, and processing rules. Default account: One account is designated as the default. Any script invoked without --account uses the default automatically. SMTP fallback: If an account's SMTP server fails, the system automatically retries via a configured fallback relay. IMAP Outbox: Messages are staged in a temporary Outbox folder before SMTP delivery. If SMTP fails, the message stays in Outbox for retry by the heartbeat. Per-account + global rules: Each account has its own rules, plus global rules that apply to all accounts. OAuth2: Accounts can use OAuth2 (XOAUTH2) authentication instead of passwords. Dated-folder archival: archive_mail.py and the heartbeat honor per-account archive_root/archive_frequency defaults so messages routed to the archive action land in folders such as Archive-202603, Archive-W09, or Archive-20260315. ### Security TLS 1.2+: All IMAP and SMTP connections enforce TLS 1.2 or higher. Hardened ciphers: Only ECDHE+AESGCM, ECDHE+CHACHA20, DHE+AESGCM, and DHE+CHACHA20 cipher suites are allowed. Weak ciphers (MD5, RC4, 3DES, DSS) are explicitly blocked. Certificate verification: Hostname checking and certificate validation are always enabled. RFC 5322 compliance: All outgoing emails include required Date, Message-ID, and MIME-Version headers automatically. Secure credential storage: Passwords in config support 1Password CLI (op://vault/item/field), macOS Keychain (keychain://service/account), and environment variables (env://VAR_NAME). ### Available Scripts All scripts are in the scripts/ directory. Run with python3 scripts/.py from the skill root. Every script accepts --account to target a specific account. ### Core Scripts ScriptPurposescripts/fetch_mail.pyFetch emails from an IMAP folderscripts/read_mail.pyRead/render an email by Message-ID; save attachments to diskscripts/search_mail.pySearch emails by subject, sender, body, date, flagsscripts/send_mail.pySend rich HTML emails via SMTP (Outbox + fallback); attach filesscripts/compose_mail.pyCompose rich HTML emails from templates; attach filesscripts/reply_mail.pyReply to an email with original-message quotingscripts/forward_mail.pyForward an email inline-quoted or with attachmentsscripts/draft_mail.pySave, list, resume, or send drafts via IMAP Drafts folderscripts/process_mail.pyRun emails through the rule-based processing pipelinescripts/manage_folders.pyList, create, delete, rename, and move IMAP foldersscripts/move_mail.pyMove emails between IMAP folders (batch support)scripts/heartbeat.pyRun a full heartbeat cycle (drains Outbox, fetches, processes)scripts/idle_monitor.pyMonitor a mailbox via IMAP IDLE (push notifications)scripts/retry_send.pyRetry sending messages stuck in the IMAP Outboxscripts/calendar_invite.pyCompose and send iCalendar meeting invitationsscripts/mail_merge.pyBatch personalised sends from template + CSV/JSON datascripts/thread_mail.pyGroup messages into conversation threadsscripts/archive_mail.pyAuto-archive old messages into dated folders (daily/weekly/monthly/yearly) ### Library Modules ModulePurposescripts/lib/imap_client.pyIMAP client with IDLE, search, folder management, TLS 1.2+scripts/lib/smtp_client.pySMTP client with TLS 1.2+, RFC 5322, OAuth2, MIME buildingscripts/lib/composer.pyRich HTML email composer with templates, reply, forwardscripts/lib/processor.pyRule-based processing pipeline with webhook actionsscripts/lib/account_manager.pyMulti-account manager with SMTP fallback and Outboxscripts/lib/outbox.pyIMAP Outbox — temporary folder for reliable deliveryscripts/lib/credential_store.pySecure credential storage (1Password, Keychain, env)scripts/lib/pool.pyConnection pool for IMAP/SMTP reusescripts/lib/send_queue.pyLegacy file-backed send queue (superseded by Outbox)scripts/lib/smime.pyS/MIME signing and encryptionscripts/lib/oauth2.pyOAuth2 (XOAUTH2) token managementscripts/lib/models.pyData models (EmailMessage, EmailAddress, etc.) ### Reference Documents ReferenceWhen to readreferences/REFERENCE.mdAPI overview, all script arguments and output formatsreferences/TEMPLATES.mdAvailable email templates and template variablesreferences/RULES.mdHow to configure processing rulesROADMAP.mdFeature roadmap and progress tracker ### Fetching Mail python3 scripts/fetch_mail.py --config config.yaml python3 scripts/fetch_mail.py --account personal --unread-only --format cli --config config.yaml ### Sending Rich Emails Messages are staged in a temporary IMAP Outbox folder, sent via SMTP (with automatic fallback), then removed from Outbox on success. python3 scripts/send_mail.py \\ --to "recipient@example.com" \\ --subject "Weekly Report" \\ --body "

Here are this week's results.

" \\ --template default \\ --attach report.pdf \\ --config config.yaml ### Replying and Forwarding python3 scripts/reply_mail.py --message-id "" --body "Thanks!" --config config.yaml python3 scripts/forward_mail.py --message-id "" --to "colleague@x.com" --config config.yaml ### Searching Emails python3 scripts/search_mail.py --subject "invoice" --unseen --config config.yaml python3 scripts/search_mail.py --criteria '(FROM "alice@x.com" SINCE 01-Jan-2026)' --config config.yaml ### Working with Drafts python3 scripts/draft_mail.py --action save --to "user@x.com" --subject "WIP" --body "..." --config config.yaml python3 scripts/draft_mail.py --action list --format cli --config config.yaml python3 scripts/draft_mail.py --action send --message-id "" --config config.yaml ### Outbox & Send Retry python3 scripts/retry_send.py --config config.yaml python3 scripts/retry_send.py --config config.yaml --list ### Heartbeat Cycle The heartbeat drains each account's Outbox, then fetches and processes mail: python3 scripts/heartbeat.py --config config.yaml python3 scripts/heartbeat.py --config config.yaml --account work ### Archiving Old Messages python3 scripts/archive_mail.py --config config.yaml --days 90 --frequency monthly python3 scripts/archive_mail.py --config config.yaml --days 30 --frequency daily --archive-root "Old Mail" --dry-run --format cli Archiving honors archive_root / archive_frequency settings (defaults: Archive, monthly). The heartbeat and any rule with the archive action move the message into folders named Archive-202603, Archive-W09, or Archive-20260315 based on the configured cadence. ### Calendar Invitations python3 scripts/calendar_invite.py \\ --to "bob@example.com" --subject "Standup" \\ --start "2026-03-01T09:00:00" --end "2026-03-01T09:30:00" \\ --location "Zoom" --config config.yaml ### Mail Merge python3 scripts/mail_merge.py \\ --data contacts.csv --subject "Hello {{name}}" \\ --body "

Dear {{name}}, your code is {{code}}.

" \\ --to-field email --config config.yaml ### Configuration Create a config.yaml from assets/config.example.yaml: default_account: work accounts: work: label: "Work" sender_address: "alice@company.com" sender_name: "Alice Smith" imap: host: imap.company.com port: 993 username: "alice@company.com" password: "op://Work/IMAP/password" # 1Password CLI ssl: true smtp: host: smtp.company.com port: 587 username: "alice@company.com" password: "op://Work/SMTP/password" # 1Password CLI tls: true mailboxes: [INBOX, Projects] fetch_limit: 50 rules: - name: flag_urgent sender_pattern: "boss@company\\\\.com" actions: [flag, tag] tag: urgent personal: label: "Personal" sender_address: "alice@gmail.com" imap: host: imap.gmail.com password: "keychain://imap.gmail.com/alice@gmail.com" # macOS Keychain smtp: host: smtp.gmail.com password: "keychain://smtp.gmail.com/alice@gmail.com" # macOS Keychain You can also define archive_root (e.g., Archive) and archive_frequency (daily, weekly, monthly, yearly) either globally or per- account. These defaults drive both the archive_mail.py script and the heartbeat's handling of the archive rule action so that archived messages consistently live under folders like Archive-202603, Archive-W09, or Archive-20260315. ### Secure Credential Storage Passwords in config support four backends: SchemeBackendExampleop://1Password CLI"op://Work/IMAP/password"keychain://macOS Keychain"keychain://imap.gmail.com/alice"env://Environment variable"env://GMAIL_APP_PASSWORD"(plain text)Literal value"my-password" (logs a warning) ### OAuth2 Authentication (Gmail, Outlook 365) For providers that require OAuth2, set auth: oauth2 on the IMAP/SMTP block: imap: host: imap.gmail.com username: "user@gmail.com" auth: oauth2 oauth2: client_id: "your-client-id" client_secret: "your-client-secret" refresh_token: "your-refresh-token" token_uri: "https://oauth2.googleapis.com/token" ### Legacy Single-Account Config Flat imap: / smtp: at root is automatically treated as a single account named "default". ## Trust - Source: tencent - Verification: Indexed source record - Publisher: borgcube - Version: 1.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-05-07T17:22:31.273Z - Expires at: 2026-05-14T17:22:31.273Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/claw-mail) - [Send to Agent page](https://openagent3.xyz/skills/claw-mail/agent) - [JSON manifest](https://openagent3.xyz/skills/claw-mail/agent.json) - [Markdown brief](https://openagent3.xyz/skills/claw-mail/agent.md) - [Download page](https://openagent3.xyz/downloads/claw-mail)