How do I install the Openclaw Google Ads skill?

Run npx skillmds@latest add dvcrn/openclaw-google-ads in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Openclaw Google Ads safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Openclaw Google Ads?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Openclaw Google Ads free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Openclaw Google Ads?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Openclaw Google Ads by dvcrn — Agent Skill

Name: Openclaw Google Ads
Rating: 4.2 (5 reviews)
Author: dvcrn

Openclaw Google Ads

Access and manage Google Ads campaigns, performance metrics, and account data via the Google Ads API for OpenClaw agents. Use when anyone asks about Google Ads campaigns, ad performance, spend, impressions, clicks, conversions, or needs to pull advertising data from Google Ads accounts.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

Google Ads Access for OpenClaw

Use the Google Ads API to pull campaign data, performance metrics, and account information from Google Ads accounts through an OpenClaw agent.

Configuration

Set these environment variables (typically in ~/.openclaw/load-keys.sh or similar):

GOOGLE_ADS_DEVELOPER_TOKEN - Your Google Ads API developer token
GOOGLE_ADS_CLIENT_ID - OAuth client ID from Google Cloud
GOOGLE_ADS_CLIENT_SECRET - OAuth client secret from Google Cloud
GOOGLE_ADS_REFRESH_TOKEN - OAuth refresh token (obtained via authentication script)
GOOGLE_ADS_MANAGER_ACCOUNT_ID - Your Google Ads Manager Account ID (optional, for MCC access)
GOOGLE_ADS_CLIENT_ACCOUNT_ID - Specific client account ID to query (optional)

Quick Start

1. Install Dependencies

pip3 install google-ads google-auth-oauthlib google-auth

2. Authenticate

Run the authentication script to get a refresh token:

python3 scripts/authenticate.py

This will output a refresh token. Add it to your environment:

export GOOGLE_ADS_REFRESH_TOKEN="your-refresh-token-here"

3. Test Connection

python3 scripts/get_account_summary.py --account YOUR-ACCOUNT-ID

Available Scripts

List Campaigns

python3 scripts/get_campaigns.py --account YOUR-ACCOUNT-ID

Get Account Performance Summary

python3 scripts/get_account_summary.py --account YOUR-ACCOUNT-ID --days 30

Run Custom GAQL Queries

python3 scripts/gaql_query.py --account YOUR-ACCOUNT-ID --query "SELECT campaign.id, campaign.name, metrics.impressions FROM campaign WHERE segments.date DURING LAST_30_DAYS"

Google Ads Setup Requirements

Google Ads Account with API access enabled
Manager Account (MCC) recommended for multiple client accounts
OAuth Credentials in Google Cloud Console
Developer Token from Google Ads API Center

Enabling API Access

Go to ads.google.com
Navigate to Tools & Settings > Setup > API Center
Apply for API access (Basic Access required for production use)
Note your Developer Token

Setting Up OAuth

Go to Google Cloud Console
Create or select a project
Enable Google Ads API
Go to APIs & Services > Credentials
Create OAuth 2.0 credentials (Desktop app)
Download the client secrets JSON
Add the Google Ads scope: https://www.googleapis.com/auth/adwords

GAQL Reference

See references/gaql-examples.md for common query patterns and examples.

Data Privacy

All customer data should be scrubbed for PII before sharing
Never commit credentials to version control
Use environment variables or secure credential storage

---name: openclaw-google-adsdescription: Access and manage Google Ads campaigns, performance metrics, and account data via the Google Ads API for OpenClaw agents. Use when anyone asks about Google Ads campaigns, ad performance, spend, impressions, clicks, conversions, or needs to pull advertising data from Google Ads accounts.---# Google Ads Access for OpenClawUse the Google Ads API to pull campaign data, performance metrics, and account information from Google Ads accounts through an OpenClaw agent.## ConfigurationSet these environment variables (typically in `~/.openclaw/load-keys.sh` or similar):- `GOOGLE_ADS_DEVELOPER_TOKEN` - Your Google Ads API developer token- `GOOGLE_ADS_CLIENT_ID` - OAuth client ID from Google Cloud- `GOOGLE_ADS_CLIENT_SECRET` - OAuth client secret from Google Cloud- `GOOGLE_ADS_REFRESH_TOKEN` - OAuth refresh token (obtained via authentication script)- `GOOGLE_ADS_MANAGER_ACCOUNT_ID` - Your Google Ads Manager Account ID (optional, for MCC access)- `GOOGLE_ADS_CLIENT_ACCOUNT_ID` - Specific client account ID to query (optional)## Quick Start### 1. Install Dependencies```bashpip3 install google-ads google-auth-oauthlib google-auth```### 2. AuthenticateRun the authentication script to get a refresh token:```bashpython3 scripts/authenticate.py```This will output a refresh token. Add it to your environment:```bashexport GOOGLE_ADS_REFRESH_TOKEN="your-refresh-token-here"```### 3. Test Connection```bashpython3 scripts/get_account_summary.py --account YOUR-ACCOUNT-ID```## Available Scripts### List Campaigns```bashpython3 scripts/get_campaigns.py --account YOUR-ACCOUNT-ID```### Get Account Performance Summary```bashpython3 scripts/get_account_summary.py --account YOUR-ACCOUNT-ID --days 30```### Run Custom GAQL Queries```bashpython3 scripts/gaql_query.py --account YOUR-ACCOUNT-ID --query "SELECT campaign.id, campaign.name, metrics.impressions FROM campaign WHERE segments.date DURING LAST_30_DAYS"```## Google Ads Setup Requirements1. **Google Ads Account** with API access enabled2. **Manager Account (MCC)** recommended for multiple client accounts3. **OAuth Credentials** in Google Cloud Console4. **Developer Token** from Google Ads API Center### Enabling API Access1. Go to [ads.google.com](https://ads.google.com)2. Navigate to **Tools & Settings > Setup > API Center**3. Apply for API access (Basic Access required for production use)4. Note your **Developer Token**### Setting Up OAuth1. Go to [Google Cloud Console](https://console.cloud.google.com)2. Create or select a project3. Enable **Google Ads API**4. Go to **APIs & Services > Credentials**5. Create OAuth 2.0 credentials (Desktop app)6. Download the client secrets JSON7. Add the Google Ads scope: `https://www.googleapis.com/auth/adwords`## GAQL ReferenceSee `references/gaql-examples.md` for common query patterns and examples.## Data Privacy- All customer data should be scrubbed for PII before sharing- Never commit credentials to version control- Use environment variables or secure credential storage

Frequently asked questions