Bettermachine Mail

Name: Bettermachine Mail
Rating: 3.5 (1 reviews)
Author: Better-Machine

By Better-Machine 👁 68 views ▲ 0 votes

OpenClaw plugin for email integration - IMAP polling, SMTP sending, command parsing

GitHub

Configuration Example

{
  "plugins": {
    "entries": {
      "bettermachine-mail": {
        "enabled": true,
        "source": "/home/erik-ross/.openclaw/extensions/bettermachine-mail",
        "config": {
          "enabled": true,
          "email": "[email protected]",
          "imap": {
            "host": "imap.hostinger.com",
            "port": 993,
            "tls": true
          },
          "smtp": {
            "host": "smtp.hostinger.com",
            "port": 465,
            "secure": true
          },
          "polling": {
            "enabled": true,
            "intervalMinutes": 15
          }
        }
      }
    }
  }
}

README

# BetterMachine Mail Plugin for OpenClaw

**A proper OpenClaw plugin** providing email integration (IMAP polling, SMTP sending, command parsing) with full lifecycle management.

---

## Features

- **Plugin Architecture** — Full OpenClaw plugin with manifest, config schema, hooks
- **IMAP Polling** — Configurable interval via OpenClaw cron system
- **SMTP Sending** — Reply to commands, send notifications
- **Command Parsing** — Natural language "liz [command]" processing
- **Telegram Forwarding** — Important emails forwarded via OpenClaw messaging
- **Audit Logging** — All activity logged to JSONL trail
- **Commands** — `email:test`, `email:poll`, `email:status`

---

## Installation

### 1. Set Environment Variable

```bash
export LIZ_EMAIL_PASSWORD="your-password"
```

Add to `~/.bashrc` to persist:
```bash
echo 'export LIZ_EMAIL_PASSWORD="your-password"' >> ~/.bashrc
```

### 2. Add to OpenClaw Config

Edit `~/.openclaw/openclaw.json`:

```json
{
  "plugins": {
    "entries": {
      "bettermachine-mail": {
        "enabled": true,
        "source": "/home/erik-ross/.openclaw/extensions/bettermachine-mail",
        "config": {
          "enabled": true,
          "email": "[email protected]",
          "imap": {
            "host": "imap.hostinger.com",
            "port": 993,
            "tls": true
          },
          "smtp": {
            "host": "smtp.hostinger.com",
            "port": 465,
            "secure": true
          },
          "polling": {
            "enabled": true,
            "intervalMinutes": 15
          }
        }
      }
    }
  }
}
```

### 3. Restart OpenClaw

```bash
openclaw gateway restart
```

---

## Commands

Send email to [email protected]:

| Command | Response |
|---------|----------|
| liz ping | Pong! Email integration is working. |
| liz status | System status |
| liz help | Available commands |
| liz mesh-memory [topic] | Query mesh memory |

---

## API

The plugin exports a register(api) function following OpenClaw 2026.4.x plugin API:

```javascript
export function register(api) {
  return {
    id: 'bettermachine-mail',
    name: 'BetterMachine Mail',
    version: '1.0.0',
    
    async init(ctx) {
      // Plugin initialization
    },
    
    async onCronTick(ctx) {
      // Called on each cron tick
    },
    
    getStatus() {
      // Return plugin status
    }
  };
}
```

---

## License

MIT

integration