@emotion-machine/claw-messenger

iMessage, RCS & SMS channel plugin for OpenClaw — no phone or Mac Mini required. See Claw Messenger for more details.

Install

openclaw plugins install @emotion-machine/claw-messenger

Configuration

After installing, add to your config under channels:

{
  "channels": {
    "claw-messenger": {
      "enabled": true,
      "apiKey": "cm_live_XXXXXXXX_YYYYYYYYYYYYYY",
      "serverUrl": "wss://claw-messenger.onrender.com",
      "preferredService": "iMessage",  // "iMessage" | "RCS" | "SMS"
      "dmPolicy": "pairing",           // "open" | "pairing" | "allowlist"
      "allowFrom": ["+15551234567"]    // only used with "allowlist" policy
    }
  }
}

Features

• Send & receive text messages and media (images, video, audio, documents)
• iMessage reactions — six standard tapbacks plus any single Unicode emoji
• Group chats — send to existing groups or create new ones
• Typing indicators — sent and received
• DM security policies — open, pairing-based approval, or allowlist

Agent Tools

The plugin registers two tools your agent can call:

| Tool | Description | |------|-------------| | claw_messenger_status | Check connection status, server URL, and preferred service | | claw_messenger_switch_service | Switch the preferred messaging service at runtime |

Slash Commands

| Command | Description | |---------|-------------| | /cm-status | Show connection state, server URL, and preferred service | | /cm-switch <service> | Switch preferred service (iMessage, RCS, or SMS) |

Getting Started

1. Sign up at clawmessenger.com

2. Create an API key from the dashboard

3. Install the plugin: openclaw plugins install @emotion-machine/claw-messenger

4. Add the config above with your API key

5. Restart OpenClaw so the channel connects

6. Check the listener before the first controlled send:

   curl https://claw-messenger.onrender.com/api/agent/readiness \
     -H "Authorization: Bearer ${CLAW_API_KEY}"

   Continue only after the response is {"ready":true,"action":"send_controlled_test"}. If the action is connect_agent, restart OpenClaw and check again. Keep the key in the authorization header, never in the URL.

7. Send one message to a phone you control, reply in the same thread, and confirm the reply reaches your agent

License

UNLICENSED