clawresponding

ClawResponding iMessage channel plugin for OpenClaw. When installed, this plugin lets your OpenClaw agent send responses to users via iMessage through the ClawResponding relay service and LoopMessage.

How it works

User (iPhone)  <--iMessage-->  LoopMessage  <-->  ClawResponding API  <-->  OpenClaw + this plugin

1. A user sends an iMessage that LoopMessage forwards to the ClawResponding routing API.
2. The routing API forwards the message to your OpenClaw instance's Gateway webhook.
3. Your OpenClaw agent processes the message and generates a response.
4. OpenClaw Gateway calls this plugin's sendText() method.
5. The plugin POSTs the response to the ClawResponding relay API.
6. ClawResponding sends it back to the user's iPhone via LoopMessage.

Prerequisites

• An ClawResponding account with an active subscription
• A verified phone number in the ClawResponding dashboard
• Your per-tenant API token (shown once during setup -- copy it carefully)
• OpenClaw >= 0.7.0

Installation

npm install clawresponding

Configuration

Add the channel to your openclaw.yaml:

channels:
  clawresponding:
    type: clawresponding
    apiUrl: https://api.clawresponding.com
    apiToken: "a1b2c3d4e5f6...your-64-char-hex-token"

Environment variables

You can also configure the plugin via environment variables. These are used as fallbacks when the corresponding openclaw.yaml value is not set.

| Variable | Description | Default | |----------|-------------|---------| | CLAWRESPONDING_API_KEY | Per-tenant API token (64-char hex) | (required) | | CLAWRESPONDING_API_URL | ClawResponding API base URL | https://api.clawresponding.com |

Options

| Option | Type | Required | Default | Description | |--------|------|----------|---------|-------------| | apiToken | string | Yes | -- | 64-character hex API token from your ClawResponding dashboard | | apiUrl | string | No | https://api.clawresponding.com | ClawResponding API base URL | | timeout | number | No | 10000 | Request timeout in milliseconds (1000--60000) |

Verifying the connection

After configuring the plugin and restarting OpenClaw:

1. Open the ClawResponding dashboard at clawresponding.com/dashboard.
2. Check that the connection status shows Connected (green).
3. Send a test iMessage to your verified phone number.
4. You should see the message appear in your OpenClaw agent's conversation and receive a response back on your iPhone.

Troubleshooting

"apiToken is required" -- Set the token in openclaw.yaml or the CLAWRESPONDING_API_KEY environment variable. You can find your token in the ClawResponding dashboard under Settings.

"apiToken must be a 64-character hex string" -- The token should be exactly 64 hexadecimal characters. Copy it from the dashboard without extra whitespace.

"Network error" / timeouts -- Verify that your OpenClaw instance can reach api.clawresponding.com on port 443. Check firewall rules and DNS resolution.

"UNAUTHORIZED" / 401 errors -- Your API token may have been rotated. Generate a new token in the ClawResponding dashboard and update your configuration.

"FORBIDDEN" / 403 errors -- The recipient phone number is not associated with your tenant. Verify the phone number in the ClawResponding dashboard.

License

MIT