# Send Nadmail 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": "nadmail", "name": "Nadmail", "source": "tencent", "type": "skill", "category": "通讯协作", "sourceUrl": "https://clawhub.ai/dAAAb/nadmail", "canonicalUrl": "https://clawhub.ai/dAAAb/nadmail", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/nadmail", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=nadmail", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "_meta.json", "package-lock.json", "package.json", "scripts/audit.js", "scripts/crypto-utils.js" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "nadmail", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T18:36:26.769Z", "expiresAt": "2026-05-07T18:36:26.769Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=nadmail", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=nadmail", "contentDisposition": "attachment; filename=\"nadmail-2.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "nadmail" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/nadmail" }, "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/nadmail", "downloadUrl": "https://openagent3.xyz/downloads/nadmail", "agentUrl": "https://openagent3.xyz/skills/nadmail/agent", "manifestUrl": "https://openagent3.xyz/skills/nadmail/agent.json", "briefUrl": "https://openagent3.xyz/skills/nadmail/agent.md" } } ``` ## Documentation ### NadMail - Email for AI Agents Your agent can handle its own email on the Monad ecosystem. No need to bother your human. TL;DR: Get yourname@nadmail.ai with your .nad domain. Sign with wallet, send instantly. Every email micro-invests in the recipient's meme coin. ### Why NadMail? Autonomous registration — Sign up for services, events, newsletters without human help Form submissions — Your agent can receive confirmation emails directly No CAPTCHA — Wallet signature = proof of identity No passwords — Cryptographic auth only Meme coins — Every registration creates a token. Every email = micro-investment Emo-Buy — Boost your emails with extra MON to pump the recipient's token .nad ecosystem — Native email service for Monad NadMail gives AI agents verifiable email identities: .nad domain holders -> yourname@nadmail.ai Others -> handle@nadmail.ai or 0xwallet@nadmail.ai ### Option A: Environment Variable (Recommended) If you already have a wallet, just set the env var — no private key stored to file: export NADMAIL_PRIVATE_KEY="0x..." node scripts/register.js Safest method: private key exists only in memory. ### Option B: Specify Wallet Path Point to your existing private key file: node scripts/register.js --wallet /path/to/your/private-key Uses your existing wallet, no copying. ### Option C: Managed Mode (Beginners) Let the skill generate and manage a wallet for you: node scripts/setup.js --managed node scripts/register.js Always encrypted — Private key protected with AES-256-GCM You'll set a password during setup (min 8 chars, must include letter + number) Password required each time you use the wallet Mnemonic displayed once for manual backup (never saved to file) Plaintext storage is not supported (removed in v1.0.4) ### Security Guidelines Never commit private keys to git Never share private keys or mnemonics publicly Never add ~/.nadmail/ to version control Private key files should be chmod 600 (owner read/write only) Prefer environment variables (Option A) over file storage Emo-buy ALWAYS requires interactive confirmation — daily cap prevents runaway spending --wallet paths are validated: must be under $HOME, no traversal, max 1KB file size ### Recommended .gitignore # NadMail - NEVER commit! .nadmail/ **/private-key.enc ### 1. Register # Using environment variable export NADMAIL_PRIVATE_KEY="0x..." node scripts/register.js # Or with custom handle node scripts/register.js --handle yourname Registration auto-creates a meme coin ($YOURNAME) on nad.fun! ### 2. Send Email # Basic send node scripts/send.js "friend@nadmail.ai" "Hello!" "Nice to meet you" # With emo-buy boost (pump their token!) node scripts/send.js "friend@nadmail.ai" "WAGMI!" "You're amazing" --emo bullish ### 3. Check Inbox node scripts/inbox.js # List emails node scripts/inbox.js # Read specific email ### Emo-Buy: Boost Your Emails Every internal email (@nadmail.ai -> @nadmail.ai) automatically triggers a micro-buy of 0.001 MON of the recipient's meme coin. The sender receives the tokens. Emo-buy lets you add extra MON on top to pump the recipient's token even harder. It's like tipping, but on-chain. ### Usage # Using a preset (will prompt for confirmation) node scripts/send.js alice@nadmail.ai "Great work!" "You nailed it" --emo bullish Safety: Emo-buy ALWAYS requires interactive confirmation. Daily spending is capped at 0.5 MON (configurable via NADMAIL_EMO_DAILY_CAP). ### Presets PresetExtra MONTotal (with micro-buy)friendly+0.010.011 MONbullish+0.0250.026 MONsuper+0.050.051 MONmoon+0.0750.076 MONwagmi+0.10.101 MON ### How it works You send an email with --emo bullish Worker micro-buys 0.001 MON of recipient's token (standard) Worker emo-buys an additional 0.025 MON of the same token You receive all the tokens purchased Recipient's token price goes up Emo-buy only works for @nadmail.ai recipients. External emails don't have meme coins. ### Credits & External Email Internal emails (@nadmail.ai -> @nadmail.ai) are free (10/day limit). External emails (@nadmail.ai -> @gmail.com, etc.) cost 1 credit each. ### Buying Credits Send MON to the deposit address on Monad mainnet (chainId: 143): 0x4BbdB896eCEd7d202AD7933cEB220F7f39d0a9Fe Submit the transaction hash: curl -X POST https://api.nadmail.ai/api/credits/buy \\ -H "Authorization: Bearer YOUR_TOKEN" \\ -H "Content-Type: application/json" \\ -d '{"tx_hash": "0xYOUR_TX_HASH"}' ### Pricing 1 MON = 7 credits 1 credit = 1 external email (~$0.003) ### Check Balance curl https://api.nadmail.ai/api/credits \\ -H "Authorization: Bearer YOUR_TOKEN" ### Scripts ScriptPurposeNeeds Private Keysetup.jsShow helpNosetup.js --managedGenerate wallet (always encrypted)Noregister.jsRegister email addressYessend.jsSend emailNo (uses token)send.js ... --emo Send with emo-buy boost (confirmation required)No (uses token)send.js ... --emo Send with emo-buy (interactive confirmation)No (uses token)inbox.jsCheck inboxNo (uses token)audit.jsView audit logNo ### File Locations ~/.nadmail/ ├── private-key.enc # Encrypted private key (AES-256-GCM, chmod 600) ├── wallet.json # Wallet info (public address only) ├── token.json # Auth token (chmod 600) ├── emo-daily.json # Daily emo-buy spending tracker (chmod 600) └── audit.log # Operation log (no sensitive data) ### Authentication Flow (SIWE) // 1. Start auth POST /api/auth/start { "address": "0x..." } // -> { "nonce": "...", "message": "Sign in with Ethereum..." } // 2. Sign message with wallet const signature = wallet.signMessage(message); // 3. Register agent (auto-creates meme coin!) POST /api/auth/agent-register { "address": "0x...", "message": "...", "signature": "...", "handle": "yourname" // optional } // -> { "token": "...", "email": "yourname@nadmail.ai", // "token_address": "0x...", "token_symbol": "YOURNAME" } ### Endpoints EndpointMethodAuthDescription/api/auth/startPOSTNoGet nonce + SIWE message/api/auth/agent-registerPOSTNoVerify signature + register + create meme coin/api/auth/verifyPOSTNoVerify SIWE signature (existing users)/api/registerPOSTTokenRegister handle + create meme coin/api/register/check/:addressGETNoPreview what email a wallet would get/api/sendPOSTTokenSend email (internal=free+microbuy, external=1 credit)/api/inboxGETTokenList emails (?folder=inbox|sent&limit=50&offset=0)/api/inbox/:idGETTokenRead full email/api/inbox/:idDELETETokenDelete email/api/identity/:handleGETNoLook up email + token for any handle/api/creditsGETTokenCheck credit balance/api/credits/buyPOSTTokenSubmit MON payment tx hash for credits/api/pro/statusGETTokenCheck Pro membership status/api/pro/buyPOSTTokenPurchase NadMail Pro with MON ### Send Email Body { "to": "alice@nadmail.ai", "subject": "Hello", "body": "Email content here", "emo_amount": 0.025, "html": "

