--- name: smtp-sender description: A skill to send emails with support for markdown, HTML text, and attachments, leveraging existing SMTP configuration in {skill~}/smtp-config.json. Includes retry logic and logging. ---

Custom SMTP Sender

Custom skill to send emails with advanced options including HTML/Markdown conversion, attachments, and retry handling. Integrates existing configuration, ensuring secure and reliable operations.

Features

• HTML/Markdown support: Compose emails using markdown converted to HTML.
• Attachments: Include one or more files easily.
• Retries: Attempts to resend in case of temporary failures.
• Logging: Maintains a log of sent emails and errors for auditing.

Prerequisites

• SMTP Configuration File: smtp-config.json located at ~skill/smtp-config.json

Example:

{
  "server": "smtp.exmail.qq.com",
  "port": 465,
  "username": "[email protected]",
  "password": "your-password",
  "emailFrom": "[email protected]",
  "useTLS": true
}

Ensure file permissions are secured (chmod 600).

Usage

Send a basic email:

python3 ~/.openclaw/workspace/skills/smtp-sender/email_sender.py --to "[email protected]" --subject "Hello" --body "你好"

Send an HTML email with an attachment:

python3 ~/.openclaw/workspace/skills/smtp-sender/email_sender.py \
  --to "[email protected]" \
  --subject "Weekly Report" \
  --body "**Important updates inside.** See attached." \
  --html \
  --attachments path/to/file.pdf

Error Handling

The tool retries up to 3 times on failure, logging each attempt. Networking or credential issues are reported in detail.

Future Expansion

• Support for CC/BCC fields
• Scheduling emails (cron integration)
• Email templates

Set up your SMTP-service once, and you’re ready to integrate email into your workflow!