1---
2name: gws-workflow-file-announce
3description: "Google Workflow: Announce a Drive file in a Chat space."
4metadata:
5  version: 0.22.5
6  openclaw:
7    category: "productivity"
8    requires:
9      bins:
10        - gws
11    cliHelp: "gws workflow +file-announce --help"
12---
13 
14# workflow +file-announce
15 
16> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
17 
18Announce a Drive file in a Chat space
19 
20## Usage
21 
22```bash
23gws workflow +file-announce --file-id <ID> --space <SPACE>
24```
25 
26## Flags
27 
28| Flag | Required | Default | Description |
29|------|----------|---------|-------------|
30| `--file-id` | ✓ | — | Drive file ID to announce |
31| `--space` | ✓ | — | Chat space name (e.g. spaces/SPACE_ID) |
32| `--message` | — | — | Custom announcement message |
33| `--format` | — | — | Output format: json (default), table, yaml, csv |
34 
35## Examples
36 
37```bash
38gws workflow +file-announce --file-id FILE_ID --space spaces/ABC123
39gws workflow +file-announce --file-id FILE_ID --space spaces/ABC123 --message 'Check this out!'
40```
41 
42## Tips
43 
44- This is a write command — sends a Chat message.
45- Use `gws drive +upload` first to upload the file, then announce it here.
46- Fetches the file name from Drive to build the announcement.
47 
48## See Also
49 
50- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
51- [gws-workflow](../gws-workflow/SKILL.md) — All cross-service productivity workflows commands
52