smtp-sender

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.

leonard.w@xlbbb-cn

Install

openclaw skills install @xlbbb-cn/smtp-sender

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:

json

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

Ensure file permissions are secured (chmod 600).

Usage

Send a basic email:

bash

python3 ~/.openclaw/workspace/skills/smtp-sender/email_sender.py --to "recipient@example.com" --subject "Hello" --body "你好"

Send an HTML email with an attachment:

bash

python3 ~/.openclaw/workspace/skills/smtp-sender/email_sender.py \
  --to "recipient@example.com" \
  --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!