Gws Events Subscribe

该 Skill 提供 gws events +subscribe 命令，用于订阅 Google Workspace 事件并通过 Pub/Sub 拉取消息，支持指定目标资源 URI、事件类型、项目、订阅、最大消息数和轮询间隔；可一次性拉取或持续流式输出 NDJSON，也可用 --output-dir 将每个事件写入独立 JSON 文件。依赖 gws-shared 的认证与安全规则，作为写命令执行前…

googleworkspace-bot

热度 74.72

最近更新 2026-05-11 17:28:46

分类：自动化依赖：第三方 API / 读写文件应用场景：API 集成 / 工作流 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add gws-events-subscribe

Metadata

name: gws-events-subscribe
description: Google Workspace Events: Subscribe to Workspace events and stream them as NDJSON.
metadata: {"version":"0.22.5","openclaw":{"category":"productivity","requires":{"bins":["gws"]},"cliHelp":"gws events +subscribe --help"}}

events +subscribe

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

Subscribe to Workspace events and stream them as NDJSON

Usage

gws events +subscribe

Flags

Flag	Required	Default	Description
`--target`	—	—	Workspace resource URI (e.g., //chat.googleapis.com/spaces/SPACE_ID)
`--event-types`	—	—	Comma-separated CloudEvents types to subscribe to
`--project`	—	—	GCP project ID for Pub/Sub resources
`--subscription`	—	—	Existing Pub/Sub subscription name (skip setup)
`--max-messages`	—	10	Max messages per pull batch (default: 10)
`--poll-interval`	—	5	Seconds between pulls (default: 5)
`--once`	—	—	Pull once and exit
`--cleanup`	—	—	Delete created Pub/Sub resources on exit
`--no-ack`	—	—	Don't auto-acknowledge messages
`--output-dir`	—	—	Write each event to a separate JSON file in this directory

Examples

gws events +subscribe --target '//chat.googleapis.com/spaces/SPACE' --event-types 'google.workspace.chat.message.v1.created' --project my-project
gws events +subscribe --subscription projects/p/subscriptions/my-sub --once
gws events +subscribe ... --cleanup --output-dir ./events

Tips

Without --cleanup, Pub/Sub resources persist for reconnection.
Press Ctrl-C to stop gracefully.

[!CAUTION] This is a write command — confirm with the user before executing.