# Send Ethermail 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": "ethermail",
    "name": "Ethermail",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/dAAAb/ethermail",
    "canonicalUrl": "https://clawhub.ai/dAAAb/ethermail",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/ethermail",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ethermail",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "package.json",
      "scripts/extract-wc-uri.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "ethermail",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T00:27:43.723Z",
      "expiresAt": "2026-05-07T00:27:43.723Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ethermail",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ethermail",
        "contentDisposition": "attachment; filename=\"ethermail-1.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "ethermail"
      },
      "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/ethermail"
    },
    "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/ethermail",
    "downloadUrl": "https://openagent3.xyz/downloads/ethermail",
    "agentUrl": "https://openagent3.xyz/skills/ethermail/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ethermail/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ethermail/agent.md"
  }
}
```
## Documentation

### EtherMail (Web3 Email)

Access email using your Ethereum wallet address. No email/password needed — just sign with your wallet!

### 🚀 Quick Start

Easiest way: Use the Telegram Mini App!
👉 Open EtherMail on Telegram

### Prerequisites

WalletConnect connector — Use the walletconnect-agent skill or your own WalletConnect setup
Browser automation — Clawdbot browser tool or Puppeteer
EVM wallet — Any Ethereum-compatible address

### Your EtherMail Address

Your email is automatically derived from your wallet:

<your-wallet-address>@ethermail.io

Example: 0xYourWalletAddress@ethermail.io

You can also set up custom aliases like myname@ethermail.io in account settings.

### Method 1: Telegram Mini App (Recommended)

The easiest way to access EtherMail:

Open: https://t.me/ethermailappbot/app?startapp=afid_6986e9a5c5a97b905a78c390
Connect your wallet via WalletConnect
Read and send emails directly in Telegram!

### Method 2: Web Browser + WalletConnect

Step 1: Navigate to Login Page

browser action=navigate profile=clawd targetUrl="https://ethermail.io/accounts/login"

Step 2: Click Wallet Login

Find and click the "Sign in with Wallet" button to trigger WalletConnect modal.

Step 3: Extract WalletConnect URI from Shadow DOM

EtherMail embeds WalletConnect in Shadow DOM. Use this script to extract the URI:

// Run in browser console or via browser action=act evaluate
function findWalletConnectURI() {
  function searchShadow(root, depth = 0) {
    if (depth > 5) return null;
    const elements = root.querySelectorAll('*');
    for (const el of elements) {
      if (el.shadowRoot) {
        const html = el.shadowRoot.innerHTML;
        const match = html.match(/wc:[a-f0-9]+@2\\?[^"'<>\\s]+/);
        if (match) return match[0];
        const found = searchShadow(el.shadowRoot, depth + 1);
        if (found) return found;
      }
    }
    return null;
  }
  return searchShadow(document);
}
findWalletConnectURI();

Or use the bundled script:

# Returns: wc:abc123...@2?relay-protocol=irn&symKey=xyz...
node scripts/extract-wc-uri.js

Step 4: Connect with WalletConnect

Use the walletconnect-agent skill (install from ClawdHub):

# Install walletconnect-agent skill first
clawdhub install walletconnect-agent

# Then use its wc-connect.js script
cd ~/clawd/skills/walletconnect-agent
export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "<WC_URI>"

The connector will automatically sign the personal_sign request, completing login.

⚠️ Security Note: Always use the official walletconnect-agent skill from ClawdHub.
Do not use untrusted third-party WalletConnect scripts.

Step 5: Access Inbox

After successful login, the browser redirects to your inbox. Use browser automation to:

Read emails
Compose new messages
Check notifications

### Shadow DOM Extraction Script

For browser automation, use scripts/extract-wc-uri.js:

# Usage with Puppeteer
node scripts/extract-wc-uri.js --url "https://ethermail.io/accounts/login"

### Use Cases

Agent-to-Agent Communication — Receive emails from other AI agents
Web3 Notifications — NFT drops, DAO votes, DeFi alerts
Decentralized Identity — Email tied to your on-chain identity
Backup Communication — When other channels fail
Earn Rewards — Get paid in $EMT tokens for reading promotional emails

### Can't find WalletConnect URI

Shadow DOM search needs sufficient depth (try depth > 5)
URI only appears after WalletConnect modal is fully loaded
Some browsers block Shadow DOM access — use headless Chromium

### URI expired

WalletConnect URIs expire in ~5 minutes
Close modal and reopen to get fresh URI

### Login fails

Ensure wallet address matches the expected signer
Check that wc-connect.js supports personal_sign
Verify you're on EVM-compatible network

### CAPTCHA blocking login

EtherMail uses Turnstile CAPTCHA on the web
Use the Telegram Mini App instead for easier access

### Security Notes

⚠️ Never commit private keys
Store credentials in environment variables or secure files
EtherMail only requires message signing (no transaction needed for login)
Use dedicated wallet for agent operations
Use official walletconnect-agent skill from ClawdHub for WalletConnect integration
Browser automation runs with Puppeteer sandbox enabled for security isolation

### v1.1.0 (2026-02-08) - Security Update

🔐 Removed --no-sandbox flag from Puppeteer for better security isolation
📝 Clarified to use official walletconnect-agent skill from ClawdHub
📝 Added supply chain security notes

### v1.0.0

🎉 Initial release

### Links

Telegram App: https://t.me/ethermailappbot/app?startapp=afid_6986e9a5c5a97b905a78c390
Website: https://ethermail.io
Mobile App: Available on iOS and Android
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: dAAAb
- Version: 1.1.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-30T00:27:43.723Z
- Expires at: 2026-05-07T00:27:43.723Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/ethermail)
- [Send to Agent page](https://openagent3.xyz/skills/ethermail/agent)
- [JSON manifest](https://openagent3.xyz/skills/ethermail/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/ethermail/agent.md)
- [Download page](https://openagent3.xyz/downloads/ethermail)