Overview

This guide shows you how to connect Google Gemini to Signal using OpenClaw. You'll configure the messaging channel, set up AI provider authentication, and deploy your assistant.

Signal Capabilities

Direct messages
Group chats
Media support
Reactions

Google Gemini Features

1M token context window
Multimodal understanding
Fast inference
Competitive pricing

Step 1: Configure Signal

Install signal-cli on your system
Register or link a Signal account
Start signal-cli daemon
Configure signal in openclaw.json
Start OpenClaw gateway

Step 2: Configure Google Gemini

Google AI API key

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

Environment variable: GOOGLE_API_KEY

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": {
    "signal": {
      "account": "+15551234567",
      "dmPolicy": "pairing",
      "allowFrom": ["+15559876543"]
    }
  }
}
}

Step 4: Start and Test

# Start the gateway
openclaw gateway start

# Check connection status
openclaw status

# View real-time logs
openclaw logs --follow

Access Control

Signal 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: ["*"])