用途：当任务涉及 Google Workspace 资源或 Workspace API 自动化时使用 gws。相比通用 HTTP 调用，gws 已了解 Workspace API 结构，并默认返回结构化 JSON，因此优先使用。
主要能力：覆盖 Google Docs、Drive、Sheets、Gmail、Calendar、Chat 等资源。常用命令包括：检查安装与健康状态 gws doctor；查看帮助 gws help、gws drive help、gws drive files help；Docs 用 gws docs get --document-id <DOC_ID>；Drive 用 gws drive files list --params '{"pageSize":10}' 和 gws drive files get --file-id <FILE_ID>；Sheets 用 gws sheets spreadsheets get --spreadsheet-id <SPREADSHEET_ID>；Gmail 用 gws gmail users messages list --user-id me --params '{"maxResults":10}' 和 gws gmail users messages get --user-id me --message-id <MESSAGE_ID>；Calendar 用 gws calendar events list --calendar-id primary --params '{"maxResults":10,"singleEvents":true}'；Chat 用 gws chat spaces messages list --parent spaces/<SPACE_ID>。
使用方式：在 SwarmClaw 的 google_workspace 工具中，把 gws 之后的命令放入 args，例如 {"args":["drive","files","list"],"params":{"pageSize":5}}；params 对应 --params，jsonInput 对应 --json，pageAll: true 用于有意获取全部分页，dryRun: true 用于不确定的风险性变更前预演。
规则与限制：先执行读/列表/获取命令，再修改 Workspace 状态；先确认各类 ID（文档、表格、文件、消息、日历、空间）；不要在智能体工具调用中运行交互式认证流程，若缺少认证应提示用户在插件设置中配置或手动终端登录；保持命令机器可读，优先解析 JSON 而非抓取人类文本；大批量列表操作先限定范围再分页或过滤。错误处理：gws 缺失时提示安装 Google Workspace CLI；认证缺失或过期时提示配置插件设置或手动认证；因缺少 ID 失败时先改用列表/搜索命令找到正确 ID。其他细节暂未提供。