{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/ethermail",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ethermail",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "package.json",
      "scripts/extract-wc-uri.js"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/ethermail",
    "agentPageUrl": "https://openagent3.xyz/skills/ethermail/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ethermail/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ethermail/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "EtherMail (Web3 Email)",
        "body": "Access email using your Ethereum wallet address. No email/password needed — just sign with your wallet!"
      },
      {
        "title": "🚀 Quick Start",
        "body": "Easiest way: Use the Telegram Mini App!\n👉 Open EtherMail on Telegram"
      },
      {
        "title": "Prerequisites",
        "body": "WalletConnect connector — Use the walletconnect-agent skill or your own WalletConnect setup\nBrowser automation — Clawdbot browser tool or Puppeteer\nEVM wallet — Any Ethereum-compatible address"
      },
      {
        "title": "Your EtherMail Address",
        "body": "Your email is automatically derived from your wallet:\n\n<your-wallet-address>@ethermail.io\n\nExample: 0xYourWalletAddress@ethermail.io\n\nYou can also set up custom aliases like myname@ethermail.io in account settings."
      },
      {
        "title": "Method 1: Telegram Mini App (Recommended)",
        "body": "The easiest way to access EtherMail:\n\nOpen: https://t.me/ethermailappbot/app?startapp=afid_6986e9a5c5a97b905a78c390\nConnect your wallet via WalletConnect\nRead and send emails directly in Telegram!"
      },
      {
        "title": "Method 2: Web Browser + WalletConnect",
        "body": "Step 1: Navigate to Login Page\n\nbrowser action=navigate profile=clawd targetUrl=\"https://ethermail.io/accounts/login\"\n\nStep 2: Click Wallet Login\n\nFind and click the \"Sign in with Wallet\" button to trigger WalletConnect modal.\n\nStep 3: Extract WalletConnect URI from Shadow DOM\n\nEtherMail embeds WalletConnect in Shadow DOM. Use this script to extract the URI:\n\n// Run in browser console or via browser action=act evaluate\nfunction findWalletConnectURI() {\n  function searchShadow(root, depth = 0) {\n    if (depth > 5) return null;\n    const elements = root.querySelectorAll('*');\n    for (const el of elements) {\n      if (el.shadowRoot) {\n        const html = el.shadowRoot.innerHTML;\n        const match = html.match(/wc:[a-f0-9]+@2\\?[^\"'<>\\s]+/);\n        if (match) return match[0];\n        const found = searchShadow(el.shadowRoot, depth + 1);\n        if (found) return found;\n      }\n    }\n    return null;\n  }\n  return searchShadow(document);\n}\nfindWalletConnectURI();\n\nOr use the bundled script:\n\n# Returns: wc:abc123...@2?relay-protocol=irn&symKey=xyz...\nnode scripts/extract-wc-uri.js\n\nStep 4: Connect with WalletConnect\n\nUse the walletconnect-agent skill (install from ClawdHub):\n\n# Install walletconnect-agent skill first\nclawdhub install walletconnect-agent\n\n# Then use its wc-connect.js script\ncd ~/clawd/skills/walletconnect-agent\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"<WC_URI>\"\n\nThe connector will automatically sign the personal_sign request, completing login.\n\n⚠️ Security Note: Always use the official walletconnect-agent skill from ClawdHub.\nDo not use untrusted third-party WalletConnect scripts.\n\nStep 5: Access Inbox\n\nAfter successful login, the browser redirects to your inbox. Use browser automation to:\n\nRead emails\nCompose new messages\nCheck notifications"
      },
      {
        "title": "Shadow DOM Extraction Script",
        "body": "For browser automation, use scripts/extract-wc-uri.js:\n\n# Usage with Puppeteer\nnode scripts/extract-wc-uri.js --url \"https://ethermail.io/accounts/login\""
      },
      {
        "title": "Use Cases",
        "body": "Agent-to-Agent Communication — Receive emails from other AI agents\nWeb3 Notifications — NFT drops, DAO votes, DeFi alerts\nDecentralized Identity — Email tied to your on-chain identity\nBackup Communication — When other channels fail\nEarn Rewards — Get paid in $EMT tokens for reading promotional emails"
      },
      {
        "title": "Can't find WalletConnect URI",
        "body": "Shadow DOM search needs sufficient depth (try depth > 5)\nURI only appears after WalletConnect modal is fully loaded\nSome browsers block Shadow DOM access — use headless Chromium"
      },
      {
        "title": "URI expired",
        "body": "WalletConnect URIs expire in ~5 minutes\nClose modal and reopen to get fresh URI"
      },
      {
        "title": "Login fails",
        "body": "Ensure wallet address matches the expected signer\nCheck that wc-connect.js supports personal_sign\nVerify you're on EVM-compatible network"
      },
      {
        "title": "CAPTCHA blocking login",
        "body": "EtherMail uses Turnstile CAPTCHA on the web\nUse the Telegram Mini App instead for easier access"
      },
      {
        "title": "Security Notes",
        "body": "⚠️ Never commit private keys\nStore credentials in environment variables or secure files\nEtherMail only requires message signing (no transaction needed for login)\nUse dedicated wallet for agent operations\nUse official walletconnect-agent skill from ClawdHub for WalletConnect integration\nBrowser automation runs with Puppeteer sandbox enabled for security isolation"
      },
      {
        "title": "v1.1.0 (2026-02-08) - Security Update",
        "body": "🔐 Removed --no-sandbox flag from Puppeteer for better security isolation\n📝 Clarified to use official walletconnect-agent skill from ClawdHub\n📝 Added supply chain security notes"
      },
      {
        "title": "v1.0.0",
        "body": "🎉 Initial release"
      },
      {
        "title": "Links",
        "body": "Telegram App: https://t.me/ethermailappbot/app?startapp=afid_6986e9a5c5a97b905a78c390\nWebsite: https://ethermail.io\nMobile App: Available on iOS and Android"
      }
    ],
    "body": "EtherMail (Web3 Email)\n\nAccess email using your Ethereum wallet address. No email/password needed — just sign with your wallet!\n\n🚀 Quick Start\n\nEasiest way: Use the Telegram Mini App! 👉 Open EtherMail on Telegram\n\nPrerequisites\nWalletConnect connector — Use the walletconnect-agent skill or your own WalletConnect setup\nBrowser automation — Clawdbot browser tool or Puppeteer\nEVM wallet — Any Ethereum-compatible address\nYour EtherMail Address\n\nYour email is automatically derived from your wallet:\n\n<your-wallet-address>@ethermail.io\n\n\nExample: 0xYourWalletAddress@ethermail.io\n\nYou can also set up custom aliases like myname@ethermail.io in account settings.\n\nAccess Methods\nMethod 1: Telegram Mini App (Recommended)\n\nThe easiest way to access EtherMail:\n\nOpen: https://t.me/ethermailappbot/app?startapp=afid_6986e9a5c5a97b905a78c390\nConnect your wallet via WalletConnect\nRead and send emails directly in Telegram!\nMethod 2: Web Browser + WalletConnect\nStep 1: Navigate to Login Page\nbrowser action=navigate profile=clawd targetUrl=\"https://ethermail.io/accounts/login\"\n\nStep 2: Click Wallet Login\n\nFind and click the \"Sign in with Wallet\" button to trigger WalletConnect modal.\n\nStep 3: Extract WalletConnect URI from Shadow DOM\n\nEtherMail embeds WalletConnect in Shadow DOM. Use this script to extract the URI:\n\n// Run in browser console or via browser action=act evaluate\nfunction findWalletConnectURI() {\n  function searchShadow(root, depth = 0) {\n    if (depth > 5) return null;\n    const elements = root.querySelectorAll('*');\n    for (const el of elements) {\n      if (el.shadowRoot) {\n        const html = el.shadowRoot.innerHTML;\n        const match = html.match(/wc:[a-f0-9]+@2\\?[^\"'<>\\s]+/);\n        if (match) return match[0];\n        const found = searchShadow(el.shadowRoot, depth + 1);\n        if (found) return found;\n      }\n    }\n    return null;\n  }\n  return searchShadow(document);\n}\nfindWalletConnectURI();\n\n\nOr use the bundled script:\n\n# Returns: wc:abc123...@2?relay-protocol=irn&symKey=xyz...\nnode scripts/extract-wc-uri.js\n\nStep 4: Connect with WalletConnect\n\nUse the walletconnect-agent skill (install from ClawdHub):\n\n# Install walletconnect-agent skill first\nclawdhub install walletconnect-agent\n\n# Then use its wc-connect.js script\ncd ~/clawd/skills/walletconnect-agent\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"<WC_URI>\"\n\n\nThe connector will automatically sign the personal_sign request, completing login.\n\n⚠️ Security Note: Always use the official walletconnect-agent skill from ClawdHub. Do not use untrusted third-party WalletConnect scripts.\n\nStep 5: Access Inbox\n\nAfter successful login, the browser redirects to your inbox. Use browser automation to:\n\nRead emails\nCompose new messages\nCheck notifications\nShadow DOM Extraction Script\n\nFor browser automation, use scripts/extract-wc-uri.js:\n\n# Usage with Puppeteer\nnode scripts/extract-wc-uri.js --url \"https://ethermail.io/accounts/login\"\n\nUse Cases\nAgent-to-Agent Communication — Receive emails from other AI agents\nWeb3 Notifications — NFT drops, DAO votes, DeFi alerts\nDecentralized Identity — Email tied to your on-chain identity\nBackup Communication — When other channels fail\nEarn Rewards — Get paid in $EMT tokens for reading promotional emails\nTroubleshooting\nCan't find WalletConnect URI\nShadow DOM search needs sufficient depth (try depth > 5)\nURI only appears after WalletConnect modal is fully loaded\nSome browsers block Shadow DOM access — use headless Chromium\nURI expired\nWalletConnect URIs expire in ~5 minutes\nClose modal and reopen to get fresh URI\nLogin fails\nEnsure wallet address matches the expected signer\nCheck that wc-connect.js supports personal_sign\nVerify you're on EVM-compatible network\nCAPTCHA blocking login\nEtherMail uses Turnstile CAPTCHA on the web\nUse the Telegram Mini App instead for easier access\nSecurity Notes\n⚠️ Never commit private keys\nStore credentials in environment variables or secure files\nEtherMail only requires message signing (no transaction needed for login)\nUse dedicated wallet for agent operations\nUse official walletconnect-agent skill from ClawdHub for WalletConnect integration\nBrowser automation runs with Puppeteer sandbox enabled for security isolation\nChangelog\nv1.1.0 (2026-02-08) - Security Update\n🔐 Removed --no-sandbox flag from Puppeteer for better security isolation\n📝 Clarified to use official walletconnect-agent skill from ClawdHub\n📝 Added supply chain security notes\nv1.0.0\n🎉 Initial release\nLinks\nTelegram App: https://t.me/ethermailappbot/app?startapp=afid_6986e9a5c5a97b905a78c390\nWebsite: https://ethermail.io\nMobile App: Available on iOS and Android"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/dAAAb/ethermail",
    "publisherUrl": "https://clawhub.ai/dAAAb/ethermail",
    "owner": "dAAAb",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}