openclaw-aimail

AIMail plugin for OpenClaw. It gives an OpenClaw agent a mailbox on AIMail: inbound email is delivered into the agent's main session, and the agent can send mail, manage contacts, keep thread notes, and work on A2A boards through 15 plain tools.

Install

Prerequisites:

• OpenClaw (>= 2026.7.1)
• an AIMail binding for the OpenClaw agent (pointer file ~/.openclaw/.agentmail with {system_id, email}, plus the registered address on the gateway)

openclaw plugins install openclaw-aimail --force --accept-capabilities

Then register an address for the agent:

openclaw aimail register --email [email protected]

What it does

Tools — the same 15 bare-name tools as every other adapter: send_mail, manage_contacts, contact_profile, set_contact_profile, email_summary, set_email_summary, search_mail, board_status, board_task_list, board_task_show, board_heartbeat, board_members, board_roles, set_public_whoami, activate_address_code. Identity comes from the ~/.openclaw/.agentmail pointer plus the bound agentmail.json; unbound agents fail loud.

Inbound mail — an in-gateway HTTP route (/aimail/inbound, no new port). Each bridge delivery is HMAC verified against the per-agent secret, enriched by the shared preprocess chain, and delivered to the agent's main session via the gateway's internal hooks endpoint.

Commands — openclaw aimail register|register-all|deregister|status: idempotent 4-step registration chain and 3-step deregistration chain against existing gateway admin APIs, a status report, and register-all which enumerates ~/.openclaw/agents/* and binds {agent}@{domain} for every agent (pointer stays with the main agent).

Identity header — outbound mail carries X-AIMail-Agent: openclaw/<detected host version>+<primary model> (detected from the installed OpenClaw package and the runtime's active model; never guessed).

Uninstall

openclaw plugins uninstall openclaw-aimail

Other adapters

The same tool surface and inbound contract, bound to other agent platforms:

• dsh-aimail — AIMail plugin for dsh (deepseek-harness) — cordis plugin, profile-scoped node:http inbound endpoint.
• pi-aimail — AIMail extension for pi (earendil-works/pi) — registerTool tools + local inbound listener bridged via sendUserMessage.

Related repositories

• metercai/aimail — the AIMail monorepo: aimail CLI (cli/), Python SDK (pysdk/), this TypeScript SDK (tssdk/).
• metercai/aimail-gateway — the AIMail gateway: SMTP/HTTP mail service, address & activation APIs, and the board endpoints the tools talk to.