Overview

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

Google Gemini Features

  • 1M token context window
  • Multimodal understanding
  • Fast inference
  • Competitive pricing

iMessage Capabilities

  • Direct messages
  • Group chats
  • Media support

Step 1: Configure Google Gemini

Google AI API key

  1. Go to ai.google.dev
  2. Create or select a project
  3. Enable the Gemini API
  4. Generate an API key
  5. Set GOOGLE_API_KEY environment variable

Environment variable: GOOGLE_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": "google-gemini/gemini-2.0-flash-exp"
      }
    }
  },
  "models": {
    "providers": {
      "google-gemini": {
  "models": {
    "providers": {
      "google-gemini": {
        "apiKey": "${GOOGLE_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 Google Gemini + 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 Google Gemini with iMessage?
Configure Google Gemini as your AI provider and enable iMessage as a channel in openclaw.json. The gateway routes iMessage messages to Google Gemini for processing automatically.
Is Google Gemini a good choice for iMessage bots?
Google Gemini works great with iMessage. Extremely large context window and Very cost-effective make it well-suited for Personal AI assistant and Family communication.