OpenClaw Facebook Ads Setup Guide 2026 — Complete Installation & Configuration

Step 01

Clone the OpenClaw Repository

Open Terminal and navigate to your preferred installation directory. Clone the official OpenClaw repository from GitHub and enter the project folder:

You should see folders like src/, config/, docs/, and files like package.json and README.md. If the clone fails, verify you have git installed and internet connectivity.

Step 02

Install Node.js Dependencies

Install all required packages using npm. The process downloads around 150MB of dependencies and typically takes 2-3 minutes on a stable internet connection:

npm install should complete without errors. If you see permission errors, try prefixing with sudo or use nvm to manage Node.js versions. The audit fix command resolves any security vulnerabilities.

Step 03

Configure Environment Variables

Copy the example environment file and open it for editing. This file will contain all your API keys and configuration settings:

Leave the .env file open — you will populate it with API credentials in the next section. Use nano, vim, or any text editor you prefer.

Step 01

Create a Facebook App

Go to developers.facebook.com, click "Create App," and select "Business" as the app type. Name your app something descriptive like "OpenClaw Automation - [Your Business Name]" and provide your business email. Facebook will generate an App ID and App Secret — save these immediately.

Step 02

Request Marketing API Permissions

In your Facebook App dashboard, go to App Review > Permissions and Features. Request the following permissions: ads_read (to fetch campaign data), ads_management (to make optimization changes), and business_management (to access multiple ad accounts). Each permission requires a brief use case description.

Step 03

Generate Access Tokens

Use Facebook's Access Token Debugger to generate a long-lived User Access Token (valid for 60 days) and exchange it for a long-lived Page Access Token (doesn't expire). The process involves several API calls — OpenClaw includes a helper script to automate token generation and refresh.

Step 04

Update Environment Variables

Add your Facebook credentials to the .env file. Replace the placeholder values with your actual tokens and IDs:

The Ad Account ID should include the "act_" prefix. You can find it in Facebook Ads Manager > Account Settings > Business Info.

Step 01

Install WhatsApp Dependencies

OpenClaw uses Puppeteer to automate WhatsApp Web interactions. Install the additional dependencies and browser components:

Step 02

Configure WhatsApp Settings

Add WhatsApp configuration to your .env file. The authorized numbers list controls who can send commands to OpenClaw:

Step 03

Initialize WhatsApp Connection

Start the OpenClaw WhatsApp service and scan the QR code with your phone to link the session:

The QR code expires after 60 seconds. If it times out, restart the command. Once connected, OpenClaw saves the session locally and reconnects automatically.

Step 04

Test the Integration

Send a test message to the connected WhatsApp number from your authorized phone number. OpenClaw should respond with available commands:

Workflow 01

Weekly Performance Report

Generates a comprehensive performance summary including spend, ROAS, CPA trends, top-performing campaigns, and budget utilization. The report covers the last 7 days with comparisons to the previous week and month. Perfect for client reporting or internal stakeholder updates.

Workflow 02

Creative Fatigue Detection

Analyzes all active ads for declining CTR, rising frequency, and decreasing relevance scores. Identifies ads that need creative refresh within the next 7-14 days and provides specific recommendations for replacement strategy. Prevents the 15-25% CPA increase caused by creative fatigue.

Workflow 03

Budget Optimization Analysis

Calculates marginal ROAS for each campaign and recommends budget reallocation to maximize overall performance. Identifies campaigns that are budget-constrained (missing profitable conversions) versus campaigns with excess budget generating diminishing returns.

Workflow 04

Audience Overlap Detection

Identifies ad sets targeting similar audiences that compete against each other in Facebook's auction system. Provides overlap percentage estimates and recommends consolidation or exclusion strategies to reduce CPM inflation by 8-20%.

Workflow 05

A/B Test Analysis

Evaluates running A/B tests for statistical significance, confidence intervals, and sample size adequacy. Calls winners when results are statistically valid and recommends continued testing duration for inconclusive tests.

Workflow 06

Placement Performance Review

Compares performance across Facebook feed, Instagram Stories, Audience Network, and other placements. Identifies which placements drive the lowest CPA and highest ROAS for specific campaign objectives and recommends placement optimization strategies.

Workflow 07

Conversion Window Analysis

Analyzes conversion attribution across 1-day, 7-day, and 28-day click windows to identify optimal attribution settings for your business model. Particularly valuable for longer sales cycles or high-consideration purchases where conversions happen days after initial ad interaction.

Workflow 08

Lookalike Audience Audit

Reviews all lookalike audiences for freshness, performance, and optimal percentage sizing. Identifies lookalikes built on outdated seed data (> 90 days old) and compares 1%, 2%, 5%, and 10% lookalike performance to recommend the best sizing for your account.

Workflow 09

Frequency Cap Monitoring

Monitors ad frequency across all active campaigns and alerts when frequency exceeds optimal thresholds (typically 2.5-3.5 for most verticals). High frequency leads to ad fatigue, increased negative feedback, and rising CPMs.

Workflow 10

Competitive CPM Benchmarking

Compares your account's CPM trends against industry benchmarks and identifies unusual spikes that might indicate increased competition, auction changes, or targeting issues. Helps contextualize performance changes within broader market conditions.