gws-events-subscribe — скилл для Claude: подписка на события Workspace
Скилл запускает подписку на события Google Workspace и отдаёт их потоком NDJSON. Пригодится, когда агенту нужно следить за чатами и другими ресурсами.
npx skills add googleworkspace/cli --skill gws-events-subscribe -a claude-codeЧто делает gws-events-subscribe
Скилл оборачивает команду gws events +subscribe. Она подписывается на события Workspace через CloudEvents и вытягивает их батчами из Pub/Sub, а на выходе получается поток NDJSON.
Цель задаётся флагом --target — например, URI пространства Google Chat. Типы событий перечисляются через запятую в --event-types. Есть --project для ресурсов Pub/Sub и --subscription, если подписка уже создана и настройку нужно пропустить. Батч по умолчанию 10 сообщений, интервал опроса 5 секунд, --once делает один проход и выходит. Флаг --output-dir раскладывает каждое событие в отдельный JSON-файл.
Перед запуском нужен бинарник gws и файл ../gws-shared/SKILL.md с настройками авторизации. Если его нет, скилл предлагает выполнить gws generate-skills. Учтите: команда пишущая, поэтому подтверждайте запуск у пользователя. Без --cleanup ресурсы Pub/Sub остаются и подписку можно переиспользовать. Ставить стоит тем, кто строит автоматику вокруг событий Workspace; для разовой проверки хватит --once.
Какие задачи решает
- подписаться на события Google Chat и получать их потоком
- выгрузить события Workspace в отдельные JSON-файлы
- переиспользовать уже созданную подписку Pub/Sub
- сделать один проход по событиям и выйти
- удалить созданные ресурсы Pub/Sub после завершения
Примеры запросов агенту
- Подпишись на события пространства `//chat.googleapis.com/spaces/SPACE` и покажи поток
- Запусти `gws events +subscribe --subscription projects/p/subscriptions/my-sub --once`
- Собери события в `./events` и удали ресурсы Pub/Sub после выхода
Как установить gws-events-subscribe
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-events-subscribe -a claude-code2Вручную: положить файлы
~/.claude/skills/gws-events-subscribe/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gws-events-subscribe/
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-events-subscribe -a codex2Вручную: положить файлы
.agents/skills/gws-events-subscribe/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-events-subscribe -a cursor2Вручную: положить файлы
.cursor/skills/gws-events-subscribe/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install googleworkspace/cli gws-events-subscribe2Вручную: положить файлы
.github/skills/gws-events-subscribe/SKILL.md1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-events-subscribe -a gemini-cli2Командой платформы
gemini skills install https://github.com/googleworkspace/cli --path skills/gws-events-subscribeВручную: положить файлы
.devin/skills/gws-events-subscribe/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-events-subscribe -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора95
Весь набор →Похожие
Вопросы о gws-events-subscribe
Как установить gws-events-subscribe в Claude?
Выполните npx skills add googleworkspace/cli --skill gws-events-subscribe -a claude-code. Файл скилла появится по пути ~/.claude/skills/gws-events-subscribe/SKILL.md.
Что делает gws-events-subscribe?
Подписывается на события Google Workspace и стримит их как NDJSON. Внутри — команда gws events +subscribe с флагами для цели, типов событий и ресурсов Pub/Sub.
Что нужно для работы скилла?
Бинарник gws и файл ../gws-shared/SKILL.md с правилами авторизации. Если его нет, создайте через gws generate-skills.
Исходный текст
SKILL.md · Apache-2.0
---
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
```bash
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
```bash
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.
## See Also
- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
- [gws-events](../gws-events/SKILL.md) — All subscribe to google workspace events commands
© googleworkspace · Apache-2.0 · googleworkspace/cli
