Email Skill

Description: Use this skill to send and read emails (IMAP/SMTP). Designed for Zoho Mail but configurable.

Capabilities: email.send, email.search

Tools

email.send

Send an email to one or more recipients.

Parameters:

• to (string, required): Comma-separated list of recipients.
• subject (string, required): The email subject.
• body (string, required): The email body (HTML or plain text).
• cc (string, optional): CC recipients.
• bcc (string, optional): BCC recipients.

email.search

Search for emails in the inbox.

Parameters:

• query (string, required): Search query (e.g. from:example.com, subject:Invoice).
• limit (number, optional): Max results (default 10).
• markRead (boolean, optional): Mark as read after fetching (default false).

Configuration (NO HARDCODED SECRETS)

This skill must not contain credentials.

It loads secrets from either:

1) A JSON file at %OPENCLAW_SECRETS_DIR%/email-tool.json (recommended), or

2) Environment variables (fallback).

Required keys:

• EMAIL_USER
• EMAIL_PASS

Optional (defaults shown):

• HOST_IMAP (imap.zoho.com)
• PORT_IMAP (993)
• HOST_SMTP (smtp.zoho.com)
• PORT_SMTP (465)
• SECURE_SMTP (true)

If you are packaging/uploading this skill: run node scripts/secret-scan.js first.