Skip to content
agentinbox.pro

OpenClaw email setup

OpenClaw agents often need a durable external channel — email is ideal for human-in-the-loop triggers, vendor notifications, and async tasks. agentinbox.pro gives your agent a receive-only address and delivers signed JSON to your webhook.

Fastest path (no DNS)

Section titled “Fastest path (no DNS)”
  1. Open agentinbox.pro and click Create instant inbox
  2. Copy the demo address (e.g. inbox@abc12345.inbox.agentinbox.pro)
  3. Send a test email from any mailbox
  4. Watch the normalized event appear on the homepage terminal

For production, upgrade to your own domain.

Production path (custom domain)

Section titled “Production path (custom domain)”
Terminal window
export API="https://api.agentinbox.pro"


# 1. Workspace
curl -s -X POST "$API/api/workspaces" \
  -H "content-type: application/json" \
  -d '{"name":"my-openclaw-agent"}'


export AGENTMAIL_API_KEY="ak_live_..."


# 2. Register domain + DNS (see quickstart)
# 3. Set webhook to your OpenClaw gateway or agent server
curl -s -X PATCH "$API/api/domains/$DOMAIN_ID/delivery" \
  -H "content-type: application/json" \
  -H "Authorization: Bearer $AGENTMAIL_API_KEY" \
  -d '{"webhookUrl":"https://your-gateway.example/openclaw/inbound-email"}'

Webhook handler sketch

Section titled “Webhook handler sketch”

Route on recipient to dispatch to the right OpenClaw agent or skill:

export async function POST(request) {
  const rawBody = await request.text();
  // verify X-AgentMail-Signature (see webhook-events guide)
  const event = JSON.parse(rawBody);
  await dispatchToOpenClaw(event.recipient, event);
  return Response.json({ ok: true });
}

See Webhook events for HMAC verification.

OpenClaw skill

Section titled “OpenClaw skill”

Install the agentinbox skill from the repo (distribution/openclaw-email/) — it documents env vars and webhook wiring for OpenClaw workspaces.

Section titled “Related”