send-email

Send emails via SMTP using a local Python script with SMTP credentials provided through runtime-injected environment variables. Supports specifying recipient, subject, body, and an optional attachment path without exposing secrets in tool output.

SafeCommunicationfontStepv1.0.1

View on ClawHub

Use Cases

Send automated status updates or alerts from an agent workflow to a specified email recipient
Email a generated report (optionally as a PDF attachment) after a task completes
Notify support or operations teams when an incident condition is detected
Send confirmation emails for completed internal processes (e.g., backups, deployments)

smtpemailnotificationpythonautomationattachmentgmailqq163

Send Email

Send emails via the Python script. SMTP settings are injected by OpenClaw at runtime when the script runs (from ~/.openclaw/openclaw.json → skills.entries.send-email.env). Do not read any config file (e.g. ~/.openclaw/openclaw.json or workspace/openclaw.json) — that would expose credentials in tool output. Just run the script; env is injected automatically. Do not use ~/.msmtprc.

Configuration

Configure in ~/.openclaw/openclaw.json:

"skills": { "entries": { "send-email": { "enabled": true, "env": { "EMAIL_SMTP_SERVER": "smtp.163.com", "EMAIL_SMTP_PORT": "465", "EMAIL_SENDER": "[email protected]", "EMAIL_SMTP_PASSWORD": "YOUR_AUTH_CODE" } } } }

Variable	Description
EMAIL_SMTP_SERVER	SMTP server, e.g. smtp.163.com, smtp.gmail.com
EMAIL_SMTP_PORT	Port, 465 (SSL) or 587 (TLS)
EMAIL_SENDER	Sender email address
EMAIL_SMTP_PASSWORD	Authorization code / app password (163/QQ: auth code; Gmail: App Password)

Variable

Description

EMAIL_SMTP_SERVER

SMTP server, e.g. smtp.163.com, smtp.gmail.com

EMAIL_SMTP_PORT

Port, 465 (SSL) or 587 (TLS)

EMAIL_SENDER

Sender email address

EMAIL_SMTP_PASSWORD

Authorization code / app password (163/QQ: auth code; Gmail: App Password)

Agent instructions

Credentials: Never read config files. OpenClaw injects skills.entries.send-email.env when the script runs — do not use the read tool on ~/.openclaw/openclaw.json or workspace/openclaw.json (exposes secrets). If the skill is enabled, assume env is configured; do not ask the user for passwords. Do not use ~/.msmtprc.

Send mail: Run the script under workspace (do not use the path under node_modules):

python3 ~/.openclaw/workspace/skills/send-email/send_email.py "recipient" "Subject" "Body"

Attachment: python3 ~/.openclaw/workspace/skills/send-email/send_email.py "recipient" "Subject" "Body" "/path/to/file.pdf"

python3 ~/.openclaw/workspace/skills/send-email/send_email.py '[email protected]' 'Subject' 'Body text' python3 ~/.openclaw/workspace/skills/send-email/send_email.py '[email protected]' 'Subject' 'Body' '/path/to/file.pdf'

send-email

Use Cases

Send Email

Configuration

Agent instructions

Usage examples

SMTP reference

Troubleshooting