A high-performance automation tool for assembling modular ad components from Supabase and deploying them directly to Facebook Ads Manager.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ad-engine
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install ad-engine using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Ad Engine — Facebook Ads Deployment?
Ad Engine is a specialized utility within the Openclaw Skills ecosystem designed to bridge the gap between structured database content and live social media advertising. It allows developers and marketers to maintain a library of modular ad components—such as hooks, bodies, and calls-to-action—within Supabase tables and programmatically assemble them into high-converting Facebook Ads.
By leveraging the Facebook Marketing API, this skill automates the tedious process of manual campaign creation. It handles everything from image uploads and creative assembly to the generation of Campaign, Ad Set, and Ad structures, ensuring consistency and speed for A/B testing at scale.
Ad Engine — Facebook Ads Deployment Use Cases
- Scaling A/B tests by programmatically generating dozens of ad variations from modular components.
- Synchronizing ad copy stored in a central database with live Facebook Ads Manager campaigns.
- Automating lead generation and message-based ad deployments for high-volume marketing workflows.
- Rapidly previewing assembled ad frameworks before committing spend or pushing live.
How Ad Engine — Facebook Ads Deployment Works
- The system fetches raw message data from the Supabase messages table filtered by the fb_ad content type.
- It resolves component references by cross-referencing keys in the ad_components table.
- Modular text strings are injected into a framework template using a merge-tag system.
- Visual assets are uploaded to the Facebook CDN to generate unique image hashes.
- The skill programmatically constructs the hierarchy of Campaign, Ad Set, and Ad Creative via the SDK.
- Status updates are pushed back to the database, marking the message as deployed and storing the resulting Facebook IDs.
Ad Engine — Facebook Ads Deployment Setup
First, ensure you have a Facebook Business Manager account and a developer app with ads_management permissions. Then, run the initialization command:
python3 scripts/fb_deploy.py --setup
Follow the prompts to enter your long-lived access token, ad account ID, and page ID. Configuration is stored locally in ~/.config/ad-engine/fb_config.json.
Ad Engine — Facebook Ads Deployment Data Schema & Taxonomy
The skill utilizes a relational structure to manage ad modularity:
| Table | Key Fields | Purpose |
|---|---|---|
messages |
id, content_type, extra_data |
Stores the primary ad trigger and reference components. |
ad_components |
key, content, type |
Stores the building blocks (hooks, bodies, CTAs). |
fb_config.json |
access_token, ad_account_id |
Local storage for encrypted API credentials. |
Ad Engine — Facebook Ads Deployment Advanced Features
- Batch Deployment: Deploy an entire campaign's worth of draft ads with a single CLI command.
- Intelligent Image Matching: Automatically maps local image files to specific ad angles based on file naming conventions.
- Dry Run Mode: Validate the entire deployment logic and preview final ad copy without creating live objects in Facebook.
- Real-time Metrics: Retrieve live status and performance data directly from the Facebook API for deployed campaign IDs.
SKILL.md
Loading
Related Openclaw Skills
Graceblocks Integration
A powerful integration skill that allows AI agents to interact with Graceblocks no-code datasets, organizations, and workflows through the Membrane framework.
Stock-Analyzer
A specialized AI skill for analyzing A-share stocks and ETFs using technical indicators to provide trend signals, scores, and real-time market snapshots.
FlowStitch
FlowStitch is an end-to-end AI design team that transforms single-sentence prompts into fully deployed, multi-page React websites with self-correcting quality loops.
ChartGen AI
ChartGen is a powerful AI-driven skill for creating visual charts, dashboards, and automated data reports from spreadsheets or text.
Amazon Keyword Research & Intelligent Classification
An advanced Amazon keyword research tool that uses Sorftime data and LLM agents to collect, clean, and classify over 2000 keywords across 8 strategic dimensions.
AC Milan Match Monitor
A lightweight automation tool that checks for AC Milan match results from the previous day using the ESPN public API and triggers notifications only when a game occurred.
Featured*