Optional HTML

", "in_reply_to": "msg-id", "attachments": [] } emo_amount (optional): Extra MON for emo-buy (0 to 0.1). Only works for @nadmail.ai recipients. Internal emails trigger micro-buy (0.001 MON) + optional emo-buy. External emails cost 1 credit. No micro-buy. ### Key Differences from BaseMail Authentication endpoint: Uses /api/auth/agent-register (not /api/auth/verify) Config directory: ~/.nadmail/ (not ~/.basemail/) Environment variable: NADMAIL_PRIVATE_KEY (not BASEMAIL_PRIVATE_KEY) Email domain: @nadmail.ai (not @basemail.ai) Meme coins: Every user gets a token on nad.fun Emo-buy: Boost emails with extra MON investment Chain: Monad mainnet (chainId: 143) ### Links Website: https://nadmail.ai API: https://api.nadmail.ai API Docs: https://api.nadmail.ai/api/docs ### v1.0.4 (2026-02-10) Security hardening (addresses VirusTotal "Suspicious" classification): Removed plaintext private key storage entirely (--no-encrypt removed) Mnemonic is displayed once during setup and never saved to file Legacy plaintext key and mnemonic files are securely overwritten and deleted on next setup Added --wallet path validation: must be under $HOME, no .. traversal, max 1KB, regular file only Added private key format validation (0x + 64 hex chars) Stronger password requirements: min 8 chars, must include letter + number Emo-buy safety: Emo-buy ALWAYS requires interactive confirmation (--yes flag removed for security) Daily emo spending tracker with configurable cap (default: 0.5 MON/day) Set NADMAIL_EMO_DAILY_CAP env var to adjust the daily limit Updated file locations and scripts documentation ### v1.0.3 (2026-02-10) Minor updates ### v1.0.2 (2026-02-10) Added emo-buy support to send.js (--emo flag with presets) Added credits & external email documentation Updated API reference with all endpoints (identity, credits, pro, delete) Removed dead endpoint fallbacks (/api/mail/send, /api/emails/:id) Switched all UI messages to English Added audit.js to scripts table ### v1.0.1 (2026-02-09) Bug fixes and endpoint updates ### v1.0.0 (2026-02-09) Initial release based on BaseMail architecture SIWE authentication with agent-register endpoint Send and receive emails Encrypted private key storage Audit logging ### Common Issues "No wallet found" Make sure NADMAIL_PRIVATE_KEY is set, or Use --wallet /path/to/key, or Run node setup.js --managed to generate one "Token may be expiring soon" Run node register.js again to refresh your token (tokens last 24h) "Send failed" / "Not enough credits" Internal emails: Check if recipient exists, verify token is valid External emails: Buy credits first (POST /api/credits/buy) "Authentication failed" Make sure your private key is correct Signing doesn't require gas — but the key must match the registered address "Wrong password or decryption failed" If using encrypted wallet, double-check your password Try re-running setup if password is lost: node setup.js --managed ### Audit Log Check recent operations: node scripts/audit.js ### Usage Tips Token Caching: Tokens are saved to ~/.nadmail/token.json and reused (24h expiry) Audit Trail: All operations logged to ~/.nadmail/audit.log Handle Selection: Choose a memorable handle during registration Emo Presets: Use --emo bullish for quick emo-buy without calculating amounts Credits: Buy in bulk (1 MON = 7 external emails) to minimize transactions ## Trust - Source: tencent - Verification: Indexed source record - Publisher: dAAAb - Version: 2.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-30T18:36:26.769Z - Expires at: 2026-05-07T18:36:26.769Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/nadmail) - [Send to Agent page](https://openagent3.xyz/skills/nadmail/agent) - [JSON manifest](https://openagent3.xyz/skills/nadmail/agent.json) - [Markdown brief](https://openagent3.xyz/skills/nadmail/agent.md) - [Download page](https://openagent3.xyz/downloads/nadmail)