Openclaw

subtitle: Give your Openclaw agent its own email inbox slug: integrations/openclaw description: Inboxlayer's Openclaw integration

Getting started

Openclaw (formerly Moltbot) is an open-source AI personal assistant that runs on your own devices and integrates with messaging platforms like WhatsApp, Telegram, Discord, and Slack. By adding Inboxlayer to Openclaw, your agent gains the ability to send and receive emails, enabling two-way email conversations alongside your existing chat channels.

There are two ways to integrate Inboxlayer with Openclaw: using the official Inboxlayer skill or creating a custom skill.

The easiest way to add email capabilities is by installing the official Inboxlayer skill.

Installation

Install the skill using the Openclaw CLI:

openclaw skills install /path/to/inboxlayer-libs/inboxlayer-skill

Or install via ClawHub:

npx clawhub@latest install inboxlayer

If the package is not yet published, use the local path install above.

Configuration

Add your Inboxlayer API token to the skill configuration in ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "inboxlayer": {
        "enabled": true,
        "env": {
          "INBOXLAYER_API_TOKEN": "your-inboxlayer-api-token"
        }
      }
    }
  }
}

Get your API token from your Inboxlayer credentials flow in your environment settings.

Verify installation

Check that the skill is loaded:

openclaw skills list --eligible

You should see inboxlayer in the list of available skills.

Option 2: Custom Skill

For more control over the integration, you can create a custom Inboxlayer skill. Skills are directories containing a SKILL.md file with instructions for Openclaw.

Create the skill directory

Create a new skill in your Openclaw workspace:

mkdir -p ~/.openclaw/skills/inboxlayer

Create the skill file

Create ~/.openclaw/skills/inboxlayer/SKILL.md with the following content:

---
name: inboxlayer
description: Send and receive emails using Inboxlayer
requires:
  env:
    - INBOXLAYER_API_TOKEN
---

# Inboxlayer Skill

You can send and receive emails using the Inboxlayer API. Use the `exec` tool to run curl commands against the API.

## API Base URL

```
https://api.inboxlayer.dev/api/v1
```

## Authentication

Include your API token in the Authorization header:

```
Authorization: Bearer $INBOXLAYER_API_TOKEN
```

## Common Operations

### List inboxes

```bash
curl -s -H "Authorization: Bearer $INBOXLAYER_API_TOKEN" \
  https://api.inboxlayer.dev/api/v1/inboxes
```

### Create an inbox

```bash
curl -s -X POST -H "Authorization: Bearer $INBOXLAYER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Agent Inbox"}' \
  https://api.inboxlayer.dev/api/v1/inboxes
```

### List messages in an inbox

```bash
curl -s -H "Authorization: Bearer $INBOXLAYER_API_TOKEN" \
  "https://api.inboxlayer.dev/api/v1/emails?inbox_id=<inbox-id>&page=1&per_page=20"
```

### Send an email

```bash
curl -s -X POST -H "Authorization: Bearer $INBOXLAYER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["recipient@example.com"],
    "subject": "Hello from Openclaw",
    "text_body": "This email was sent by my AI assistant.",
    "inbox_id": "<inbox-id>"
  }' \
  https://api.inboxlayer.dev/api/v1/emails/send
```

### Reply to a message

```bash
curl -s -X POST -H "Authorization: Bearer $INBOXLAYER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text_body": "Thanks for your email!"}' \
  https://api.inboxlayer.dev/api/v1/emails/{message-id}/reply
```

### Register a webhook (optional)

```bash
curl -s -X POST -H "Authorization: Bearer $INBOXLAYER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_subscription": {
      "url": "https://your-openclaw-webhook-url",
      "events": ["message.received"],
      "active": true
    }
  }' \
  https://api.inboxlayer.dev/api/v1/webhook_subscriptions
```

Configure the skill

Add your Inboxlayer API token to the skill configuration in ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "inboxlayer": {
        "enabled": true,
        "env": {
          "INBOXLAYER_API_TOKEN": "your-inboxlayer-api-token"
        }
      }
    }
  }
}

Verify the skill

Check that the skill is loaded:

openclaw skills list --eligible

You should see inboxlayer in the list of available skills.

Example use cases

Once Inboxlayer is integrated with Openclaw, you can ask your agent to:

  • "Create a new email inbox for my project"
  • "Check my inbox for new emails"
  • "Send an email to john@example.com about the meeting tomorrow"
  • "Reply to the latest email from Sarah"
  • "Forward the invoice email to accounting@company.com"

Real-time email notifications

For proactive email handling, you can combine Inboxlayer webhooks with Openclaw's webhook support. This allows Openclaw to notify you immediately when new emails arrive.

  1. Set up a webhook endpoint in Openclaw (see Openclaw webhook documentation)

  2. Register the webhook with Inboxlayer:

curl -X POST -H "Authorization: Bearer $INBOXLAYER_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_subscription": {
      "url": "https://your-openclaw-webhook-url",
      "events": ["message.received"],
      "active": true
    }
  }' \
  https://api.inboxlayer.dev/api/v1/webhook_subscriptions

Now Openclaw can be notified whenever a new email arrives, allowing it to proactively inform you or take action.

Verify skill

openclaw skills list --eligible

You should see inboxlayer in the list of available skills.

Resources

results matching ""

    No results matching ""