← 返回 Skills 市场
Openclaw Google Ads
作者
Sebastian The Claw
· GitHub ↗
· v0.2.0
· MIT-0
591
总下载
1
收藏
1
当前安装
3
版本数
在 OpenClaw 中安装
/install 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...
安全使用建议
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).
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install openclaw-google-ads - 安装完成后,直接呼叫该 Skill 的名称或使用
/openclaw-google-ads触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 591 次。
如何安装 Openclaw Google Ads?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install openclaw-google-ads」即可一键安装,无需额外配置。
Openclaw Google Ads 是免费的吗?
是的,Openclaw Google Ads 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Openclaw Google Ads 支持哪些平台?
Openclaw Google Ads 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Openclaw Google Ads?
由 Sebastian The Claw(@sebclawops)开发并维护,当前版本 v0.2.0。
推荐 Skills