iMessage & SMS Integration Guide

Want to text your AI agent like a friend? OpenClaw connects to both iMessage and SMS. Here's how each one works, what they cost, and which to pick for your setup.

Start with Free Trial

Why Text Your AI Agent?

Most people already check their messages 100+ times a day. Connecting your OpenClaw agent to iMessage or SMS means your AI lives where you already pay attention. No new app, no separate notifications, just a normal conversation thread.

Whether you want morning briefs, alerts, or quick research without opening anything, texting is the lowest-friction interface that exists. And OpenClaw makes it work both ways.

iMessage vs SMS: Which Should You Pick?

OpenClaw supports both, but they're very different. Here's the honest comparison:

Feature	iMessage	SMS (Twilio)
Cost	Free	~$0.0075 per message
Phone number rental	Free (uses your Apple ID)	~$1.15/month (US)
Works on	Apple devices only	Every phone worldwide
Needs a Mac running	Yes	No
Rich media	Images, videos, tapbacks, effects	Text only (MMS extra)
Group chats	Yes, full support	Yes, but limited
Read receipts	Yes	No
Encryption	End-to-end (Apple)	Plain text
Setup difficulty	Medium (needs Mac)	Easy (Twilio account)

Short answer: If you and your contacts are all on Apple devices, use iMessage. It's free and feature-rich. If you need anyone with a phone to be able to text your agent, use SMS.

Setting Up iMessage with OpenClaw

OpenClaw uses a native macOS integration called imsg. It talks to your Messages app directly via JSON-RPC. No separate daemon, no port to open. Just a Mac signed into your Apple ID.

You'll need:

🖥️ A Mac that stays on (Mac Mini works great)
🔐 macOS Messages app signed in with your Apple ID
📋 Full disk access permission for your Gateway process
⚙️ imsg CLI installed and accessible

If Your Gateway Runs on the Mac

This is the simplest case. Add this to your openclaw.json:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "/usr/local/bin/imsg",
      "dmPolicy": "pairing"
    }
  }
}

Restart the Gateway. Send a message to yourself from any iPhone or another Mac to pair, and you're done.

If Your Gateway Runs on Linux or Windows

You still need a Mac somewhere. SSH into it from your Gateway:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "ssh user@mac.local /usr/local/bin/imsg",
      "dmPolicy": "pairing"
    }
  }
}

The Gateway runs imsg on the Mac through SSH. Slightly slower, but works fine. See OpenClaw on iMessage for the full guide.

Skip the Mac entirely?

Ampere.sh managed hosting handles iMessage on a hosted Mac so you don't need one running at home. Try it free for 7 days.

Try Managed iMessage - Free for 7 Days

Setting Up SMS with Twilio

SMS uses Twilio under the hood. You point Twilio at your Gateway via webhook, and replies go back through Twilio's API. Works anywhere your Gateway has a public URL.

You'll need:

📞 A Twilio account with an SMS-capable phone number
🔑 Twilio Account SID and Auth Token
🌐 A public HTTPS URL that reaches your Gateway
💳 ~$5-15/month budget for messages and number rental

Step 1: Get a Twilio Phone Number

Account SID (starts with AC...)
Auth Token
Phone number (e.g. +15551234567)

Step 2: Configure OpenClaw

Save this as sms.patch.json5 with your actual values:

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

Apply it:

openclaw config patch --file ./sms.patch.json5 --dry-run
openclaw config patch --file ./sms.patch.json5

Step 3: Point Twilio at the Gateway

In Twilio's phone number settings, find Messaging → A message comes in. Set it to:

https://gateway.example.com/webhooks/sms

Use HTTP POST. If you're testing locally, expose the webhook with Tailscale Funnel or similar.

Step 4: Send a Test Message

Text your Twilio number from your phone. OpenClaw triggers pairing (DM by default). Approve the sender, then start chatting normally.

What People Actually Use This For

Texting your agent unlocks some surprisingly useful workflows:

🌅 Personal Use

Morning brief texted at 7 AM (calendar + weather + emails)
Quick research without opening a browser
Reminders that show up as normal messages
Photo OCR - send a receipt, get expenses logged
Crypto alerts when prices hit your targets

💼 Business Use

SMS support line that drafts replies for human approval
Field worker check-ins via SMS
Customer appointment confirmations
Lead capture and qualification by text
Two-way SMS surveys with AI follow-up

How Much Does This Actually Cost?

Honest numbers for personal use, sending 10-50 messages per day:

Setup	Monthly Cost	Notes
iMessage on your own Mac	$0 + electricity	Mac stays on 24/7
iMessage on hosted Mac	$25-50/mo	See Mac hosting guide
SMS personal use (light)	~$5/mo	~10 msgs/day + number
SMS personal use (heavy)	~$15/mo	~50 msgs/day + number
SMS business (1000s of msgs)	$50-500/mo	Scales with usage
⭐ Ampere.sh managed	$39/mo flat	iMessage + Mac + setup all included

