{
  "schemaVersion": "1.0",
  "item": {
    "slug": "email-manager-lite",
    "name": "eMail manager lite",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/jorgermp/email-manager-lite",
    "canonicalUrl": "https://clawhub.ai/jorgermp/email-manager-lite",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/email-manager-lite",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=email-manager-lite",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CHANGELOG.md",
      "package.json",
      "README.md",
      "scripts/email.js",
      "SKILL.md"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/email-manager-lite"
    },
    "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/email-manager-lite",
    "agentPageUrl": "https://openagent3.xyz/skills/email-manager-lite/agent",
    "manifestUrl": "https://openagent3.xyz/skills/email-manager-lite/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/email-manager-lite/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Email Manager Lite v0.2",
        "body": "A fully self-contained email management skill for OpenClaw. Uses standard IMAP and SMTP protocols with zero external dependencies."
      },
      {
        "title": "🔍 Advanced Search & Filters",
        "body": "Search by sender (--from)\nSearch by subject keywords (--subject)\nFilter by date range (--since, --before)\nFilter by read/unread status (--seen, --unseen)\nSearch in email body (--body, warning: can be slow)"
      },
      {
        "title": "📁 Folder Management",
        "body": "List all IMAP folders with folders command\nMove emails between folders with move command\nAutomatic validation of folder existence"
      },
      {
        "title": "📎 Attachment Information",
        "body": "Automatic detection of attachments\nDisplay attachment details:\n\nFilename\nMIME type\nFile size (formatted KB/MB)\n\n\nShown in both read and search results"
      },
      {
        "title": "🔧 Installation",
        "body": "cd skills/portable-email-manager\nnpm install\n\nDependencies are bundled in package.json:\n\nnodemailer - SMTP email sending\nimap-simple - IMAP operations\nmailparser - Email parsing and attachment detection"
      },
      {
        "title": "🔐 Credentials",
        "body": "Set these environment variables:\n\nexport EMAIL_USER=\"your.email@domain.com\"\nexport EMAIL_PASS=\"your-app-password\"\n\nRecommended: Use App Passwords for Gmail, Outlook, Zoho instead of main password."
      },
      {
        "title": "Provider Setup",
        "body": "Zoho Mail (default):\n\nAlready configured for smtp.zoho.eu and imap.zoho.eu\nGenerate App Password: https://accounts.zoho.eu/home#security/apppasswords\n\nGmail:\n\nEdit scripts/email.js and change:\nhost: 'smtp.gmail.com'  // SMTP\nhost: 'imap.gmail.com'  // IMAP\n\n\nEnable 2FA and create App Password: https://myaccount.google.com/apppasswords\n\nOutlook/Hotmail:\n\nEdit to use smtp.office365.com / outlook.office365.com\nPort 587 for SMTP (TLS)"
      },
      {
        "title": "Send Email",
        "body": "./scripts/email.js send \"recipient@example.com\" \"Subject\" \"Email body text\"\n\nExample:\n\n./scripts/email.js send \"boss@company.com\" \"Weekly Report\" \"Attached is this week's summary.\""
      },
      {
        "title": "Read Recent Emails",
        "body": "./scripts/email.js read [limit]\n\nExamples:\n\n# Read last 5 emails (default)\n./scripts/email.js read\n\n# Read last 20 emails\n./scripts/email.js read 20\n\nOutput includes:\n\nUID (unique ID for moving)\nFrom/To addresses\nSubject and date\nAttachment count and details\nEmail body preview (first 500 chars)"
      },
      {
        "title": "Advanced Search",
        "body": "./scripts/email.js search [options]\n\nSearch Options:\n\nOptionDescriptionExample--from <email>Filter by sender--from \"boss@company.com\"--subject <text>Filter by subject keywords--subject \"invoice\"--since <date>Emails after date--since \"Jan 1, 2026\"--before <date>Emails before date--before \"Feb 1, 2026\"--unseenOnly unread emails--unseen--seenOnly read emails--seen--body <text>Search in body (slow!)--body \"meeting\"--limit <n>Max results--limit 10\n\nExamples:\n\n# Find unread emails from specific sender\n./scripts/email.js search --from \"client@example.com\" --unseen\n\n# Search by subject\n./scripts/email.js search --subject \"invoice\" --limit 5\n\n# Date range search\n./scripts/email.js search --since \"Jan 15, 2026\" --before \"Feb 1, 2026\"\n\n# Search in body (use sparingly - can be slow)\n./scripts/email.js search --body \"quarterly review\"\n\n# Combine multiple filters\n./scripts/email.js search --from \"boss@company.com\" --subject \"urgent\" --unseen --limit 3"
      },
      {
        "title": "List Folders",
        "body": "./scripts/email.js folders\n\nShows hierarchical tree of all IMAP folders with attributes.\n\nExample output:\n\n📁 INBOX\n📁 Sent\n📁 Archive\n📁 Drafts\n📁 Spam\n📁 Trash"
      },
      {
        "title": "Move Email to Folder",
        "body": "./scripts/email.js move <uid> <folder-name>\n\nImportant:\n\nGet the uid from read or search output\nFolder name is case-sensitive\nScript validates folder exists before moving\n\nExamples:\n\n# First, find the email and note its UID\n./scripts/email.js search --from \"newsletter@example.com\"\n# Output shows: UID: 12345\n\n# Move to Archive folder\n./scripts/email.js move 12345 \"Archive\"\n\n# Move to custom folder\n./scripts/email.js move 67890 \"Projects/Work\"\n\nError handling:\n\nIf folder doesn't exist, shows list of available folders\nValidates UID exists before attempting move"
      },
      {
        "title": "Help",
        "body": "./scripts/email.js help\n\nShows complete usage guide with all commands and examples."
      },
      {
        "title": "Daily Email Triage",
        "body": "# Check unread emails\n./scripts/email.js search --unseen --limit 10\n\n# Move newsletters to folder\n./scripts/email.js search --from \"newsletter@site.com\" --limit 1\n./scripts/email.js move <uid> \"Newsletters\""
      },
      {
        "title": "Find Specific Email",
        "body": "# Search by sender and subject\n./scripts/email.js search --from \"client@example.com\" --subject \"proposal\"\n\n# Search by date\n./scripts/email.js search --since \"Jan 20, 2026\" --subject \"meeting notes\""
      },
      {
        "title": "Archive Old Emails",
        "body": "# Find old read emails\n./scripts/email.js search --before \"Dec 1, 2025\" --seen --limit 50\n\n# Move each to Archive (use UID from output)\n./scripts/email.js move <uid> \"Archive\""
      },
      {
        "title": "Check for Attachments",
        "body": "# Read recent emails and see attachment info\n./scripts/email.js read 10\n\n# Search output automatically shows:\n# - Number of attachments\n# - Filename, type, and size for each"
      },
      {
        "title": "🔒 Security",
        "body": "Credentials never logged or stored in files\nTLS/SSL encryption for all connections\nApp Passwords recommended over account passwords\nNo data leaves your machine except IMAP/SMTP connections"
      },
      {
        "title": "⚙️ Configuration",
        "body": "Default configuration is optimized for Zoho Mail EU.\n\nTo use another provider, edit scripts/email.js:\n\n// SMTP Configuration\nconst smtpConfig = {\n  host: 'smtp.your-provider.com',\n  port: 465,  // or 587 for TLS\n  secure: true,  // true for SSL (465), false for TLS (587)\n  auth: {\n    user: EMAIL_USER,\n    pass: EMAIL_PASS\n  }\n};\n\n// IMAP Configuration\nconst imapConfig = {\n  imap: {\n    user: EMAIL_USER,\n    password: EMAIL_PASS,\n    host: 'imap.your-provider.com',\n    port: 993,\n    tls: true,\n    authTimeout: 20000\n  }\n};"
      },
      {
        "title": "🚀 Performance Notes",
        "body": "Body search (--body) can be slow on large mailboxes - use sparingly\nSubject/From search is fast - uses IMAP server-side filtering\nDate filters are efficient\nLimit results with --limit for faster responses"
      },
      {
        "title": "🐛 Troubleshooting",
        "body": "\"Authentication failed\"\n\nVerify EMAIL_USER and EMAIL_PASS are set correctly\nUse App Password, not account password\nCheck provider settings (2FA, less secure apps, etc.)\n\n\"Folder not found\"\n\nUse folders command to see exact folder names\nFolder names are case-sensitive\nSome providers use different names (e.g., \"Sent Items\" vs \"Sent\")\n\n\"Connection timeout\"\n\nCheck firewall/network settings\nVerify IMAP/SMTP ports are accessible\nTry increasing authTimeout in config\n\n\"No emails found\"\n\nCheck search criteria\nVerify emails exist in INBOX (not other folders)\nTry broader search (remove some filters)"
      },
      {
        "title": "v0.2.0 (Current)",
        "body": "✨ Advanced search with multiple filters\n📁 Folder management (list, move)\n📎 Attachment detection and info\n🎨 Improved output formatting\n📚 Comprehensive documentation"
      },
      {
        "title": "v0.1.0",
        "body": "Basic send/read functionality\nZoho Mail support\nIMAP/SMTP foundation"
      },
      {
        "title": "🤝 Compatibility",
        "body": "Tested with:\n\n✅ Zoho Mail (EU & US)\n✅ Gmail\n✅ Outlook/Hotmail\n✅ iCloud Mail\n✅ Custom IMAP/SMTP servers"
      },
      {
        "title": "💡 Tips",
        "body": "Use UIDs for automation: Save UIDs from search results to move emails programmatically\nCombine filters: Multiple filters create AND conditions for precise searches\nFolder organization: List folders first to plan your organization strategy\nDate format: Use natural language dates like \"Jan 1, 2026\" or \"December 25, 2025\"\nAttachment filtering: Look for \"Attachments: X\" in search output to find emails with files"
      },
      {
        "title": "📄 License",
        "body": "ISC - Use freely in your OpenClaw setup."
      }
    ],
    "body": "Email Manager Lite v0.2\n\nA fully self-contained email management skill for OpenClaw. Uses standard IMAP and SMTP protocols with zero external dependencies.\n\n✨ What's New in v0.2\n🔍 Advanced Search & Filters\nSearch by sender (--from)\nSearch by subject keywords (--subject)\nFilter by date range (--since, --before)\nFilter by read/unread status (--seen, --unseen)\nSearch in email body (--body, warning: can be slow)\n📁 Folder Management\nList all IMAP folders with folders command\nMove emails between folders with move command\nAutomatic validation of folder existence\n📎 Attachment Information\nAutomatic detection of attachments\nDisplay attachment details:\nFilename\nMIME type\nFile size (formatted KB/MB)\nShown in both read and search results\n🔧 Installation\ncd skills/portable-email-manager\nnpm install\n\n\nDependencies are bundled in package.json:\n\nnodemailer - SMTP email sending\nimap-simple - IMAP operations\nmailparser - Email parsing and attachment detection\n🔐 Credentials\n\nSet these environment variables:\n\nexport EMAIL_USER=\"your.email@domain.com\"\nexport EMAIL_PASS=\"your-app-password\"\n\n\nRecommended: Use App Passwords for Gmail, Outlook, Zoho instead of main password.\n\nProvider Setup\n\nZoho Mail (default):\n\nAlready configured for smtp.zoho.eu and imap.zoho.eu\nGenerate App Password: https://accounts.zoho.eu/home#security/apppasswords\n\nGmail:\n\nEdit scripts/email.js and change:\nhost: 'smtp.gmail.com'  // SMTP\nhost: 'imap.gmail.com'  // IMAP\n\nEnable 2FA and create App Password: https://myaccount.google.com/apppasswords\n\nOutlook/Hotmail:\n\nEdit to use smtp.office365.com / outlook.office365.com\nPort 587 for SMTP (TLS)\n📖 Usage\nSend Email\n./scripts/email.js send \"recipient@example.com\" \"Subject\" \"Email body text\"\n\n\nExample:\n\n./scripts/email.js send \"boss@company.com\" \"Weekly Report\" \"Attached is this week's summary.\"\n\nRead Recent Emails\n./scripts/email.js read [limit]\n\n\nExamples:\n\n# Read last 5 emails (default)\n./scripts/email.js read\n\n# Read last 20 emails\n./scripts/email.js read 20\n\n\nOutput includes:\n\nUID (unique ID for moving)\nFrom/To addresses\nSubject and date\nAttachment count and details\nEmail body preview (first 500 chars)\nAdvanced Search\n./scripts/email.js search [options]\n\n\nSearch Options:\n\nOption\tDescription\tExample\n--from <email>\tFilter by sender\t--from \"boss@company.com\"\n--subject <text>\tFilter by subject keywords\t--subject \"invoice\"\n--since <date>\tEmails after date\t--since \"Jan 1, 2026\"\n--before <date>\tEmails before date\t--before \"Feb 1, 2026\"\n--unseen\tOnly unread emails\t--unseen\n--seen\tOnly read emails\t--seen\n--body <text>\tSearch in body (slow!)\t--body \"meeting\"\n--limit <n>\tMax results\t--limit 10\n\nExamples:\n\n# Find unread emails from specific sender\n./scripts/email.js search --from \"client@example.com\" --unseen\n\n# Search by subject\n./scripts/email.js search --subject \"invoice\" --limit 5\n\n# Date range search\n./scripts/email.js search --since \"Jan 15, 2026\" --before \"Feb 1, 2026\"\n\n# Search in body (use sparingly - can be slow)\n./scripts/email.js search --body \"quarterly review\"\n\n# Combine multiple filters\n./scripts/email.js search --from \"boss@company.com\" --subject \"urgent\" --unseen --limit 3\n\nList Folders\n./scripts/email.js folders\n\n\nShows hierarchical tree of all IMAP folders with attributes.\n\nExample output:\n\n📁 INBOX\n📁 Sent\n📁 Archive\n📁 Drafts\n📁 Spam\n📁 Trash\n\nMove Email to Folder\n./scripts/email.js move <uid> <folder-name>\n\n\nImportant:\n\nGet the uid from read or search output\nFolder name is case-sensitive\nScript validates folder exists before moving\n\nExamples:\n\n# First, find the email and note its UID\n./scripts/email.js search --from \"newsletter@example.com\"\n# Output shows: UID: 12345\n\n# Move to Archive folder\n./scripts/email.js move 12345 \"Archive\"\n\n# Move to custom folder\n./scripts/email.js move 67890 \"Projects/Work\"\n\n\nError handling:\n\nIf folder doesn't exist, shows list of available folders\nValidates UID exists before attempting move\nHelp\n./scripts/email.js help\n\n\nShows complete usage guide with all commands and examples.\n\n🎯 Use Cases\nDaily Email Triage\n# Check unread emails\n./scripts/email.js search --unseen --limit 10\n\n# Move newsletters to folder\n./scripts/email.js search --from \"newsletter@site.com\" --limit 1\n./scripts/email.js move <uid> \"Newsletters\"\n\nFind Specific Email\n# Search by sender and subject\n./scripts/email.js search --from \"client@example.com\" --subject \"proposal\"\n\n# Search by date\n./scripts/email.js search --since \"Jan 20, 2026\" --subject \"meeting notes\"\n\nArchive Old Emails\n# Find old read emails\n./scripts/email.js search --before \"Dec 1, 2025\" --seen --limit 50\n\n# Move each to Archive (use UID from output)\n./scripts/email.js move <uid> \"Archive\"\n\nCheck for Attachments\n# Read recent emails and see attachment info\n./scripts/email.js read 10\n\n# Search output automatically shows:\n# - Number of attachments\n# - Filename, type, and size for each\n\n🔒 Security\nCredentials never logged or stored in files\nTLS/SSL encryption for all connections\nApp Passwords recommended over account passwords\nNo data leaves your machine except IMAP/SMTP connections\n⚙️ Configuration\n\nDefault configuration is optimized for Zoho Mail EU.\n\nTo use another provider, edit scripts/email.js:\n\n// SMTP Configuration\nconst smtpConfig = {\n  host: 'smtp.your-provider.com',\n  port: 465,  // or 587 for TLS\n  secure: true,  // true for SSL (465), false for TLS (587)\n  auth: {\n    user: EMAIL_USER,\n    pass: EMAIL_PASS\n  }\n};\n\n// IMAP Configuration\nconst imapConfig = {\n  imap: {\n    user: EMAIL_USER,\n    password: EMAIL_PASS,\n    host: 'imap.your-provider.com',\n    port: 993,\n    tls: true,\n    authTimeout: 20000\n  }\n};\n\n🚀 Performance Notes\nBody search (--body) can be slow on large mailboxes - use sparingly\nSubject/From search is fast - uses IMAP server-side filtering\nDate filters are efficient\nLimit results with --limit for faster responses\n🐛 Troubleshooting\n\n\"Authentication failed\"\n\nVerify EMAIL_USER and EMAIL_PASS are set correctly\nUse App Password, not account password\nCheck provider settings (2FA, less secure apps, etc.)\n\n\"Folder not found\"\n\nUse folders command to see exact folder names\nFolder names are case-sensitive\nSome providers use different names (e.g., \"Sent Items\" vs \"Sent\")\n\n\"Connection timeout\"\n\nCheck firewall/network settings\nVerify IMAP/SMTP ports are accessible\nTry increasing authTimeout in config\n\n\"No emails found\"\n\nCheck search criteria\nVerify emails exist in INBOX (not other folders)\nTry broader search (remove some filters)\n📝 Version History\nv0.2.0 (Current)\n✨ Advanced search with multiple filters\n📁 Folder management (list, move)\n📎 Attachment detection and info\n🎨 Improved output formatting\n📚 Comprehensive documentation\nv0.1.0\nBasic send/read functionality\nZoho Mail support\nIMAP/SMTP foundation\n🤝 Compatibility\n\nTested with:\n\n✅ Zoho Mail (EU & US)\n✅ Gmail\n✅ Outlook/Hotmail\n✅ iCloud Mail\n✅ Custom IMAP/SMTP servers\n💡 Tips\nUse UIDs for automation: Save UIDs from search results to move emails programmatically\nCombine filters: Multiple filters create AND conditions for precise searches\nFolder organization: List folders first to plan your organization strategy\nDate format: Use natural language dates like \"Jan 1, 2026\" or \"December 25, 2025\"\nAttachment filtering: Look for \"Attachments: X\" in search output to find emails with files\n📄 License\n\nISC - Use freely in your OpenClaw setup."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/jorgermp/email-manager-lite",
    "publisherUrl": "https://clawhub.ai/jorgermp/email-manager-lite",
    "owner": "jorgermp",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/email-manager-lite",
    "downloadUrl": "https://openagent3.xyz/downloads/email-manager-lite",
    "agentUrl": "https://openagent3.xyz/skills/email-manager-lite/agent",
    "manifestUrl": "https://openagent3.xyz/skills/email-manager-lite/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/email-manager-lite/agent.md"
  }
}