核心用法
OpenClaw Google Ads 是一套面向多代理共享的 Google Ads API 技能，专注于账户诊断、性能报表与优化建议。核心工作流包括：
- 认证连接：通过
authenticate.py完成 OAuth2 或 Service Account 授权，API Basic Access 即可满足生产需求。 - 数据查询：使用
gaql_query.py执行结构化 GAQL（Google Ads Query Language），支持 campaign、ad group、keyword、search term 等维度拉取。 - 审计报告：调用
get_account_summary.py或get_campaigns.py生成账户健康快照，结合references/audit-workflows.md完成 wasted spend 检查与转化跟踪审查。 - 优化输出：报告遵循「现状→异常→下一步→变更建议」四段式，确保可执行性。
显著优点
- 生产安全：默认只读姿态，所有写操作（暂停、启用、预算调整）需显式审批，降低误操作风险。
- 标准化查询：内置 GAQL 示例库（
gaql-examples.md），减少重复造轮子。 - PII 保护：自动对导出报告中的客户识别数据进行脱敏，符合隐私合规要求。
- 凭证隔离：token 与密钥禁止落入文件或对话，强制外部化配置。
潜在局限
- API 依赖：若凭证失效或权限不足（Basic Access 被拒），技能立即不可用，无降级模拟能力。
- 无自动化优化：仅提供启发式建议（heuristics），不执行自动出价或智能调整，需人工确认。
- UI 回退有限：仅当 API 不可用时才启用浏览器回退（
browser-fallback.md），体验非无缝。 - 学习曲线：GAQL 语法与 Google Ads 对象模型需要一定熟悉度。
适合人群
- 数字营销团队中的数据分析师与投放优化师
- 需要定期审计多账户表现的代理（Agency）技术团队
- 希望将 Google Ads 诊断集成至内部 AI 工作流的产品团队
常规风险
- 凭证泄露：若未按规范外部化配置，存在 refresh_token 或 developer_token 暴露风险。
- 误操作审批：显式审批机制虽存在，但若审批流程流于形式，仍可能执行有害变更。
- 数据滞后：API 数据通常有 3-24 小时延迟，实时性要求高的场景需额外验证。
- API 配额：大规模账户批量查询可能触发 rate limit，需分片或异步处理。