← 返回 Skills 市场
Gws Events
作者
googleworkspace-bot
· GitHub ↗
· v1.0.12
· MIT-0
541
总下载
0
收藏
13
当前安装
13
版本数
在 OpenClaw 中安装
/install gws-events
功能描述
Subscribe to Google Workspace events.
使用说明 (SKILL.md)
events (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws events \x3Cresource> \x3Cmethod> [flags]
Helper Commands
| Command | Description |
|---|---|
+subscribe |
Subscribe to Workspace events and stream them as NDJSON |
+renew |
Renew/reactivate Workspace Events subscriptions |
API Resources
message
stream— SendStreamingMessage is a streaming call that will return a stream of task update events until the Task is in an interrupted or terminal state.
operations
get— Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
subscriptions
create— Creates a Google Workspace subscription. To learn how to use this method, see Create a Google Workspace subscription.delete— Deletes a Google Workspace subscription. To learn how to use this method, see Delete a Google Workspace subscription.get— Gets details about a Google Workspace subscription. To learn how to use this method, see Get details about a Google Workspace subscription.list— Lists Google Workspace subscriptions. To learn how to use this method, see List Google Workspace subscriptions.patch— Updates or renews a Google Workspace subscription. To learn how to use this method, see Update or renew a Google Workspace subscription.reactivate— Reactivates a suspended Google Workspace subscription. This method resets your subscription'sStatefield toACTIVE. Before you use this method, you must fix the error that suspended the subscription. This method will ignore or reject any subscription that isn't currently in a suspended state. To learn how to use this method, see Reactivate a Google Workspace subscription.
tasks
cancel— Cancel a task from the agent. If supported one should expect no more task updates for the task.get— Get the current state of a task from the agent.subscribe— TaskSubscription is a streaming call that will return a stream of task update events. This attaches the stream to an existing in process task. If the task is complete the stream will return the completed task (like GetTask) and close the stream.pushNotificationConfigs— Operations on the 'pushNotificationConfigs' resource
Discovering Commands
Before calling any API method, inspect it:
# Browse resources and methods
gws events --help
# Inspect a method's required params, types, and defaults
gws schema events.\x3Cresource>.\x3Cmethod>
Use gws schema output to build your --params and --json flags.
安全使用建议
This skill is essentially a thin wrapper around a 'gws' CLI. Before installing or invoking it: (1) confirm the 'gws' binary on your system is the official and trusted client and understand how it stores credentials; (2) locate and read the referenced ../gws-shared/SKILL.md to see how auth and global flags are handled — do not run `gws generate-skills` without inspecting what it will create; (3) review any helper SKILLs (subscribe/renew) to see where event payloads are delivered (push endpoints) and what data might be exposed; and (4) if you need higher assurance, ask the skill author for the gws-shared SKILL.md contents or for provenance of the gws CLI. These checks will raise confidence that the skill behaves as advertised.
功能分析
Type: OpenClaw Skill
Name: gws-events
Version: 1.0.12
The skill bundle provides a standard interface for interacting with Google Workspace events via a 'gws' CLI tool. The SKILL.md file contains legitimate API documentation and usage instructions for managing subscriptions and tasks, with no evidence of malicious intent, data exfiltration, or prompt injection.
能力评估
Purpose & Capability
The skill's name and description match the actions described (subscribe/manage Workspace events). It declares the gws CLI as a required binary, which is appropriate. One mismatch: no credentials or env vars are declared even though Google Workspace APIs require auth; the SKILL.md points to a separate ../gws-shared/SKILL.md for auth and security rules, so credentials are likely handled by the shared config or the gws CLI rather than inside this skill.
Instruction Scope
The runtime instructions are limited to using the gws CLI (e.g., gws events <resource> <method>) and to consult sibling SKILL.md files for subscribe/renew helpers. There are no explicit instructions to read arbitrary system files or exfiltrate data. However the SKILL.md tells the agent to read ../gws-shared/SKILL.md for auth and to run `gws generate-skills` if missing — these steps can create files or prompt for credentials, so you should inspect that shared file and understand what generate-skills does before running it.
Install Mechanism
There is no install spec and no code files; this is instruction-only and relies on an existing 'gws' binary. That is the lowest-risk install model, but it shifts trust to the origin and integrity of the gws binary on the host.
Credentials
The skill does not declare any required environment variables or primary credential. While this is plausible if the gws CLI manages auth (user-managed config or OAuth), it is unusual for a Google Workspace integration not to require some credential. Verify where credentials live (the referenced gws-shared SKILL.md or gws config) and ensure no unexpected secrets are created or transmitted when running helper commands like `gws generate-skills`.
Persistence & Privilege
The skill is not always-enabled, does not request elevated persistence, and has no install actions of its own. Autonomous invocation is allowed (platform default), which is expected for skills; nothing indicates it modifies other skills or system-wide settings.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install gws-events - 安装完成后,直接呼叫该 Skill 的名称或使用
/gws-events触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.12
- Updated metadata version from 0.22.4 to 0.22.5 in SKILL.md.
- No changes made to features, commands, or documentation content.
v1.0.11
- Bumped skill metadata version from 0.22.3 to 0.22.4 in SKILL.md.
- No other changes to features, commands, or documentation content.
v1.0.10
- Updated metadata version from 0.22.2 to 0.22.3 in SKILL.md.
- No changes to functionality or commands; documentation update only.
v1.0.9
- Updated skill metadata version from 0.22.1 to 0.22.2 in SKILL.md.
- No other changes to commands, descriptions, or functionality.
v1.0.8
- Bumped the skill metadata version from 0.22.0 to 0.22.1 in SKILL.md.
- No changes to functionality or usage; documentation update only.
- All commands, descriptions, and usage instructions remain the same.
v1.0.7
- Updated metadata version from 0.21.2 to 0.22.0 in SKILL.md.
- No changes to functionality or documentation content beyond the metadata update.
v1.0.6
- Updated version to 0.21.2 in SKILL.md metadata.
- No functional or documentation changes beyond the version bump.
v1.0.5
- Updated skill version from 0.20.1 to 0.21.1 in metadata.
- No functional or documentation changes outside of version increment.
v1.0.4
- Updated skill metadata version from 0.20.0 to 0.20.1 in SKILL.md.
v1.0.3
- Updated version in metadata from 0.19.0 to 0.20.0.
- No changes to command structure or documented functionality.
- Documentation refresh to reflect version update.
v1.0.2
- Updated metadata version field from 1.0.0 to 0.19.0 and removed top-level version field.
- No changes to functionality or usage; only documentation/metadata updated.
v1.0.1
- Documentation formatting in SKILL.md updated for consistency.
- Minor changes to how lists are written in the metadata section.
- No changes to functionality or API; documentation only.
v1.0.0
Initial release of gws-events v1.0.0:
- Introduces CLI commands to subscribe to Google Workspace events.
- Provides helper commands for subscription management: `+subscribe` (stream events) and `+renew` (renew/reactivate subscriptions).
- Supports operations on API resources: message streaming, tasks (subscribe, cancel, get), and workspace subscription lifecycle (create, get, list, patch, delete, reactivate).
- Includes clear guidance for using schema inspection to discover available methods and required parameters.
- Marked as a productivity tool, requiring the `gws` binary.
元数据
常见问题
Gws Events 是什么?
Subscribe to Google Workspace events. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 541 次。
如何安装 Gws Events?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install gws-events」即可一键安装,无需额外配置。
Gws Events 是免费的吗?
是的,Gws Events 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Gws Events 支持哪些平台?
Gws Events 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Gws Events?
由 googleworkspace-bot(@googleworkspace-bot)开发并维护,当前版本 v1.0.12。
推荐 Skills