Skip to main content

mailbot Is Now an OpenClaw Skill

· 4 min read
Yopie Suryadi
Founder, mailbot

If you're building AI agents with OpenClaw, your agent can now handle email natively. We published mailbot-programmable-inbox as an OpenClaw skill that gives any agent the ability to create inboxes, send and receive messages, track delivery events, and manage threads through a single install.

clawhub install mailbot-programmable-inbox

That's it. Your agent now knows how to use mailbot.

What the skill includes​

The skill package ships with everything an agent needs to build email workflows.

SKILL.md contains the full instruction set: core concepts, SDK patterns for Node.js and Python, event notification setup, compliance checks, and security guidance. When your agent loads the skill, it understands how inboxes, threads, messages, and events relate to each other.

SDK references for Node.js and Python cover every operation: inbox management, messaging, threaded replies, search, labels, wait semantics, event replay, and engagement tracking.

MCP Server support means Claude Desktop users can connect mailbot directly through the Model Context Protocol. Create inboxes, send messages, list threads, replay events, and check usage stats from a conversational interface.

Security patterns for prompt injection protection are built into the instructions. The skill teaches agents to treat inbound email as untrusted input, verify sender identity before executing commands, and require human review for high-impact actions.

Why a skill, not just an SDK​

SDKs require developers to write the glue code. Read the docs, learn the API surface, handle errors, wire everything together. That works. But every developer building email into an AI agent ends up solving the same integration problem from scratch.

A skill changes the model. Instead of the developer writing code that calls the SDK, the agent reads the skill and writes the code itself. The developer describes the workflow. The agent already knows the correct patterns.

Without the skill, a prompt like "set up a support inbox and reply to inbound emails" forces the agent to search for docs and guess at method signatures. With the skill installed, the same prompt produces working code because the full API reference is already in context.

What agents can do with it​

The skill covers the full mailbot API surface. A few patterns that work out of the box:

Support automation. Create an inbox, receive customer emails, classify content, and reply in the same thread.

import { MailBot } from '@yopiesuryadi/mailbot-sdk';

const client = new MailBot({
  apiKey: process.env.MAILBOT_API_KEY,
  baseUrl: 'https://beta.mailbot.id',
});

const inbox = await client.inboxes.create({
  username: 'support-bot',
  display_name: 'Support Bot',
});

const msg = await client.messages.waitFor({
  inboxId: inbox.id,
  direction: 'inbound',
  timeoutMs: 30000,
});

await client.messages.reply({
  inboxId: inbox.id,
  messageId: msg.id,
  bodyText: 'Thanks for reaching out. We received your message and will follow up shortly.',
});

Document intake. Receive invoices or contracts by email, extract attachments, process with your LLM pipeline, confirm receipt in the original thread.

Email testing in CI. Spin up a disposable inbox, send a test email, wait for delivery, assert on thread state, clean up. No shared test accounts.

Transactional flows with replies. Send a confirmation, receive the customer's reply, continue the conversation in the same thread.

The MCP path​

For teams using Claude Desktop, the MCP Server exposes twelve tools. After installing @yopiesuryadi/mailbot-mcp, Claude executes full workflows conversationally:

"Create an inbox for onboarding, send a welcome email to new-user@example.com, then show me the thread."

No code written. No SDK imported.

Install and start building​

The skill is on GitHub now:

github.com/yopiesuryadi/mailbot-programmable-inbox

Install via ClawHub:

clawhub install mailbot-programmable-inbox

Or clone directly:

git clone https://github.com/yopiesuryadi/mailbot-programmable-inbox.git ~/.openclaw/skills/mailbot-programmable-inbox

The skill works with mailbot's sandbox domain (@mailbot.id) out of the box. Create an API key at beta.mailbot.id, set MAILBOT_API_KEY in your environment, and your agent is ready to send its first email.

If your AI agent needs to communicate over email, it no longer needs to figure out how. The skill already knows.