@textopenclaw/textclaw

iMessage channel plugin for OpenClaw via TextClaw relay. No Mac required.

Your OpenClaw <--> TextClaw Relay <--> iMessage

Install

openclaw plugins install @textopenclaw/textclaw

Configuration

Add to your OpenClaw channel config:

{
  "textclaw": {
    "enabled": true,
    "textclawUrl": "https://textclaw.now",
    "apiKey": "YOUR_API_KEY"
  }
}

That's it. The plugin connects via WebSocket automatically — no public URL, no port forwarding.

Options

| Field | Required | Description | |-------|----------|-------------| | textclawUrl | Yes | TextClaw API base URL | | apiKey | Yes | Your BYOC API key from textclaw.now | | dmPolicy | No | "open" (default), "allowlist", or "disabled" | | allowFrom | No | Phone numbers to accept when using "allowlist" policy |

DM Policies

• open — Accept messages from anyone (default)
• allowlist — Only accept messages from numbers listed in allowFrom
• disabled — Ignore all inbound messages

Example with allowlist:

{
  "textclaw": {
    "enabled": true,
    "textclawUrl": "https://textclaw.now",
    "apiKey": "YOUR_API_KEY",
    "dmPolicy": "allowlist",
    "allowFrom": ["+15555550123", "+15555550456"]
  }
}

Features

• Send and receive iMessages (text + media)
• Typing indicators and read receipts
• Tapback reactions: heart, thumbsup, thumbsdown, laugh, emphasize, question
• Voice note support (server-side .caf conversion for iMessage playback)
• Message chunking for long texts (4000 char iMessage limit)
• Real-time WebSocket delivery with HTTP fallback
• DM policy enforcement (open, allowlist, disabled)

How It Works

1. Outbound: OpenClaw agent sends a message → plugin calls TextClaw relay API → relay delivers via iMessage
2. Inbound: iMessage received → TextClaw pushes to your OpenClaw instance via WebSocket → plugin dispatches to agent

Agent Tools

The plugin registers two tools for your OpenClaw agent:

• react_imessage — Send a tapback reaction (heart, thumbsup, thumbsdown, laugh, emphasize, question)
• send_voice_note — Send an audio file as an iMessage voice note

Get an API Key

Sign up at textclaw.now and grab your BYOC key from the dashboard.

License

MIT