💡 The Easy Math

Buying a Mac Mini ($600+) and running it 24/7 sounds cheap until you add up the electricity, replacement after 4-5 years, and the hours you spend on setup and maintenance.

Ampere.sh costs $39/mo flat and gets you iMessage on a managed Mac, no purchase, no setup, no babysitting. For most people, this works out cheaper in the first year and way less hassle.

Get iMessage AI for $39/mo - Try Free First

Don't forget AI model costs on top of these. See our cost optimization guide to keep them low.

Common Issues and How to Fix Them

⚠️ iMessage not receiving messages - Check your Mac is signed in to iMessage, Messages app is running, and full disk access is granted
📵 SMS webhook errors in Twilio - Make sure your public URL actually reaches the Gateway. Test with curl first
🔁 iMessage sends but doesn't receive - Could be macOS sleeping. Disable sleep on your Mac Mini
💰 Twilio bill is higher than expected - Check your dmPolicy. "open" lets anyone text you - use "pairing" for personal use
🔒 Group iMessage not working - Group support needs the private API probe to succeed. Run imsg launch once manually

For more, see bot not responding and gateway won't start troubleshooting guides.

Run Both Channels Together

You can run iMessage and SMS at the same time. OpenClaw routes each conversation independently. Your iPhone contacts hit iMessage for free, Android friends use SMS through Twilio, everyone gets the same agent.

This is actually the smart setup for businesses. Save money on Apple users, still serve everyone else. Configure both channels in your config and you're done.

The Easiest Way to Get Started

Look, setting up either of these involves real infrastructure - a Mac running 24/7 or a Twilio account with a webhook. If you just want it to work without thinking about it, Ampere.sh handles everything including a hosted Mac for iMessage.

No Mac purchase, no SSH config, no public URL, no Twilio webhook headaches. Sign up, deploy, start texting your agent. First 7 days are free.

Start Free Trial

Quick Reference

Action	Command
Enable iMessage channel	`openclaw config set channels.imessage.enabled true`
Test iMessage CLI	`imsg --help`
Apply SMS patch config	`openclaw config patch --file sms.patch.json5`
Check active channels	`openclaw gateway status`
Restart Gateway	`openclaw gateway restart`

Frequently Asked Questions

Can OpenClaw send and receive iMessage and SMS?

Yes. OpenClaw supports both channels. iMessage works through a native macOS bridge (you need a signed-in Mac). SMS works through Twilio - any platform, but costs per message.

What's the difference between iMessage and SMS in OpenClaw?

iMessage is free, supports rich media (images, tapbacks, effects), works only on Apple devices, and requires a Mac running. SMS works on every phone in the world, costs ~$0.0075 per message via Twilio, but is text-only with no rich features.

Do I need a Mac to use OpenClaw with iMessage?

Yes. iMessage uses Apple's protocol, which only runs through a signed-in macOS Messages app. Your Gateway can run on Linux or Windows, but it needs to SSH into a Mac to send and receive iMessage.

How much does SMS cost with OpenClaw?

OpenClaw's SMS plugin is free, but Twilio charges per message. US SMS costs about $0.0075 to send and $0.0075 to receive. A US phone number rents for ~$1.15/month. Total: about $5-15/mo for personal use.

Which is better - iMessage or SMS for an AI agent?

iMessage if you're an Apple user and want rich features for free. SMS if you need it to work on any phone, including non-Apple devices, or you want a phone number anyone can text without iMessage.

Can I use both iMessage and SMS at the same time?

Yes. OpenClaw lets you run multiple channels simultaneously. Configure both and your agent routes per chat. Different contacts can reach the same agent through different channels.

Is iMessage in OpenClaw the same as BlueBubbles?

No, BlueBubbles support was removed. OpenClaw now uses the native imsg bridge for iMessage, which is more reliable and supports more features like tapbacks, effects, and attachments.

Can my agent reply to group iMessage chats?

Yes. OpenClaw supports group iMessage with private API actions for replies, tapbacks, effects, and group management. Just configure pairing or allowlist rules for group access.

Also Read

Integration

OpenClaw on iMessage Setup: Complete Integration Guide

Installation

OpenClaw on Telegram: Integrate Your AI Agent with Telegram

Integration

OpenClaw on WhatsApp: Step-by-Step Integration Guide

Written by

Sarah Mitchell

Integration Specialist Writer

Sarah is an API integration specialist with deep expertise in connecting AI agents with messaging platforms and productivity tools. She has architected integrations for Discord, Telegram, WhatsApp, Slack, and Notion, serving over 100,000 users. Passionate about creating seamless automation workflows and developer-friendly APIs.

Text your AI agent today

OpenClaw works with iMessage and SMS so your AI lives where you already text. Skip the setup and try managed hosting on Ampere.sh - 7-day free trial.

Start Free Trial