| name | email |
| description | Email skill - Provides email sending, receiving, reading and management functions |
| license | Apache-2.0 |
| metadata | {"author":"OpenClaw","version":"1.0.0","tags":["email","mail","communication"]} |
Email Skill
Overview
This skill provides email functionality, supporting email sending, receiving, reading and management operations.
Scripts
send_email.sh
Send email to specified recipient.
to (string, required): Recipient email address
subject (string, required): Email subject
body (string, required): Email body content
from_addr (string, optional): Sender email address
attachments (JSON string, optional): Attachment file names list, e.g. '["report.pdf", "data.xlsx"]'
receive_email.sh
Get email list from specified folder.
limit (integer, optional, default: 10): Number of emails to return
folder (string, optional, default: inbox): Folder name
read_email.sh
Read single email details by ID.
email_id (string, required): Email ID
delete_email.sh
Delete specified email by ID.
email_id (string, required): Email ID
get_attachments.sh
Get email attachment information.
email_id (string, required): Email ID
Usage
./scripts/send_email.sh "user@example.com" "Subject" "Body"
./scripts/send_email.sh "user@example.com" "Subject" "Body" "sender@example.com" '["report.pdf"]'
./scripts/receive_email.sh 10 inbox
./scripts/read_email.sh "email_xxx"
./scripts/delete_email.sh "email_xxx"
./scripts/get_attachments.sh "email_xxx"
Return Format
Success Response
{
"success": true,
"data": { ... },
"message": "Operation successful"
}
Error Response
{
"success": false,
"error": "Error message",
"message": "Operation failed"
}
Script-specific Response Data
send_email.sh
- Success:
data contains the sent email object:
{
"id": "email_1234567890_abc123",
"from": "openclaw@example.com",
"to": "user@example.com",
"subject": "Subject",
"body": "Body content",
"cc": [],
"attachments": [
{"name": "report.pdf", "size": 102400}
],
"timestamp": "2025-04-01T12:00:00Z",
"folder": "sent",
"read": true
}
receive_email.sh
- Success:
data contains an array of email objects (without body field):
[
{
"id": "email_1234567890_abc123",
"from": "sender@example.com",
"to": "openclaw@example.com",
"subject": "Email Subject",
"timestamp": "2025-04-01T12:00:00Z",
"folder": "inbox",
"read": false
}
]
Note: The body field is excluded from the list view for efficiency. Use read_email.sh to get the full email content including body.
read_email.sh
- Success:
data contains the full email object:
{
"id": "email_1234567890_abc123",
"from": "sender@example.com",
"to": "openclaw@example.com",
"subject": "Email Subject",
"body": "Email body content",
"cc": [],
"timestamp": "2025-04-01T12:00:00Z",
"folder": "inbox",
"read": true
}
delete_email.sh
get_attachments.sh
- Success:
data contains an array of attachments (currently empty array):
[]