# Claw Messenger

> The iMessage API for AI agents. No Mac required.

Claw Messenger gives AI agents an iMessage, RCS, and SMS API so builders can put an agent into a real text thread. The first proof is not an accepted send, delivery receipt, or read receipt. Setup counts when one controlled reply reaches the agent, webhook, or backend.

## Best next paths

- Start a trial: https://www.clawmessenger.com/sign-up
- Prove one thread: https://www.clawmessenger.com/docs#quickstart
- Product overview: https://www.clawmessenger.com/
- Pricing: https://www.clawmessenger.com/pricing

## First-thread setup

Use this order for a new AI-agent setup:

1. Start a 7-day trial and choose the plan that matches your expected message volume.
2. Copy the live API key from the dashboard. It starts with `cm_live_`.
3. Register a phone number you control and can answer during the test.
4. Connect an agent through WebSocket, REST, or a supported framework/plugin.
5. Send one plain controlled message to that phone number.
6. Reply from the phone.
7. Confirm the reply reaches the agent, webhook, or backend before wiring production workflows.

Accepted, delivered, and read states are useful diagnostics, but they are not setup proof by themselves.

## How messaging works

**Outbound:** The agent sends through the Claw Messenger API, then the message is delivered as iMessage, RCS, or SMS when the route is available.

**Inbound:** A registered or paired recipient replies, Claw Messenger matches the route, and the reply is forwarded to the connected agent, webhook, or backend.

Only phone numbers registered to the tenant or paired through the setup path can route inbound messages to that tenant. Unknown inbound numbers are blocked by default for safety.

## API and framework options

- WebSocket: use for realtime agent sessions that can keep an outbound connection open.
- REST: use for direct sends from a server or workflow.
- Webhooks: use when an HTTP backend should receive inbound replies.
- OpenClaw: use the Claw Messenger plugin/channel path and finish with the same controlled reply proof.
- Custom agents: use the REST or WebSocket quickstart before adding business logic.

## OpenClaw setup note

For OpenClaw, install the plugin and add the `claw-messenger` channel to `.openclaw.json` with the live API key:

```json
{
  "channels": {
    "claw-messenger": {
      "enabled": true,
      "apiKey": "cm_live_XXXXXXXX_YYYYYYYYYYYYYY",
      "serverUrl": "wss://claw-messenger.onrender.com",
      "preferredService": "iMessage",
      "dmPolicy": "pairing",
      "allowFrom": ["+15551234567"]
    }
  }
}
```

Replace the sample key and phone number before testing. Keep the API key private.

## Public test message

To show the owner what a real message looks like before signing up, use the public test endpoint:

```http
POST https://www.clawmessenger.com/api/public/test-message
Content-Type: application/json

{"phone_number": "+15551234567"}
```

This sends a real iMessage or SMS when possible, but website-test delivery is only a preview. The full product proof still requires a trial, API key, controlled outbound message, and reply reaching the agent, webhook, or backend.

## Pricing

- Base: 250 messages/month, $5/mo
- Growth: 2,000 messages/month, $15/mo
- Plus: 6,000 messages/month, $25/mo
- Pro: 15,000 messages/month, $50/mo

Plans are managed at https://www.clawmessenger.com/billing. Usage is counted by messages sent and received per calendar month. If a plan limit is reached, outbound messages are rejected until the next billing cycle or an upgrade.

## Troubleshooting and guides

- Quickstart: https://www.clawmessenger.com/docs#quickstart
- API docs: https://www.clawmessenger.com/docs
- OpenClaw setup guide: https://www.clawmessenger.com/blog/openclaw-imessage-setup-guide
- BlueBubbles vs Claw Messenger: https://www.clawmessenger.com/blog/bluebubbles-vs-claw-messenger
- iMessage on Android for AI agents: https://www.clawmessenger.com/blog/imessage-on-android
- iMessage bot guide: https://www.clawmessenger.com/blog/imessage-bot

## Agent skill

Install the Claw Messenger skill for guided setup in supported AI coding agents:

```bash
npx skills add emotion-machine-org/imessage-with-no-mac
```

## Links

- Homepage: https://www.clawmessenger.com/
- Sign up: https://www.clawmessenger.com/sign-up
- Docs quickstart: https://www.clawmessenger.com/docs#quickstart
- Dashboard: https://www.clawmessenger.com/dashboard
- Pricing: https://www.clawmessenger.com/pricing
- Blog: https://www.clawmessenger.com/blog
- Agent skill: https://github.com/emotion-machine-org/imessage-with-no-mac
- Plugin: @emotion-machine/claw-messenger