← Back to Skills Marketplace
Openclaw Google Ads
by
Sebastian The Claw
· GitHub ↗
· v0.2.0
· MIT-0
591
Downloads
1
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install openclaw-google-ads
Description
Shared Google Ads API skill for OpenClaw agents. Query account, campaign, ad group, keyword, search term, and performance data with local scripts and GAQL ex...
Usage Guidance
This skill appears to be a legitimate Google Ads reporting/audit utility, but exercise caution before installing or running it:
- The registry metadata does NOT declare the environment variables the scripts actually require. Expect to need at least: GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, and optionally manager/client account IDs. Treat these as sensitive and provide them via your secure runtime secret injection, not by pasting into files.
- The authenticate.py script prints the refresh token to stdout so you can copy it into secure storage. Do not run that in a context where console output is captured or sent to chat/logs you don't control. Prefer running it in a secure terminal and immediately storing the token in your vault.
- Review the code (it's short and included) and confirm you trust the unknown publisher and the environment where you will run it; the repo has no homepage/source contact. Verify your logging and agent capture settings to ensure tokens and PII are not accidentally forwarded.
- Install dependencies (requirements.txt) in an isolated environment if you decide to run anything. Consider running read-only scripts first (get_account_summary, gaql_query) and require explicit human approval before making any live changes.
If you want higher assurance, ask the publisher to update the registry metadata to list the required env vars and to change authenticate.py to avoid printing secrets directly (for example, prompt to store the token into a secure credential store instead).
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-google-ads
Version: 0.2.0
The skill bundle provides a legitimate and well-structured interface for interacting with the Google Ads API, focusing on reporting, auditing, and performance analysis. The Python scripts (e.g., authenticate.py, gaql_query.py) follow standard Google Ads API implementation patterns, and the SKILL.md instructions explicitly enforce safety protocols, such as a 'read-only' default stance and requiring explicit approval for account changes. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
The skill's name, SKILL.md, references, and scripts consistently implement Google Ads reporting and GAQL querying. However the registry metadata lists no required environment variables or primary credential while the included references and scripts clearly expect Google Ads credentials (developer token, client id/secret, refresh token, optional manager/client IDs). The metadata omission is an incoherence that could mislead users about what secrets the skill needs.
Instruction Scope
SKILL.md gives scoped, read-first instructions and requires explicit approval for live changes. It correctly points to reference docs and scripts for repeatable queries. A risk: scripts/authenticate.py prints the obtained refresh token to stdout (so an operator can copy it), which contradicts the 'never expose tokens' safety rule in the docs and could leak tokens to logs or chat if the agent captures console output. The browser-fallback is restricted in the docs and is reasonable when API access is unavailable.
Install Mechanism
This is instruction-only (no install spec). There is a requirements.txt (google-ads and google-auth packages) but installation would be a standard pip install by the operator. No arbitrary downloads or extract steps are specified.
Credentials
The skill requires multiple sensitive environment variables (GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, optional account IDs and login_customer_id), as documented in references/api-setup.md and used by the scripts. The registry metadata incorrectly lists no required env vars or primary credential. Requesting these Google Ads secrets is proportionate to the skill's purpose, but the metadata omission is a material mismatch and increases the risk of accidental exposure or misuse.
Persistence & Privilege
always is false and the skill does not request system-wide persistence or attempt to modify other skills or agent settings. The skill runs as-needed scripts and does not claim permanent elevated privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-google-ads - After installation, invoke the skill by name or use
/openclaw-google-ads - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.0
Rebuilt as a shared production-safe Google Ads skill with clearer setup, audit workflows, optimization references, and updated script guidance.
v0.1.1
- Initial release of openclaw-google-ads skill.
- Provides access and management of Google Ads campaigns, performance metrics, and account data via the Google Ads API.
- Includes setup instructions, environment variable configuration, and example scripts for campaign listing, performance summaries, and custom GAQL queries.
v0.1.0
- Initial release of openclaw-google-ads skill.
- Enables OpenClaw agents to access and manage Google Ads campaigns, performance metrics, and account data via the Google Ads API.
- Provides setup instructions for authentication, API access, and environment variables.
- Includes scripts for listing campaigns, retrieving account performance summaries, and running custom GAQL queries.
- Documentation covers API and OAuth setup, data privacy, and GAQL reference.
Metadata
Frequently Asked Questions
What is Openclaw Google Ads?
Shared Google Ads API skill for OpenClaw agents. Query account, campaign, ad group, keyword, search term, and performance data with local scripts and GAQL ex... It is an AI Agent Skill for Claude Code / OpenClaw, with 591 downloads so far.
How do I install Openclaw Google Ads?
Run "/install openclaw-google-ads" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Openclaw Google Ads free?
Yes, Openclaw Google Ads is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Openclaw Google Ads support?
Openclaw Google Ads is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Openclaw Google Ads?
It is built and maintained by Sebastian The Claw (@sebclawops); the current version is v0.2.0.
More Skills