← 返回 Skills 市场
googleworkspace-bot

Gws Admin Reports

作者 googleworkspace-bot · GitHub ↗ · v1.0.13 · MIT-0
cross-platform ⚠ suspicious
483
总下载
0
收藏
13
当前安装
14
版本数
在 OpenClaw 中安装
/install gws-admin-reports
功能描述
Google Workspace Admin SDK: Audit logs and usage reports.
使用说明 (SKILL.md)

admin-reports (reports_v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

gws admin-reports \x3Cresource> \x3Cmethod> [flags]

API Resources

activities

  • list — Retrieves a list of activities for a specific customer's account and application such as the Admin console application or the Google Drive application. For more information, see the guides for administrator and Google Drive activity reports. For more information about the activity report's parameters, see the activity parameters reference guides.
  • watch — Start receiving notifications for account activities. For more information, see Receiving Push Notifications.

channels

  • stop — Stop watching resources through this channel.

customerUsageReports

  • get — Retrieves a report which is a collection of properties and statistics for a specific customer's account. For more information, see the Customers Usage Report guide. For more information about the customer report's parameters, see the Customers Usage parameters reference guides.

entityUsageReports

  • get — Retrieves a report which is a collection of properties and statistics for entities used by users within the account. For more information, see the Entities Usage Report guide. For more information about the entities report's parameters, see the Entities Usage parameters reference guides.

userUsageReport

  • get — Retrieves a report which is a collection of properties and statistics for a set of users with the account. For more information, see the User Usage Report guide. For more information about the user report's parameters, see the Users Usage parameters reference guides.

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods
gws admin-reports --help

# Inspect a method's required params, types, and defaults
gws schema admin-reports.\x3Cresource>.\x3Cmethod>

Use gws schema output to build your --params and --json flags.

安全使用建议
This skill appears to be a wrapper for a 'gws' CLI that calls Google Workspace reporting APIs, but it does not state how authentication is provided. Before installing or enabling it: (1) verify the provenance and integrity of the 'gws' binary on your system (where did it come from?), (2) inspect the referenced ../gws-shared/SKILL.md (or the output of 'gws generate-skills') to see what credentials, files, or global flags it will read or create, (3) ensure any Google service account or OAuth credentials used are scoped minimally (least privilege) and stored safely, (4) run the skill in a sandboxed/test environment first to observe file writes and network calls, and (5) if you cannot inspect the external shared SKILL.md or the gws binary, treat this as untrusted and avoid enabling autonomous use. If the author supplies the shared auth file contents or the skill declares the exact env vars/config it will use, the assessment could be upgraded to benign.
功能分析
Type: OpenClaw Skill Name: gws-admin-reports Version: 1.0.13 The skill bundle is a standard interface for the Google Workspace Admin SDK (Reports API), providing access to audit logs and usage reports via a 'gws' CLI tool. The SKILL.md file contains legitimate documentation for API resources like activities and usage reports without any evidence of malicious instructions, data exfiltration, or obfuscation.
能力评估
Purpose & Capability
Name/description align with Google Workspace Admin SDK reporting and the declared required binary (gws) is plausible for that purpose. However, a reporting skill would normally require Google auth credentials (OAuth client or service account) or at least document how authentication is provided; the skill declares no env vars or primary credential, creating a gap between purpose and declared requirements.
Instruction Scope
SKILL.md is instruction-only and primarily tells the agent to run the 'gws' CLI and to "Read ../gws-shared/SKILL.md for auth, global flags, and security rules." That directs the agent to a file outside this skill's bundle for authentication and security rules, which is vague and can expand the agent's scope unexpectedly (reading local or project config, creating files via 'gws generate-skills'). The instructions don't explicitly limit what files or environment values 'gws' may access.
Install Mechanism
No install spec and no code files — lowest-risk format. The skill requires a gws binary to already exist; risk therefore depends on where that binary comes from, but the skill itself won't install code.
Credentials
No environment variables or primary credential are declared, yet Google Workspace APIs require authenticated access. The SKILL.md's reliance on an external shared SKILL.md implies credentials/config are handled elsewhere, but those credentials are not documented here. This omission is disproportionate and obscures what secrets the agent will need or access at runtime.
Persistence & Privilege
always is false and there are no install scripts, config paths, or claims to modify other skills. The one persistence-related note is that the instructions suggest running 'gws generate-skills', which could write files to disk — but that behavior is delegated to the gws binary and is not documented in this skill.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install gws-admin-reports
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /gws-admin-reports 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.13
- Updated version in SKILL.md from 0.22.4 to 0.22.5. - No changes to commands, features, or descriptive content.
v1.0.12
- Updated skill metadata version from 0.22.3 to 0.22.4 in SKILL.md. - No functional or documentation changes beyond the metadata version update.
v1.0.11
- Bumped metadata version from 0.22.2 to 0.22.3 in SKILL.md.
v1.0.10
- Updated skill metadata version from 0.22.1 to 0.22.2 in SKILL.md. - No functional or documentation changes besides the version bump.
v1.0.9
- Updated version metadata from 0.22.0 to 0.22.1 in SKILL.md. - No functional or documentation changes to API resource usage or instructions.
v1.0.8
- Updated metadata version from 0.21.2 to 0.22.0 in SKILL.md. - No functional or documentation changes to API descriptions or usage instructions.
v1.0.7
- Updated skill metadata version from 0.21.1 to 0.21.2 in SKILL.md.
v1.0.6
- Updated metadata version to 0.21.1 in SKILL.md. - No functional or command changes; documentation version updated only.
v1.0.5
- Updated version in metadata from 0.20.0 to 0.20.1 in SKILL.md.
v1.0.4
- Updated version metadata from 0.19.0 to 0.20.0 in SKILL.md.
v1.0.3
- Updated metadata structure in SKILL.md to include version under metadata and removed top-level version. - Set metadata version to 0.19.0 and removed the previous version entry. - No functional or command changes; documentation metadata only.
v1.0.2
- Updated formatting in the metadata section of SKILL.md for consistency (uses YAML list format for bins). - No changes to user-facing functionality or documentation content.
v1.0.1
- Expanded the API resource descriptions in SKILL.md to include additional links to relevant guides and parameter reference documentation. - No changes to the skill's functionality or command syntax.
v1.0.0
Initial release of gws-admin-reports. - Adds commands for accessing Google Workspace Admin SDK audit logs and usage reports. - Supports activities (list, watch), channels (stop), customerUsageReports (get), entityUsageReports (get), and userUsageReport (get). - Includes CLI help and usage instructions. - Requires the `gws` binary.
元数据
Slug gws-admin-reports
版本 1.0.13
许可证 MIT-0
累计安装 13
当前安装数 13
历史版本数 14
常见问题

Gws Admin Reports 是什么?

Google Workspace Admin SDK: Audit logs and usage reports. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 483 次。

如何安装 Gws Admin Reports?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install gws-admin-reports」即可一键安装,无需额外配置。

Gws Admin Reports 是免费的吗?

是的,Gws Admin Reports 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Gws Admin Reports 支持哪些平台?

Gws Admin Reports 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Gws Admin Reports?

由 googleworkspace-bot(@googleworkspace-bot)开发并维护,当前版本 v1.0.13。

💬 留言讨论