Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
OPENCLAW_AGENT_ID now required (like WEBHOOK_SECRET). Skill belongs to the agent — always targets only that agent. Removed system event fallback entirely.
What This Skill Does
Runs a local HTTP server that receives incoming emails as JSON webhooks and immediately wakes an OpenClaw agent. Emails are stored in a local JSONL inbox file and the agent is notified via a system event. Requires a shared secret for authentication.
Skips polling by pushing email events directly to the agent in real time via webhook, rather than having the agent check an inbox on a schedule.
When to use it
- Get notified when a support email arrives while the agent is idle
- Route incoming emails to a Discord or WhatsApp notification via agent heartbeat
- Trigger automated replies when specific senders are detected
- Log all inbound emails to a local file for later processing
- Wake a dormant agent the moment a time-sensitive email lands
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: notify me on Discord whenever I get an email
- 1Start the webhook server with WEBHOOK_SECRET and OPENCLAW_AGENT_ID set
- 2Configure Cloudflare Email Worker to POST to the webhook URL
- 3Receive incoming email as JSON payload at /api/email
- 4Append email metadata to inbox.jsonl and fire openclaw system event --mode now
- 5Agent reads inbox.jsonl, detects new entry, and sends Discord notification with sender, subject, and preview
Discord message: "📧 New email from alice@example.com: Invoice #1042 — Please find attached..."
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.