Agent Email Setup for Openclaw

1. DNS Domain Verification

Configure your custom domain on Resend to enable sending and receiving:

RESEND_KEY="re_xxxxx"

# Add domain
curl -s -X POST -H "Authorization: Bearer $RESEND_KEY" \
  -H "Content-Type: application/json" \
  https://api.resend.com/domains \
  -d '{"name": "yourdomain.com", "region": "us-east-1"}'

# Get DNS records to configure
curl -s -H "Authorization: Bearer $RESEND_KEY" \
  https://api.resend.com/domains/yourdomain.com | jq '.records'

Add the returned DNS records (TXT, MX, CNAME) to your DNS provider. Wait for verification (usually minutes).

Verify status:

curl -s -H "Authorization: Bearer $RESEND_KEY" \
  https://api.resend.com/domains/yourdomain.com | jq '{status, capabilities}'

Both sending and receiving capabilities must be enabled on Resend.

2. Create Webhook Endpoint

Create routes/inboundEmail.js in your Express backend. Key requirements:

• Accept POST at /api/inbound-email
• Verify Resend webhook signature using RESEND_WEBHOOK_SECRET
• Save emails as JSON to mail/inbox/
• Provide GET endpoint to list/read emails
• Provide ACK endpoint to mark processed

Mount in your server:

const inboundEmailRoutes = require('./routes/inboundEmail');
app.use('/api/inbound-email', inboundEmailRoutes);

3. Register Webhook on Resend

curl -s -X POST -H "Authorization: Bearer $RESEND_KEY" \
  -H "Content-Type: application/json" \
  https://api.resend.com/webhooks \
  -d '{
    "endpoint": "https://yourdomain.com/api/inbound-email",
    "events": ["email.received"],
    "enabled": true
  }' | jq '{id, signing_secret}'

Save the returned signing_secret — you will need it for webhook verification.

4. Create Inbox Directory & Configure Secrets

mkdir -p mail/inbox
touch mail/inbox/.lastcheck

Store these credentials in your secrets configuration:

• RESEND_API_KEY
• RESEND_WEBHOOK_SECRET
• AGENT_EMAIL

This skill stores inbound emails as localized JSON objects and uses state variables to track processing pipelines.

File Directory Taxonomy

Local JSON Email Model Schema

{
  "id": "email_id_xxxxx",
  "from": "[email protected]",
  "to": ["[email protected]"],
  "subject": "Verification Code: 4920",
  "text": "Your verification code is 4920.",
  "html": "<p>Your verification code is 4920.</p>",
  "processed": false
}