@emotion-machine/claw-messenger

iMessage, RCS & SMS channel plugin for OpenClaw — no phone or Mac Mini required.

How It Works

Claw Messenger routes messages between your OpenClaw agent and iMessage/RCS/SMS networks. The plugin connects to the Claw Messenger relay server over a WebSocket and authenticates with your API key. The relay server handles carrier-level delivery and inbound routing, then forwards messages back to your agent in real time.

OpenClaw Agent  ←→  Plugin (local)  ←→  Relay Server (WSS)  ←→  iMessage / RCS / SMS

Required Credentials

This plugin requires one credential: a Claw Messenger API key.

No other credentials, environment variables, or secrets are required.

Required Config Path

All plugin configuration is stored in a single location:

.openclaw.json → channels.claw-messenger

This is the only file the plugin reads or writes. The full config schema is documented in the Configuration Reference below and declared in the plugin manifest (openclaw.plugin.json → configSchema).

External Connections

The plugin makes exactly one external connection:

No other external connections are made.

Plugin Manifest Summary

The plugin's openclaw.plugin.json manifest declares the following (reproduced here for transparency):

• Required credentials: apiKey (marked sensitive: true, placeholder cm_live_...)
• Config path: .openclaw.json → channels.claw-messenger
• External connection: wss://claw-messenger.onrender.com (relay server)
• Config schema: apiKey (required string), serverUrl (optional string), preferredService (optional enum), dmPolicy (optional enum), allowFrom (optional array)

All credentials and config paths used at runtime are declared in the manifest. There are no undeclared secrets, env vars, or config files.

Install

openclaw plugins install @emotion-machine/claw-messenger

The package is published to npm as @emotion-machine/claw-messenger. You can verify the package contents before installing:

npm pack @emotion-machine/claw-messenger --dry-run

Configuration

After installing, add the plugin to your OpenClaw config (.openclaw.json) under channels:

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

Configuration Reference

Security & Privacy

• Your cm_live_* API key is a secret credential. Add .openclaw.json to .gitignore to avoid committing it to version control.
• You can revoke and rotate API keys at any time from the dashboard. We recommend starting with a scoped or test key.
• All connections use TLS-encrypted WebSockets (wss://). Message content is not stored on the relay server.
• Message metadata (sender, recipient, timestamps) is logged for delivery tracking and billing. See the Privacy Policy.
• Billing is based on monthly message volume. See Pricing for plans and limits.

Features

• Send & receive text messages and media (images, video, audio, documents)
• iMessage reactions — love, like, dislike, laugh, emphasize, question (tapback)
• 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:

Slash Commands

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 (keep .openclaw.json out of version control)
5. Start a conversation — your agent can now send and receive messages

Support

• Issues: github.com/emotion-machine-org/claw-messenger/issues
• Email: [email protected]
• Docs: clawmessenger.com/docs

License

UNLICENSED