Overview

This guide walks you through connecting OpenRouter to iMessage using OpenClaw. You'll learn how to configure authentication, set up the channel, and deploy your AI assistant.

OpenRouter Features

  • Access to 100+ models
  • Unified billing
  • Model comparison
  • Automatic fallbacks

iMessage Capabilities

  • Direct messages
  • Group chats
  • Media support

Step 1: Configure OpenRouter

OpenRouter API key

  1. Create account at openrouter.ai
  2. Generate API key
  3. Set OPENROUTER_API_KEY environment variable

Environment variable: OPENROUTER_API_KEY

Step 2: Configure iMessage

  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

Step 3: Combined Configuration

Add both configurations to your openclaw.json:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/anthropic/claude-sonnet-4"
      }
    }
  },
  "models": {
    "providers": {
      "openrouter": {
  "models": {
    "providers": {
      "openrouter": {
        "apiKey": "${OPENROUTER_API_KEY}
    }
  },
  "channels": {
    "imessage": {
      "enabled": true,
      "dmPolicy": "pairing",
      "allowFrom": ["friend@icloud.com"]
    }
  }
}
}

Step 4: Start the Gateway

# Start the gateway
openclaw gateway start

# Check status
openclaw status

# View logs
openclaw logs --follow

Access Control

iMessage supports the following access control policies:

DM Policies

Policy Description
allowlist Only senders in allowFrom list are processed
pairing Unknown senders receive a pairing code; admin must approve
open All DMs are processed (requires allowFrom: ["*"])

Group Policies

Policy Description
allowlist Only groups in groupAllowFrom are processed
open All groups are processed

Deploy Options

Choose how to deploy your OpenRouter + iMessage setup:

Local Deployment

Run on your personal machine with local-only access

View Guide →

VPS Deployment

Always-on deployment on a Linux VPS

View Guide →

Cloud Deployment

Managed container deployment on Fly.io or similar

View Guide →

Docker Deployment

Containerized deployment with Docker

View Guide →

Frequently Asked Questions

How do I set up OpenRouter with iMessage?
Configure OpenRouter as your AI provider and enable iMessage as a channel in openclaw.json. The gateway routes iMessage messages to OpenRouter for processing automatically.
Is OpenRouter a good choice for iMessage bots?
OpenRouter works great with iMessage. Single API for multiple providers and Easy model switching make it well-suited for Personal AI assistant and Family communication.