Channel Capabilities

Feature Supported Notes
Direct Messages ✓ Full support for 1:1 conversations
Group Chats ✓ Participate in group conversations
Media Messages ✓ Send and receive images, files
Voice Messages ✓ Audio message support
Reactions — Not available
Threads — Not available
Native Commands — Not available

Access Control Policies

DM Policies

Control who can send direct messages to your bot:

allowlist

Only senders in the allowFrom list can interact with the bot.

pairing

Unknown senders receive a pairing code that admin must approve before access is granted.

open

All direct messages are processed (requires allowFrom: ["*"]).

Group Policies

Control which groups your bot participates in:

allowlist

Only groups in groupAllowFrom are processed.

open

Bot responds in all groups it is added to.

Setup Guide

  1. Ensure you're running macOS with Messages app
  2. Grant Full Disk Access to Terminal/Node
  3. Enable imessage in openclaw.json
  4. Start the gateway
  5. Send a test message to trigger pairing

Configuration Example

{
  "channels": {
    "imessage": {
      "enabled": true,
      "dmPolicy": "pairing",
      "allowFrom": ["friend@icloud.com"]
    }
  }
}

Use iMessage with AI Providers

Connect iMessage to your preferred AI model provider:

Anthropic

Creator of Claude AI models with advanced reasoning capabilities

View Guide →

OpenAI Codex

GPT models with broad capabilities and wide ecosystem support

View Guide →

Google Gemini

Multimodal AI with competitive pricing and speed

View Guide →

OpenRouter

Unified API gateway to multiple AI providers

View Guide →

Ollama

Run open-source LLMs locally with no API costs

View Guide →

AWS Bedrock

Enterprise AI through AWS with compliance and security

View Guide →

OpenAI (Standard)

Standard OpenAI API for GPT models

View Guide →

Frequently Asked Questions

How do I set up iMessage with OpenClaw?
To set up iMessage: Ensure you're running macOS with Messages app. Grant Full Disk Access to Terminal/Node. Enable imessage in openclaw.json. Full configuration options are available in the openclaw.json file.
How do I control who can message my iMessage bot?
iMessage supports allowlist, pairing, open for DM access control and allowlist, open for groups. Use allowlists for maximum security or pairing mode for easy onboarding.
Does iMessage support media messages?
iMessage supports media including images, audio, video, documents. Maximum media size is configurable via mediaMaxMb setting (default: 4.096MB).
Can I use OpenClaw in iMessage groups?
iMessage supports group chats with configurable access policies. Groups and DMs are supported.