Gmail Sender Skill

Send emails via Gmail SMTP using Google App Password. Generic utility for alerts, notifications, and automated reports.

Overview

A simple CLI tool to send emails through Gmail SMTP. No external dependencies beyond Python standard library.

Requirements

• Python 3.6+
• Gmail account with App Password enabled

Setup

1. Enable 2-Factor Authentication on your Google Account:

   • Go to https://myaccount.google.com/security

2. Generate an App Password:

   • Go to https://myaccount.google.com/apppasswords
   • Select "Mail" as the app
   • Copy the 16-character password (no spaces)

3. Set environment variables:

export GMAIL_USER="your-email@gmail.com"
export GMAIL_APP_PASSWORD="xxxxxxxxxxxxxxxx"

Installation

Clone or copy this skill to your OpenClaw skills directory:

cp -r gmail-sender ~/.openclaw/workspace/skills/

Or use the CLI:

clawhub install gmail-sender

Usage

# Make executable
chmod +x gmail-send

# Send email
./gmail-send "recipient@example.com" "Subject" "Body text"

Examples

# Simple notification
./gmail-send "admin@example.com" "Server Alert" "CPU usage at 90%"

# Cron job integration
0 9 * * 1-5 ~/.openclaw/scripts/gmail-send "you@example.com" "Morning Report" "$(date)"

Python Module Usage

import subprocess

# Call from Python
subprocess.run([
    './gmail-send',
    'recipient@example.com',
    'Subject',
    'Body'
], env={'GMAIL_USER': '...', 'GMAIL_APP_PASSWORD': '...'})

Security Notes

• Never commit App Passwords to version control
• Use environment variables, never hardcode credentials
• App Passwords are 16 characters (format: xxxx xxxx xxxx xxxx)
• Revoke app passwords if compromised

Troubleshooting

"535 5.7.8 Username and Password not accepted"

• Verify App Password is correct (16 chars, no spaces)
• Make sure 2FA is enabled on your Google account

"Could not connect"

• Check firewall/network settings
• Gmail may block connections from unknown apps

License

MIT

Author

junkaixue