# Send Send Email 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": "send-email-2",
    "name": "Send Email",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/wangyendt/send-email-2",
    "canonicalUrl": "https://clawhub.ai/wangyendt/send-email-2",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/send-email-2",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=send-email-2",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "assets/report-summary.html",
      "assets/simple-notification.html",
      "references/smtp-servers.md",
      "requirements.txt",
      "scripts/send_email.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "send-email-2",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T07:09:31.788Z",
      "expiresAt": "2026-05-08T07:09:31.788Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=send-email-2",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=send-email-2",
        "contentDisposition": "attachment; filename=\"send-email-2-0.1.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "send-email-2"
      },
      "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/send-email-2"
    },
    "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/send-email-2",
    "downloadUrl": "https://openagent3.xyz/downloads/send-email-2",
    "agentUrl": "https://openagent3.xyz/skills/send-email-2/agent",
    "manifestUrl": "https://openagent3.xyz/skills/send-email-2/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/send-email-2/agent.md"
  }
}
```
## Documentation

### Send Email

Send emails via SMTP using Python with support for plain text, HTML formatting, file attachments, and template-based emails.

### Key Features

Default Sender Email: Automatically uses agent_skill_test@126.com when no sender is specified
Automatic Markdown to HTML: Detects Markdown content and converts to beautifully styled HTML
Multiple Email Providers: Supports Gmail, Outlook, QQ Mail, 163/126 Mail, and custom SMTP
File Attachments: Attach multiple files to emails
Email Templates: Use template files with variable substitution

### Interactive Email Sending Flow

This skill guides you through the email sending process step by step.

### Step 1: Collect Basic Email Information

Ask the user for the following required information. If any is missing, prompt the user to provide it:

InformationDescriptionExampleRecipient (--to)Email address to send touser@example.comSubject (--subject)Email subject lineMonthly ReportContent (--content)Email body text or HTMLHello, here is your report.

IMPORTANT - Default Sender Email Behavior:

If the user does NOT specify a sender email in their initial request, AUTOMATICALLY use agent_skill_test@126.com as the default sender. DO NOT ask the user which email to send from.

Only ask the user for a different sender email if they explicitly mention wanting to use their own email address.

When using the default agent_skill_test@126.com, proceed directly to Step 2 and ask for the 126 email authorization code.

### Step 2: Identify Email Provider and Collect Credentials

Based on the sender's email address domain, identify the email provider and request the appropriate credentials.

Email Provider Detection

@gmail.com, @googlemail.com   → Gmail
@outlook.com, @hotmail.com, @live.com, @office365.com → Outlook/Office 365
@qq.com, @vip.qq.com          → QQ Mail
@163.com, @126.com            → NetEase Mail
@aliyun.com, @aliyun-inc.com  → Aliyun Mail
@sendgrid.net, @*.sendgrid.net → SendGrid
@*.mailgun.org                → Mailgun
Other domains                  → Custom SMTP (ask for server, port, username, password)

Provider-Specific Credential Requirements

Gmail (@gmail.com, @googlemail.com)

Password Type: App Password (NOT account password)
Prerequisite: Two-factor authentication (2FA) must be enabled
How to get App Password:

Go to https://myaccount.google.com/apppasswords
Sign in to your Google Account
Select "Mail" and "Other (Custom name)" → Enter a name like "SMTP Script"
Click "Generate" → Copy the 16-character password


SMTP Server: smtp.gmail.com
Port: 587 (TLS) or 465 (SSL)
Username: Your full Gmail address

Outlook / Office 365 (@outlook.com, @hotmail.com, @live.com, @office365.com)

Password Type: Account password (same as web login)
SMTP Server: smtp.office365.com
Port: 587 (TLS)
Username: Your full Outlook/Office 365 email address

QQ Mail (@qq.com, @vip.qq.com)

Password Type: SMTP Authorization Code (NOT account password)
How to get Authorization Code:

Login to QQ Mail at https://mail.qq.com
Click "Settings" (设置) → "Account" (账户)
Find "POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV Service"
Open "POP3/SMTP Service" or "IMAP/SMTP Service"
Click "Generate Authorization Code" (生成授权码)
Verify identity via SMS → Copy the generated code


SMTP Server: smtp.qq.com
Port: 587 (TLS) or 465 (SSL)
Username: Your full QQ email address

NetEase 163 Mail (@163.com)

Password Type: SMTP Authorization Code (NOT account password)
How to get Authorization Code:

Login to 163 Mail at https://mail.163.com
Click "Settings" (设置) → "POP3/SMTP/IMAP"
Click "Open" next to "IMAP/SMTP Service"
Verify identity → Click "Get Authorization Code" (获取授权码)
Copy the 16-character authorization code


SMTP Server: smtp.163.com
Port: 465 (SSL) or 994 (IMAP)
Username: Your full 163 email address

NetEase 126 Mail (@126.com)

Password Type: SMTP Authorization Code (NOT account password)
How to get Authorization Code:

Login to 126 Mail at https://mail.126.com
Click "Settings" (设置) → "POP3/SMTP/IMAP"
Enable "IMAP/SMTP Service"
Copy the authorization password displayed


SMTP Server: smtp.126.com
Port: 465 (SSL) or 25 (SSL)
Username: Your full 126 email address

SendGrid

Password Type: API Key (as password)
How to get API Key:

Login to SendGrid at https://app.sendgrid.com
Go to Settings → API Keys
Click "Create API Key"
Set permissions → Click "Create & View"
Copy the API key (only shown once)


SMTP Server: smtp.sendgrid.net
Port: 587 (TLS) or 465 (SSL)
Username: apikey (literally this string)

Mailgun

Password Type: SMTP credentials from dashboard
How to get Credentials:

Login to Mailgun at https://app.mailgun.com
Go to Sending → Domains
Select your domain
Copy SMTP username and password from the page


SMTP Server: smtp.mailgun.org
Port: 587 (TLS)
Username: From Mailgun dashboard

Custom SMTP (Other domains)
Ask the user to provide:

SMTP Server Address
SMTP Port
Username
Password

### Step 3: Auto-detect and Handle Markdown Content

The script automatically detects if the email content is in Markdown format by looking for common patterns:

Headers (#, ##, ###)
Bold/italic text (**bold**, *italic*)
Lists (- item or 1. item)
Code blocks (\`\`\`)
Links ([text](url))

If Markdown is detected, the content is automatically converted to beautifully styled HTML with:

Professional typography and spacing
Color-coded headers
Styled tables and code blocks
Responsive design for email clients

You don't need to manually specify --content-type html for Markdown content - it's handled automatically!

### Step 4: Collect Optional Information (if needed)

--from-name: Display name for sender (e.g., "John Doe")
--content-type html: For HTML formatted emails (defaults to plain text, but auto-converts Markdown)
--attach: File path(s) to attach (can specify multiple)
--template: Use template file instead of content
--template-vars: JSON string of template variables

### Step 5: Confirm and Send

Before sending, confirm with the user:

Ready to send:
From: [Sender Email]
To: [Recipient Email]
Subject: [Subject]
Content Type: [Plain/HTML]
Attachments: [List of attachments or None]

Proceed to send? (y/n)

If confirmed, execute the send_email.py script with all collected parameters.

### Example 1: Basic Gmail Email

User: Send an email to john@example.com with subject "Hello"

Skill: I can help you send that email. I need a few more details:

Content: What should the email body contain?
Sender Email: What email address should I send from?

User: The content is "Hi John, just saying hello!" and send from myemail@gmail.com

Skill: I detected you're using Gmail. For Gmail, you need an App Password (not your regular password).

To get your App Password:

Go to https://myaccount.google.com/apppasswords
Sign in and create an App Password for "Mail"
Copy the 16-character password

Please provide your Gmail App Password:

User: abcd efgh ijkl mnop

Skill: Ready to send:

From: myemail@gmail.com
To: john@example.com
Subject: Hello
Content: Hi John, just saying hello!

Proceed to send? (y/n)

### Example 2: Markdown Content with Default Sender

User: 发一封邮件给 manager@company.com,主题是"AR眼镜行业分析",内容是 [用户提供的 Markdown 报告]

Skill: 我来帮您发送这封邮件。检测到您没有指定发件人邮箱,我将使用默认邮箱 agent_skill_test@126.com 发送。

同时,我发现您的内容是 Markdown 格式,将自动转换为美观的 HTML 格式,让报告更易读。

为了使用 126 邮箱发送,我需要您提供 SMTP 授权码。

获取授权码步骤:

登录 126 邮箱 → 设置 → POP3/SMTP/IMAP
启用 "IMAP/SMTP 服务"
复制显示的授权密码

请提供 agent_skill_test@126.com 的授权码:

User: [提供授权码]

Skill: 准备发送邮件:

发件人: agent_skill_test@126.com
收件人: manager@company.com
主题: AR眼镜行业分析
格式: Markdown → HTML (自动转换)
内容预览: 包含标题、列表、表格等格式化内容

确认发送? (y/n)

### Example 3: Default Sender with Missing Content

User: 发邮件给 user@company.com，主题是项目报告

Skill: 我需要收集邮件内容：

邮件正文是什么？

User: 项目已完成，所有里程碑都已达成。

Skill: 我将使用默认邮箱 agent_skill_test@126.com 发送。

为了使用 126 邮箱发送，我需要您提供 SMTP 授权码。

获取授权码步骤：

登录 126 邮箱 → 设置 → POP3/SMTP/IMAP
启用 "IMAP/SMTP 服务"
复制显示的授权密码

请提供 agent_skill_test@126.com 的授权码：

User: [提供授权码]

Skill: 准备发送邮件：

发件人: agent_skill_test@126.com
收件人: user@company.com
主题: 项目报告
内容: 项目已完成，所有里程碑都已达成。

确认发送？(y/n)

### Example 4: User Specifies Custom Sender Email

User: Send a report to boss@company.com from myname@outlook.com about Q4 results, with attachment /home/user/q4_report.pdf

Skill: I'll help you send that email. Please provide the email content:

What should the email say about the Q4 results?

User: Please find attached the Q4 financial report. Let me know if you have any questions.

Skill: I see you're using Outlook. You'll need your Outlook account password (same as web login).

Please provide your Outlook password:

User: mypassword123

Skill: Ready to send:

From: myname@outlook.com
To: boss@company.com
Subject: Q4 results
Content: Please find attached the Q4 financial report. Let me know if you have any questions.
Attachment: /home/user/q4_report.pdf

Proceed to send? (y/n)

### Example 5: Custom SMTP

User: Send email to test@domain.com from my@domain.com

Skill: I need to gather some information:

Subject: What is the email subject?
Content: What is the email body?

User: Subject is Test Email, content is Hello World

Skill: Since you're using a custom domain (my@domain.com), I'll need your SMTP configuration:

SMTP Server: What is your SMTP server address?
SMTP Port: What port should I use?
Username: What is your SMTP username?
Password: What is your SMTP password?

User: Server is smtp.mydomain.com, port 587, username is my@domain.com, password is secret

Skill: Ready to send:

From: my@domain.com
To: test@domain.com
Subject: Test Email
Content: Hello World
SMTP Server: smtp.mydomain.com:587

Proceed to send? (y/n)

### Script Command Reference

Once all information is collected, execute the script with appropriate parameters:

### Basic Command

python3 scripts/send_email.py \\
  --to recipient@example.com \\
  --subject "Email Subject" \\
  --content "Email body content" \\
  --smtp-server smtp.gmail.com \\
  --smtp-port 587 \\
  --username your@email.com \\
  --password your-password-or-app-password

### HTML Email

python3 scripts/send_email.py \\
  --to recipient@example.com \\
  --subject "Email Subject" \\
  --content "<h1>Hello</h1><p>HTML content</p>" \\
  --content-type html \\
  --smtp-server smtp.gmail.com \\
  --smtp-port 587 \\
  --username your@email.com \\
  --password your-password

### Email with Attachments

python3 scripts/send_email.py \\
  --to recipient@example.com \\
  --subject "Email Subject" \\
  --content "Email body" \\
  --attach /path/to/file1.pdf \\
  --attach /path/to/file2.csv \\
  --smtp-server smtp.gmail.com \\
  --smtp-port 587 \\
  --username your@email.com \\
  --password your-password

### Email with Template

python3 scripts/send_email.py \\
  --to recipient@example.com \\
  --subject "Email Subject" \\
  --template assets/simple-notification.html \\
  --template-vars '{"title":"Notification","message":"Your report is ready!"}' \\
  --content-type html \\
  --smtp-server smtp.gmail.com \\
  --smtp-port 587 \\
  --username your@email.com \\
  --password your-password

### SSL Connection (instead of TLS)

python3 scripts/send_email.py \\
  --to recipient@example.com \\
  --subject "Email Subject" \\
  --content "Email body" \\
  --smtp-server smtp.gmail.com \\
  --smtp-port 465 \\
  --use-ssl \\
  --username your@email.com \\
  --password your-password

### SMTP Server Configuration Reference

ProviderSMTP ServerPortEncryptionPassword TypeUsernameGmailsmtp.gmail.com587TLSApp PasswordFull emailGmailsmtp.gmail.com465SSLApp PasswordFull emailOutlooksmtp.office365.com587TLSAccount PasswordFull emailQQ Mailsmtp.qq.com587TLSAuthorization CodeFull emailQQ Mailsmtp.qq.com465SSLAuthorization CodeFull email163 Mailsmtp.163.com465SSLAuthorization CodeFull email163 Mailsmtp.163.com994SSLAuthorization CodeFull email126 Mailsmtp.126.com465SSLAuthorization CodeFull email126 Mailsmtp.126.com25SSLAuthorization CodeFull emailSendGridsmtp.sendgrid.net587TLSAPI KeyapikeySendGridsmtp.sendgrid.net465SSLAPI KeyapikeyMailgunsmtp.mailgun.org587TLSSMTP PasswordFrom dashboard

### Installation

Before using this skill, install the required Python dependencies:

pip install -r requirements.txt

This installs the markdown library (version ≥3.4.0) which is required for automatic Markdown to HTML conversion.

### scripts/send_email.py

Main Python script for sending emails. Supports:

Plain text and HTML content
Multiple file attachments
Email templates with variable substitution
TLS and SSL encryption
Custom sender names

### references/smtp-servers.md

Common SMTP server configurations including Gmail, Outlook, 126, QQ, 163, SendGrid, Mailgun, and Aliyun.

### assets/

Email templates:

simple-notification.html - Basic notification template
report-summary.html - Professional report template with metrics grid
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: wangyendt
- Version: 0.1.1
## 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-05-01T07:09:31.788Z
- Expires at: 2026-05-08T07:09:31.788Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/send-email-2)
- [Send to Agent page](https://openagent3.xyz/skills/send-email-2/agent)
- [JSON manifest](https://openagent3.xyz/skills/send-email-2/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/send-email-2/agent.md)
- [Download page](https://openagent3.xyz/downloads/send-email-2)