GA4 Connector — GA4数据连接器
v0.1.1通过 Google Analytics Data API 查询 Google Analytics 4 (GA4) 数据，用于趋势、国家/地区、来源、页面和转化分析。适用于需要在 OpenClaw 中获取 GA/GA4 指标、设置 GA4 访问权限或生成 GA4 报告（如活跃用户、会话、国家/来源分布、页面趋势或关键事件分析）的场景。
1· 193·0 当前·0 累计
by 安全扫描
OpenClaw
安全
high confidence该技能的代码和指令与其 GA4 Data API 用途相符：使用 OAuth 用户授权、安装 Google 客户端库，并在 ~/.config/openclaw 下存储客户端 JSON 和 OAuth token——捆绑包中没有看起来不成比例或与查询 GA4 无关的内容。
评估建议
该技能似乎能实现其所述功能（通过 Google Analytics Data API 连接到 GA4）。安装前请审查并考虑：1) 安装程序会将你的 Desktop OAuth 客户端 JSON 复制到 ~/.config/openclaw，并在 ~/.config/openclaw/ga4-token.json 创建 OAuth token——两者都授予 GA 数据访问权限，应保持私密。2) 安装程序会在你的 shell rc（~/.bashrc 或 ~/.zshrc）中添加 export GA4_PROPERTY_ID 行；先备份该文件，如果你不想修改环境，请检查该更改。3) 脚本运行 `python3 -m pip install --user google-analytics-data google-auth-oauthlib google-auth-httplib2`——这会将 Python 包安装到你的用户环境并需要网络访问；如果你愿意，可以手动检查或运行这些命令。4) OAuth 流程会打开浏览器；确保授权正确的 Google 账户（该账户具有 GA4 属性访问权限）。5)...详细分析 ▾
✓ 用途与能力
名称/描述声称可访问 GA4 Data API；包含的脚本实现了 OAuth InstalledAppFlow，调用 google.analytics.data 客户端，并提供查询示例。所需行为（客户端密钥、token 缓存、属性 ID）均符合声明的用途。
ℹ 指令范围
SKILL.md 和脚本专注于 GA4 设置和查询。指导安装 Python 包、将 OAuth 客户端 JSON 复制到 ~/.config/openclaw、执行 OAuth 浏览器流程，以及在 ~/.config/openclaw/ga4-token.json 存储 token。这些操作在预期范围内，但属于持久化的文件系统和 shell 配置更改（见持久化）。
✓ 安装机制
无外部任意下载；安装脚本使用 `python3 -m pip install --user` 安装知名的 google-auth 和 analytics 包。未从不可信 URL 获取压缩包或远程可执行文件。这是 Python 连接器的典型低风险安装路径。
ℹ 凭证需求
代码仓库元数据未列出所需的环境变量，但代码接受通过环境变量/参数传入的 GA4_PROPERTY_ID，安装程序将 `export GA4_PROPERTY_ID=...` 写入用户 shell rc。技能需要本地存储客户端密钥 JSON 和 OAuth token 并使其持久化——这些是敏感信息，应像凭证一样对待。此请求与其功能相称，但用户必须保护这些文件。
ℹ 持久化与权限
技能并非始终启用，也不请求提升的系统权限。它会修改用户的 shell rc 来导出 GA4_PROPERTY_ID，并将文件写入 ~/.config/openclaw（客户端密钥和 token）以及将 Python 包安装到用户站点。这些对于连接器是预期的，但属于持久化更改，用户运行前应检查。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv0.1.12026/3/12
- 将技能从 "ga4-data-api" 重命名为 "ga4-connector"。- 功能、文档或设置说明未做任何更改。
● 无害
安装命令 点击复制
官方npx clawhub@latest install ga4-connector
镜像加速npx clawhub@latest install ga4-connector --registry https://cn.clawhub-mirror.com
技能文档
使用此技能通过 OAuth 用户授权设置和查询 GA4。
默认方法
优先使用 OAuth 用户授权。使用 scripts/install_ga4_openclaw.sh + scripts/ga4_query.py 作为常规路径。只有在明确需要无头/服务器端访问时，才建议使用服务账户。
硬性规则
- 设置前检查账户和权限 - 询问哪个 Google 账户实际可以登录 GA 并具有属性/账户访问权限。
- 如实地说明障碍
设置流程
步骤 1 — 验证访问模型
询问/确认：
- 哪个 Google 账户有 GA 访问权限？
- 用户可以登录该账户吗？
- GA4 属性 ID 是什么？
- Google Analytics Data API 是否已启用？
- 是否已有 Desktop OAuth 客户端 JSON？
步骤 2 — 安装并配置凭证
运行：
bash ~/.openclaw/workspace/skills/ga4-data-api/scripts/install_ga4_openclaw.sh
这将安装 Python 依赖项，将 OAuth 客户端 JSON 复制到 ~/.config/openclaw/ga4-client.json，并将 GA4_PROPERTY_ID 写入 shell 配置。
步骤 3 — 首次授权
运行：
python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py \
--metrics activeUsers,sessions \
--dimensions date \
--start 7daysAgo \
--end today \
--pretty
浏览器将打开。用户必须选择与实际拥有 GA 访问权限的相同 Google 账户。成功授权后创建：
~/.config/openclaw/ga4-token.json
步骤 4 — 查询示例
最近趋势：
python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py \
--metrics activeUsers,sessions \
--dimensions date \
--start 7daysAgo \
--end yesterday \
--pretty
国家/地区分布：
python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py \
--metrics activeUsers \
--dimensions country \
--start 7daysAgo \
--end yesterday \
--limit 50 \
--pretty
来源分布：
python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py \
--metrics sessions \
--dimensions sessionSourceMedium \
--start 7daysAgo \
--end yesterday \
--limit 50 \
--pretty
分析指导
对于趋势问题：
- 优先使用完整天数（
end=yesterday），除非用户明确想要当日数据。 - 指出同一天的下降是否只是部分日数据。
对于转化问题：
- 将流量事件与真正的转化事件分开。
- 如果关键事件范围太广，建议在得出产品结论之前缩小事件集。
参考资料
- 当用户需要可共享的设置流程时，请阅读
references/setup.md。 - 使用
scripts/ga4_query.py而不是每次都手写新的 GA SDK 示例。
数据来源：ClawHub ↗ · 中文优化：龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制
免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制