Inkbox

> # Documentation index
> Fetch the complete documentation index at: https://inkbox.ai/sitemap.xml
> Use this file to discover all available pages before exploring further.

---

# OpenClaw plugin
description: Connect an OpenClaw agent to Inkbox email, phone, iMessage, and tunnel capabilities

---


# OpenClaw plugin

The [Inkbox OpenClaw plugin](https://github.com/inkbox-ai/openclaw-plugin) is a standalone OpenClaw channel plugin. It connects an OpenClaw agent to an Inkbox identity and supports email, SMS/MMS and voice calls, iMessage, contacts, notes, contact rules, A2A task delegation, and an Inkbox tunnel when those capabilities are configured.

This is a plugin, not an Inkbox SDK skill. It lives in its own repository and wires Inkbox directly into OpenClaw's plugin SDK, gateway, tools, HTTP routes, CLI, and bundled OpenClaw task skills.

<YouTubeEmbed id="m7_bQGZL3Zc" title="OpenClaw with Email, SMS, and Calls in 2 Minutes" />

[View plugin on GitHub](https://github.com/inkbox-ai/openclaw-plugin)

## Install

Install and configure [upstream OpenClaw](https://docs.openclaw.ai/install) first. The plugin currently targets OpenClaw `2026.5.27` or newer.

```bash
# Install OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# Onboard OpenClaw
openclaw onboard

# Configure your model provider
openclaw configure
```

Install the Inkbox plugin from source:

```bash
# Clone the plugin
git clone https://github.com/inkbox-ai/openclaw-plugin.git
cd openclaw-plugin

# Build the plugin
npm install
npm run build

# Add it to OpenClaw
openclaw plugins install -l --dangerously-force-unsafe-install ./
```

Configure Inkbox and start or restart the gateway:

```bash
# Configure Inkbox
openclaw inkbox setup

# Check the Inkbox configuration
openclaw inkbox doctor

# Start the gateway
openclaw gateway run

# If gateway is already running, restart it
openclaw gateway restart
```

OpenClaw requires the explicit install acknowledgement because the plugin's gateway setup helper invokes the OpenClaw CLI. The setup wizard creates or connects an Inkbox agent, offers to connect iMessage, offers to provision a phone number, configures signed inbound messaging, and presents the available phone-call voice stacks when a calling channel is available.

If the gateway is already running, restart it so it reloads the Inkbox channel config. Keep the gateway process running. On startup the plugin opens an Inkbox tunnel, configures mail, text, and iMessage webhook subscriptions, wires the incoming-call URL and call media WebSocket, and routes configured email, SMS/MMS, iMessage, and call channels into OpenClaw sessions.

## Available capabilities

Depending on your setup choices and account availability, your OpenClaw agent can have:

- **An email address** - send, receive, search, and reply from an Inkbox mailbox
- **A phone number, when available** - SMS/MMS and voice calls, inbound and outbound
- **iMessage, when connected** - continue OpenClaw conversations from iMessage threads
- **An Inkbox tunnel** - inbound webhooks and WebSocket connections reach the local OpenClaw gateway without a public server
- **Contacts and notes** - persistent Inkbox records the agent can create, update, and read
- **Contact rules** - mailbox and phone reachability controlled from Inkbox

## What Inkbox adds

| Capability | OpenClaw alone | With Inkbox plugin |
| --- | --- | --- |
| Agent-owned mailbox | Bring your own integration | Built in |
| SMS/MMS and voice calls | Bring your own integration | Available when configured |
| iMessage | Bring your own integration | Available when configured |
| Inbound webhook and WebSocket tunnel | Bring your own tunnel/server | Built in |
| Contact and note storage | Agent memory or external tools | Built in |

OpenClaw itself stays upstream. The plugin adds an Inkbox channel, tool group, CLI setup wizard, gateway webhook routing, and package-included task skills without requiring an OpenClaw fork.

## After install

Run a quick health check:

```bash
openclaw inkbox doctor
openclaw plugins list
openclaw skills list
```

Use any channels you configured. If the agent has a phone number, text `START` to it from every phone the agent needs to text. This opts that phone number in to SMS from the agent. You can also email the agent mailbox, use iMessage when connected, or call the agent phone number when available; the gateway routes each configured channel into OpenClaw.

## Related

- [Inkbox OpenClaw plugin on GitHub](https://github.com/inkbox-ai/openclaw-plugin)
- [OpenClaw](https://openclaw.ai)
- [OpenClaw install docs](https://docs.openclaw.ai/install)