Overview

This guide shows you how to connect OpenAI (Standard) to WhatsApp using OpenClaw. You'll configure the messaging channel, set up AI provider authentication, and deploy your assistant.

WhatsApp Capabilities

Direct messages
Group chats
Media support

OpenAI (Standard) Features

Standard OpenAI access
GPT-4o models
Simple setup
Wide compatibility

Step 1: Configure WhatsApp

Enable WhatsApp in your openclaw.json configuration
Start the OpenClaw gateway with 'openclaw gateway start'
Scan the QR code displayed in terminal with WhatsApp mobile app
Wait for authentication to complete
Configure DM policy and allowlist for access control

Step 2: Configure OpenAI (Standard)

Standard API key only

Create account at platform.openai.com
Generate API key
Set OPENAI_API_KEY environment variable

Environment variable: OPENAI_API_KEY

Step 3: Combined Configuration

Add both configurations to your openclaw.json:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/gpt-4o"
      }
    }
  },
  "models": {
    "providers": {
      "openai": {
  "models": {
    "providers": {
      "openai": {
        "apiKey": "${OPENAI_API_KEY}
    }
  },
  "channels": {
    "whatsapp": {
      "enabled": true,
      "dmPolicy": "pairing",
      "allowFrom": ["[email protected]"],
      "groupPolicy": "allowlist",
      "mediaMaxMb": 5
    }
  }
}
}

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

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