BotEmail.ai - Free bot email

# BotEmail.ai — Email for Bots

Get a free permanent bot email address instantly. Just say **"get me a bot email"** — no signup, no form, done in seconds. Supports attachments, inbox monitoring, and automatic notifications via heartbeat.

## Setup

### 1. Create or retrieve an account

If the user doesn't have an account yet, create one:

```
POST https://api.botemail.ai/api/create-account
Content-Type: application/json

{}
```

Returns:
```json
{ "email": "9423924_bot@botemail.ai", "apiKey": "..." }
```

Custom username:
```json
{ "username": "mybot" }
```

Ask the user to save the returned email address and API key securely (e.g. password manager or `.env` file). Do not store them anywhere unless the user explicitly asks.

### 2. Check inbox

```
GET https://api.botemail.ai/api/emails/{email}
Authorization: Bearer {apiKey}
```

### 3. Optional: Inbox notifications via heartbeat

If the user asks to be notified of new emails automatically, ask them to confirm they want this set up and which address to monitor. Then update `HEARTBEAT.md` to add a check that:

1. Fetches the inbox using the user's credentials (ask them to provide the API key at setup time)
2. Compares against seen IDs in `memory/heartbeat-state.json`
3. **Notifies the user** of any new emails (sender, subject, preview) — does not take any action on their behalf
4. Updates the seen ID list

The agent only notifies — it does not act on email contents without a separate explicit user instruction.

---

## API Reference

### GET /api/emails/{email}
List all emails in inbox.

**Headers:** `Authorization: Bearer {apiKey}`

**Response:**
```json
{
  "emails": [
    {
      "id": "abc123",
      "from": "sender@example.com",
      "subject": "Hello",
      "timestamp": "2026-02-17T12:00:00Z",
      "bodyText": "Hello!"
    }
  ]
}
```

### GET /api/emails/{email}/{id}
Get a single email by ID.

### DELETE /api/emails/{email}/{id}
Delete a specific email.

### DELETE /api/emails/{email}
Clear entire inbox.

-...

# BotEmail.ai Skill for OpenClaw

Professional email infrastructure for autonomous agents. This OpenClaw skill provides access to [BotEmail.ai](https://botemail.ai) - a bot-friendly email service.

## What is this?

An OpenClaw skill that enables your AI agent to:
- Create permanent bot email addresses (random or custom)
- Receive and read emails programmatically
- Extract verification codes automatically
- Monitor inboxes for specific messages
- Automate email-based workflows

## Features

✅ **Permanent inboxes** - Email addresses never expire  
⚠️ **RECEIVE ONLY** - Currently receive-only (sending emails coming soon)  
✅ **Random or custom** - `9423924_bot@botemail.ai` or `mybot_bot@botemail.ai`  
✅ **JSON-first API** - Bot-friendly responses  
✅ **Free tier** - 1 address, 1000 requests/day  
✅ **Private** - Isolated inboxes per bot  
✅ **Web dashboard** - Human-accessible viewer  
✅ **Webhook support** - Push notifications  
✅ **MCP server** - Claude Desktop integration  

## Installation

### For OpenClaw Users

```bash
# Clone to your OpenClaw skills directory
cd ~/.openclaw/skills  # or your custom skills path
git clone https://github.com/claw-silhouette/bot-email-skill.git bot-email
```

Restart OpenClaw and the skill will be available.

### For ClawHub Users

Find and install via [ClawHub.com](https://clawhub.com) (coming soon).

## Quick Start

### Create a Bot Email

**Random username (instant):**
```bash
curl -X POST https://api.botemail.ai/api/create-account \
  -H "Content-Type: application/json" \
  -d '{}'
```

**Custom username:**
```bash
curl -X POST https://api.botemail.ai/api/create-account \
  -H "Content-Type: application/json" \
  -d '{"username": "mybot"}'
```

### Check Inbox

```bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.botemail.ai/api/emails/mybot_bot@botemail.ai
```

## Example Workflows

### 1. Bot Registration Flow

```javascript
// 1. Create bot email
const account = await createAccount();
// { email: "94...