# iMessage & SMS Integration Guide with OpenClaw (2026)

Connect OpenClaw to iMessage and SMS. Compare both channels, learn setup steps, costs, limitations, and which one to pick.

## Why Text Your AI Agent?

Most people check messages 100+ times a day. Connecting your AI agent to iMessage or SMS means it lives where you already pay attention.

## iMessage vs SMS

| Feature | iMessage | SMS (Twilio) |
|---------|----------|--------------|
| Cost | Free | ~$0.0075/msg |
| Number rental | Free | ~$1.15/mo |
| Works on | Apple only | Any phone |
| Needs Mac | Yes | No |
| Rich media | Images, tapbacks, effects | Text only |
| Encryption | End-to-end | Plain text |
| Setup | Medium | Easy |

**Short answer:** iMessage if you're all on Apple. SMS if you need anyone with a phone to text your agent.

## iMessage Setup

OpenClaw uses native macOS `imsg` bridge. Needs:
- A Mac that stays on (Mac Mini works)
- Messages app signed in with Apple ID
- Full disk access for Gateway
- `imsg` CLI installed

### Gateway on the Mac
```json
{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "/usr/local/bin/imsg",
      "dmPolicy": "pairing"
    }
  }
}
```

### Gateway on Linux/Windows (SSH to Mac)
```json
{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "ssh user@mac.local /usr/local/bin/imsg",
      "dmPolicy": "pairing"
    }
  }
}
```

## SMS Setup with Twilio

Needs:
- Twilio account with SMS-capable number
- Account SID and Auth Token
- Public HTTPS URL for webhook
- $5-15/month budget

### Step 1: Get Twilio Number
Sign up at twilio.com, buy SMS number, save Account SID, Auth Token, phone number.

### Step 2: Configure
```json
{
  channels: {
    sms: {
      enabled: true,
      accountSid: "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      authToken: "twilio-auth-token",
      fromNumber: "+15551234567",
      publicWebhookUrl: "https://gateway.example.com/webhooks/sms",
      dmPolicy: "pairing"
    }
  }
}
```

Apply: `openclaw config patch --file sms.patch.json5`

### Step 3: Point Twilio
In Twilio Messaging settings, set "A message comes in" to your webhook URL with HTTP POST.

### Step 4: Test
Text your Twilio number, approve pairing, start chatting.

## Real Use Cases

**Personal:** morning briefs, quick research, reminders, receipt OCR, crypto alerts.
**Business:** SMS support drafts, field check-ins, appointment confirmations, lead qualification, two-way surveys.

## Cost Breakdown

| Setup | Monthly | Notes |
|-------|---------|-------|
| iMessage own Mac | $0 + power | Mac stays on |
| iMessage hosted Mac | $25-50 | Plus hosting |
| SMS light (10/day) | ~$5 | + number rental |
| SMS heavy (50/day) | ~$15 | + number rental |
| Ampere.sh managed | $39 | iMessage included |

## Common Issues

- iMessage not receiving: check Mac signed in, full disk access granted
- SMS webhook errors: ensure public URL reaches Gateway
- Sends but no receive: macOS sleeping - disable sleep
- Twilio bill high: check dmPolicy (use "pairing" not "open")
- Group iMessage broken: run `imsg launch` manually

## Run Both Channels

OpenClaw routes each conversation independently. Apple users use free iMessage, others use SMS through Twilio.

## FAQ

**Both iMessage and SMS?**
Yes, both supported. iMessage uses native macOS bridge, SMS uses Twilio.

**Difference?**
iMessage free + rich features on Apple. SMS works on any phone but costs per message.

**Need a Mac?**
For iMessage, yes. SMS works without.

**Cost?**
iMessage free. SMS $5-15/mo personal use.

---

Start free: https://www.ampere.sh/setup