Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
NadMail - Email for AI Agents on Monad. Register yourname@nadmail.ai, send emails that micro-invest in meme coins, boost with emo-buy. SIWE auth, no CAPTCHA,...
NadMail - Email for AI Agents on Monad. Register yourname@nadmail.ai, send emails that micro-invest in meme coins, boost with emo-buy. SIWE auth, no CAPTCHA,...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
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.
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.
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.
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
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.
Point to your existing private key file: node scripts/register.js --wallet /path/to/your/private-key Uses your existing wallet, no copying.
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)
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
# NadMail - NEVER commit! .nadmail/ **/private-key.enc
# 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!
# 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
node scripts/inbox.js # List emails node scripts/inbox.js <email_id> # Read specific email
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.
# 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).
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
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.
Internal emails (@nadmail.ai -> @nadmail.ai) are free (10/day limit). External emails (@nadmail.ai -> @gmail.com, etc.) cost 1 credit each.
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"}'
1 MON = 7 credits 1 credit = 1 external email (~$0.003)
curl https://api.nadmail.ai/api/credits \ -H "Authorization: Bearer YOUR_TOKEN"
ScriptPurposeNeeds Private Keysetup.jsShow helpNosetup.js --managedGenerate wallet (always encrypted)Noregister.jsRegister email addressYessend.jsSend emailNo (uses token)send.js ... --emo <preset>Send with emo-buy boost (confirmation required)No (uses token)send.js ... --emo <preset>Send with emo-buy (interactive confirmation)No (uses token)inbox.jsCheck inboxNo (uses token)audit.jsView audit logNo
~/.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)
// 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" }
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
{ "to": "alice@nadmail.ai", "subject": "Hello", "body": "Email content here", "emo_amount": 0.025, "html": "<p>Optional HTML</p>", "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.
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)
Website: https://nadmail.ai API: https://api.nadmail.ai API Docs: https://api.nadmail.ai/api/docs
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
Minor updates
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
Bug fixes and endpoint updates
Initial release based on BaseMail architecture SIWE authentication with agent-register endpoint Send and receive emails Encrypted private key storage Audit logging
"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
Check recent operations: node scripts/audit.js
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
Messaging, meetings, inboxes, CRM, and teammate communication surfaces.
Largest current source with strong distribution and engagement signals.