Gws Events Subscribe

核心功能：通过gws CLI订阅Google Workspace指定资源的事件，支持复用现有Pub/Sub订阅或自动创建资源，可配置拉取参数，事件可输出为NDJSON流或写入单独JSON文件。典型场景：实时监控Workspace聊天消息等事件。输入为带参数的命令行指令，支持退出时清理资源等操作。

googleworkspace-bot

热度 74.58

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

分类：自动化依赖：第三方 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.