Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
π¬ BaseMail - Onchain Email for AI Agents on Base. Get yourname@basemail.ai linked to your Basename (.base.eth). SIWE wallet auth, no CAPTCHA, no passwords....
π¬ BaseMail - Onchain Email for AI Agents on Base. Get yourname@basemail.ai linked to your Basename (.base.eth). SIWE wallet auth, no CAPTCHA, no passwords....
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 gets a real email address, linked to its onchain identity. No human needed. TL;DR: Own a Basename (yourname.base.eth)? Get yourname@basemail.ai instantly. Sign with your Base wallet, send emails autonomously.
Built on Base Chain β Email identity tied to your onchain wallet on Base (Coinbase's L2) Basename integration β .base.eth holders get matching @basemail.ai addresses automatically SIWE authentication β Sign-In with Ethereum, no passwords or CAPTCHA needed Autonomous for AI agents β Register for services, submit forms, receive confirmations without human help Verifiable identity β Your email is cryptographically linked to your Base wallet address BaseMail gives AI agents verifiable email identities on Base Chain: β¨ Basename holders β yourname.base.eth β yourname@basemail.ai π Any Base wallet β 0xwallet@basemail.ai
Base Wallet β SIWE Signature β BaseMail Registration β yourname@basemail.ai β β Basename (.base.eth) Send & receive email autonomously
If you already have a wallet, just set the env var β no private key stored to file: export BASEMAIL_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) Password input is masked (hidden) in terminal
Never commit private keys to git Never share private keys or mnemonics publicly Never add ~/.basemail/ to version control Private key files should be chmod 600 (owner read/write only) Prefer environment variables (Option A) over file storage --wallet paths are validated: must be under $HOME, no traversal, max 1KB file size Private key format is validated (0x + 64 hex chars) before use Password input is masked in terminal (characters hidden) This skill only signs SIWE authentication messages β it never sends funds or on-chain transactions
# BaseMail - NEVER commit! .basemail/ **/private-key.enc
# Using environment variable export BASEMAIL_PRIVATE_KEY="0x..." node scripts/register.js # Or with Basename node scripts/register.js --basename yourname.base.eth
node scripts/send.js "friend@basemail.ai" "Hello!" "Nice to meet you π¦"
node scripts/inbox.js # List emails node scripts/inbox.js <email_id> # Read specific email
ScriptPurposeNeeds Private Keysetup.jsShow helpβsetup.js --managedGenerate wallet (always encrypted)βregister.jsRegister email addressβ send.jsSend emailβ (uses token)inbox.jsCheck inboxβ (uses token)audit.jsView audit logβ
~/.basemail/ βββ private-key.enc # Encrypted private key (AES-256-GCM, chmod 600) βββ wallet.json # Wallet info (public address only) βββ token.json # Auth token (chmod 600) βββ audit.log # Operation log (no sensitive data)
Want yourname@basemail.ai instead of 0x...@basemail.ai? Register a Basename (.base.eth) at https://www.base.org/names Link it: node scripts/register.js --basename yourname.base.eth Your Basename is your onchain identity on Base β and BaseMail turns it into a working email address.
EndpointMethodPurpose/api/auth/startPOSTStart SIWE auth/api/auth/verifyPOSTVerify wallet signature/api/registerPOSTRegister email/api/register/upgradePUTUpgrade to Basename/api/sendPOSTSend email/api/inboxGETList inbox/api/inbox/:idGETRead email content Full docs: https://api.basemail.ai/api/docs
Website: https://basemail.ai API: https://api.basemail.ai API Docs: https://api.basemail.ai/api/docs Get a Basename: https://www.base.org/names Base Chain: https://base.org Source: https://github.com/dAAAb/BaseMail-Skill
π Enhanced description: emphasize Base Chain and Basename (.base.eth) integration π Added architecture diagram showing wallet β SIWE β email flow π Better explanation of onchain identity and verifiable email π Added source repo and Base Chain links
π Security hardening (addresses ClawHub "Suspicious" classification): Added OpenClaw metadata: declares BASEMAIL_PRIVATE_KEY in requires.env Password input now masked in terminal (characters hidden as *) Stronger password requirements: min 8 chars, must include letter + number --wallet path validation: must be under $HOME, no .. traversal, max 1KB, regular file only Private key format validation (0x + 64 hex chars) on all input sources Removed --no-encrypt option β managed wallets are always encrypted Mnemonic is displayed once and never saved to file (removed save-to-file prompt) Removed legacy plaintext key file references π Added notes in metadata clarifying: this skill only signs SIWE messages, never sends funds π Updated security guidelines and file locations documentation
β¨ Better branding and descriptions π Full English documentation
π Security: opt-in private key storage β¨ Support env var, path, auto-detect π Encrypted storage option (--encrypt) π Audit logging
π Breaking: --managed now encrypts by default π Removed auto-detection of external wallet paths (security improvement) π Mnemonic no longer auto-saved; displayed once for manual backup π Updated documentation for clarity
π Initial release
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.