{
  "schemaVersion": "1.0",
  "item": {
    "slug": "email-skill",
    "name": "Email",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/awspace/email-skill",
    "canonicalUrl": "https://clawhub.ai/awspace/email-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/email-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=email-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "config_template.json",
      "email_sender.py",
      "openclaw_integration.md",
      "requirements.txt"
    ],
    "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-skill"
    },
    "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-skill",
    "agentPageUrl": "https://openagent3.xyz/skills/email-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/email-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/email-skill/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 📧",
        "body": "Email management and automation with attachment support."
      },
      {
        "title": "Features",
        "body": "Send emails with attachments\nSupport for multiple email providers (Gmail, Outlook, Yahoo, etc.)\nHTML and plain text email support\nCC and BCC recipients\nTest email functionality\nSecure TLS/SSL connections"
      },
      {
        "title": "1. Configure Email Credentials",
        "body": "Create a configuration file email_config.json in your workspace:\n\n{\n  \"smtp_server\": \"smtp.gmail.com\",\n  \"smtp_port\": 587,\n  \"username\": \"your-email@gmail.com\",\n  \"password\": \"your-app-password\",\n  \"sender_name\": \"OpenClaw Assistant\",\n  \"use_tls\": true,\n  \"use_ssl\": false\n}"
      },
      {
        "title": "2. For Gmail Users (Recommended)",
        "body": "Enable 2-factor authentication on your Google account\nGenerate an App Password:\n\nGo to https://myaccount.google.com/security\nUnder \"Signing in to Google,\" select \"App passwords\"\nGenerate a new app password for \"Mail\"\nUse this 16-character password in your config"
      },
      {
        "title": "3. Alternative: Environment Variables",
        "body": "Set these environment variables instead of using a config file:\n\n# Windows\nset SMTP_SERVER=smtp.gmail.com\nset SMTP_PORT=587\nset EMAIL_USERNAME=your-email@gmail.com\nset EMAIL_PASSWORD=your-app-password\nset EMAIL_SENDER_NAME=\"OpenClaw Assistant\"\n\n# macOS/Linux\nexport SMTP_SERVER=smtp.gmail.com\nexport SMTP_PORT=587\nexport EMAIL_USERNAME=your-email@gmail.com\nexport EMAIL_PASSWORD=your-app-password\nexport EMAIL_SENDER_NAME=\"OpenClaw Assistant\""
      },
      {
        "title": "Send a Simple Email",
        "body": "python email_sender.py --to \"recipient@example.com\" --subject \"Hello\" --body \"This is a test email\""
      },
      {
        "title": "Send Email with Attachment",
        "body": "python email_sender.py --to \"recipient@example.com\" --subject \"Report\" --body \"Please find attached\" --attachment \"report.pdf\" --attachment \"data.xlsx\""
      },
      {
        "title": "Send Test Email",
        "body": "python email_sender.py --to \"your-email@gmail.com\" --test"
      },
      {
        "title": "Using with OpenClaw Commands",
        "body": "\"Send email to recipient@example.com with subject Meeting Notes and body Here are the notes from today's meeting\"\n\"Send test email to verify configuration\"\n\"Email the report.pdf file to team@company.com\""
      },
      {
        "title": "Supported Email Providers",
        "body": "ProviderSMTP ServerPortTLSGmailsmtp.gmail.com587YesOutlook/Office365smtp.office365.com587YesYahoosmtp.mail.yahoo.com587YesQQ Mailsmtp.qq.com587YesCustom SMTPyour.smtp.server.com587/465As configured"
      },
      {
        "title": "Python API Usage",
        "body": "from email_sender import EmailSender\n\n# Initialize with config file\nsender = EmailSender(\"email_config.json\")\n\n# Send email with attachment\nresult = sender.send_email(\n    to_email=\"recipient@example.com\",\n    subject=\"Important Document\",\n    body=\"Please review the attached document.\",\n    attachments=[\"document.pdf\", \"data.csv\"]\n)\n\nif result[\"success\"]:\n    print(f\"Email sent with {result['attachments']} attachments\")\nelse:\n    print(f\"Error: {result['error']}\")"
      },
      {
        "title": "Common Issues:",
        "body": "Authentication Failed\n\nVerify your username and password\nFor Gmail: Use app password instead of regular password\nCheck if 2FA is enabled\n\n\n\nConnection Refused\n\nVerify SMTP server and port\nCheck firewall settings\nTry different port (465 for SSL)\n\n\n\nAttachment Too Large\n\nMost providers limit attachments to 25MB\nConsider compressing files or using cloud storage links"
      },
      {
        "title": "Security Notes",
        "body": "Never commit email credentials to version control\nUse environment variables for production deployments\nRegularly rotate app passwords\nConsider using dedicated email accounts for automation"
      }
    ],
    "body": "Email 📧\n\nEmail management and automation with attachment support.\n\nFeatures\nSend emails with attachments\nSupport for multiple email providers (Gmail, Outlook, Yahoo, etc.)\nHTML and plain text email support\nCC and BCC recipients\nTest email functionality\nSecure TLS/SSL connections\nSetup Instructions\n1. Configure Email Credentials\n\nCreate a configuration file email_config.json in your workspace:\n\n{\n  \"smtp_server\": \"smtp.gmail.com\",\n  \"smtp_port\": 587,\n  \"username\": \"your-email@gmail.com\",\n  \"password\": \"your-app-password\",\n  \"sender_name\": \"OpenClaw Assistant\",\n  \"use_tls\": true,\n  \"use_ssl\": false\n}\n\n2. For Gmail Users (Recommended)\nEnable 2-factor authentication on your Google account\nGenerate an App Password:\nGo to https://myaccount.google.com/security\nUnder \"Signing in to Google,\" select \"App passwords\"\nGenerate a new app password for \"Mail\"\nUse this 16-character password in your config\n3. Alternative: Environment Variables\n\nSet these environment variables instead of using a config file:\n\n# Windows\nset SMTP_SERVER=smtp.gmail.com\nset SMTP_PORT=587\nset EMAIL_USERNAME=your-email@gmail.com\nset EMAIL_PASSWORD=your-app-password\nset EMAIL_SENDER_NAME=\"OpenClaw Assistant\"\n\n# macOS/Linux\nexport SMTP_SERVER=smtp.gmail.com\nexport SMTP_PORT=587\nexport EMAIL_USERNAME=your-email@gmail.com\nexport EMAIL_PASSWORD=your-app-password\nexport EMAIL_SENDER_NAME=\"OpenClaw Assistant\"\n\nUsage Examples\nSend a Simple Email\npython email_sender.py --to \"recipient@example.com\" --subject \"Hello\" --body \"This is a test email\"\n\nSend Email with Attachment\npython email_sender.py --to \"recipient@example.com\" --subject \"Report\" --body \"Please find attached\" --attachment \"report.pdf\" --attachment \"data.xlsx\"\n\nSend Test Email\npython email_sender.py --to \"your-email@gmail.com\" --test\n\nUsing with OpenClaw Commands\n\"Send email to recipient@example.com with subject Meeting Notes and body Here are the notes from today's meeting\"\n\"Send test email to verify configuration\"\n\"Email the report.pdf file to team@company.com\"\n\nSupported Email Providers\nProvider\tSMTP Server\tPort\tTLS\nGmail\tsmtp.gmail.com\t587\tYes\nOutlook/Office365\tsmtp.office365.com\t587\tYes\nYahoo\tsmtp.mail.yahoo.com\t587\tYes\nQQ Mail\tsmtp.qq.com\t587\tYes\nCustom SMTP\tyour.smtp.server.com\t587/465\tAs configured\nPython API Usage\nfrom email_sender import EmailSender\n\n# Initialize with config file\nsender = EmailSender(\"email_config.json\")\n\n# Send email with attachment\nresult = sender.send_email(\n    to_email=\"recipient@example.com\",\n    subject=\"Important Document\",\n    body=\"Please review the attached document.\",\n    attachments=[\"document.pdf\", \"data.csv\"]\n)\n\nif result[\"success\"]:\n    print(f\"Email sent with {result['attachments']} attachments\")\nelse:\n    print(f\"Error: {result['error']}\")\n\nTroubleshooting\nCommon Issues:\n\nAuthentication Failed\n\nVerify your username and password\nFor Gmail: Use app password instead of regular password\nCheck if 2FA is enabled\n\nConnection Refused\n\nVerify SMTP server and port\nCheck firewall settings\nTry different port (465 for SSL)\n\nAttachment Too Large\n\nMost providers limit attachments to 25MB\nConsider compressing files or using cloud storage links\nSecurity Notes\nNever commit email credentials to version control\nUse environment variables for production deployments\nRegularly rotate app passwords\nConsider using dedicated email accounts for automation"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/awspace/email-skill",
    "publisherUrl": "https://clawhub.ai/awspace/email-skill",
    "owner": "awspace",
    "version": "0.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/email-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/email-skill",
    "agentUrl": "https://openagent3.xyz/skills/email-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/email-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/email-skill/agent.md"
  }
}