smtp-send

What This Skill Does

The smtp-send skill provides a robust and flexible interface for OpenClaw agents to send emails directly from the command line or through automation scripts. Whether you need to deliver simple text notifications, formatted HTML reports, or complex document batches with file attachments, this skill handles the heavy lifting. It supports dual-backend architecture, allowing you to choose between the high-performance Resend API or traditional SMTP servers like Gmail, Outlook, QQ, or 163 Mail. The skill is designed with a intelligent 'auto' provider mode that prioritizes modern API integration while maintaining a fallback mechanism to SMTP, ensuring your critical communications are delivered even if one service encounters an outage.

Installation

To integrate this email capability into your environment, use the OpenClaw management utility. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/xiwan/smtp-send

Once installed, create a configuration file at ~/.smtp_config. You can populate this file with your Resend API credentials, your SMTP server details, or both. For security, execute chmod 600 ~/.smtp_config to ensure that only your user account can read the sensitive credentials stored within.

Use Cases

• Automated Reporting: Have your agent generate a data analysis file and immediately email the summary to your stakeholders.
• System Alerts: Configure background scripts to notify you via email when a long-running process finishes or encounters an error.
• Communication Delegation: Use the agent to draft and send follow-up emails after meetings, using HTML templates to maintain brand consistency.
• Bulk Distribution: Simplify the process of sending personalized documents or reports by automating the attachment selection and distribution workflow.

Example Prompts

1. "Send an email to [email protected] with the subject 'Project Update' and attach the file 'report.pdf'."
2. "Could you send a message to [email protected] informing them about the deployment delay? Use an HTML format to list the specific issues in a table."
3. "Email the current log files to my support address using my configured SMTP account."

Tips & Limitations

• Authentication: When using traditional providers like Gmail, 163, or QQ, ensure you generate an 'App Password' or 'Authorization Code' instead of using your primary login password.
• Security: Never commit your ~/.smtp_config file to public version control systems. The file permissions should strictly remain 600.
• Resend Restrictions: If you are on a free Resend plan, you are restricted to sending emails only to your verified recipient email address until you verify your custom domain.
• Fallback: If you configure both providers, the system defaults to Resend first. If the API key is missing or the request fails, it seamlessly switches to the SMTP configuration defined in your settings.