Email for OpenClaw Agents
Give every OpenClaw agent its own inbox in two commands. openmail setup registers the skill automatically, starts the WebSocket bridge, and your agent can send and receive email immediately — no SMTP config, no deliverability headaches.
How OpenMail works with OpenClaw
Install the OpenMail CLI
One command installs the CLI globally. Node.js 20+ required.
npm install -g @openmail/cliRun setup
Setup creates your inbox, writes the skill file to ~/.openclaw/skills/openmail/SKILL.md, saves credentials to ~/.openclaw/openmail.env, and starts the WebSocket bridge automatically. Pass --api-key to skip the auth prompt.
openmail setupConfirm everything is working
Run openmail status to verify the inbox is live and the WebSocket bridge is running.
openmail statusSend email from the agent
Your OpenClaw agent calls the openmail send skill action. Add --attach (repeatable) to include files — OpenMail handles MIME encoding automatically.
# Send a plain email
openmail send --to hello@example.com --subject "Hello" --body "I have my own inbox!"
# Send with an attachment
openmail send --to hello@example.com --subject "Report" --body "See attached" --attach report.pdfWhat your OpenClaw agent can do with email
Send outbound emails from a branded address on your domain — no SMTP config
Receive replies in real time via the WebSocket bridge, started automatically on setup
List inbound messages and full thread history directly from the agent
Attach PDF, CSV, and DOCX files with a single --attach flag per file
Handle OTP codes and verification links for autonomous account-creation flows
What's included
Skill auto-registration
openmail setup writes SKILL.md directly to ~/.openclaw/skills/openmail/ — OpenClaw picks it up immediately, no manual wiring.
WebSocket bridge included
Real-time inbound delivery via a WebSocket bridge that setup starts automatically through systemd (Linux) or launchd (macOS).
Dedicated inbox per agent
Each OpenClaw agent gets its own address on your domain — no shared inboxes, no filtering logic.
Thread management via CLI
List threads, fetch full conversation history, and reply in-thread with openmail threads get --thread-id.
Attachment support
Pass --attach for every file you want to include. OpenMail handles MIME encoding; the agent gets plain-text content back on inbound.
Managed deliverability
SPF, DKIM, and DMARC configured automatically on provisioning. Primary inbox placement from day one.