send-email

# 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`**:

```json
"skills": {
  "entries": {
    "send-email": {
      "enabled": true,
      "env": {
        "EMAIL_SMTP_SERVER": "smtp.163.com",
        "EMAIL_SMTP_PORT": "465",
        "EMAIL_SENDER": "your-email@163.com",
        "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) |

## Agent instructions

1. **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.
2. **Send mail**: Run the script under **workspace** (do not use the path under node_modules):
   ```bash
   python3 ~/.openclaw/workspace/skills/send-email/send_email.py "recipient" "Subject" "Body"
   ```
3. **Attachment**: `python3 ~/.openclaw/workspace/skills/send-email/send_email.py "recipient" "Subject" "Body" "/path/to/file.pdf"`

## Usage examples

```bash
python3 ~/.openclaw/workspace/skills/send-email/send_email.py 'recipient@example.com' 'Subject' 'Body text'
python3 ~/.openclaw/workspace/skills/send-email/send_email.py 'recipient@example.com...

# Send Email Skill

OpenClaw skill for sending emails via SMTP using the Python script. Credentials are read from `openclaw.json` → `skills.entries.send-email.env` (no ~/.msmtprc required).

## Features

- ✅ Support for 163, Gmail, QQ, and other SMTP providers
- ✅ Python script with env from openclaw.json
- ✅ Attachment support
- ✅ No ~/.msmtprc or manual SMTP file config needed

## Installation

Place this skill in `workspace/skills/send-email/`. It is then available to the agent.

## Configuration

Configure SMTP in `~/.openclaw/openclaw.json`:

```json
{
  "skills": {
    "entries": {
      "send-email": {
        "enabled": true,
        "env": {
          "EMAIL_SMTP_SERVER": "smtp.163.com",
          "EMAIL_SMTP_PORT": "465",
          "EMAIL_SENDER": "your-email@163.com",
          "EMAIL_SMTP_PASSWORD": "YOUR_AUTH_CODE"
        }
      }
    }
  }
}
```

The agent runs `python3 {baseDir}/send_email.py`; OpenClaw injects these env vars at runtime.

## Usage

The agent sends mail by running:

```bash
python3 {baseDir}/send_email.py "recipient@example.com" "Subject" "Body text"
```

With attachment:

```bash
python3 {baseDir}/send_email.py "recipient@example.com" "Subject" "Body" "/path/to/file.pdf"
```

Example prompts:
- "Send an email to user@example.com with subject 'Hello' and body 'Test message'"
- "Email the report.pdf to manager@company.com"