name: gws-chat
description: Google Chat：管理聊天室和消息。
metadata:
    version: 0.22.5
    openclaw:
        category: "productivity"
        requires:
            bins:
                - gws
        cliHelp: "gws chat --help"

聊天 (v1)

前置条件： 请阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则。如果该文件缺失，请运行 gws generate-skills 创建。

gws chat <resource> <method> [flags]

辅助命令

API 资源

customEmojis (自定义表情)

• create — 创建自定义表情。自定义表情仅适用于 Google Workspace 帐号，且管理员必须为组织开启自定义表情功能。更多信息请参阅 了解 Google Chat 中的自定义表情 和 管理自定义表情权限。
• delete — 删除自定义表情。默认情况下，用户只能删除自己创建的自定义表情。管理员指派的表情管理员 可以删除组织中的任何自定义表情。请参阅 了解 Google Chat 中的自定义表情。自定义表情仅适用于 Google Workspace 帐号，且管理员必须为组织开启自定义表情功能。
• get — 返回自定义表情的详细信息。自定义表情仅适用于 Google Workspace 帐号，且管理员必须为组织开启自定义表情功能。更多信息请参阅 了解 Google Chat 中的自定义表情 和 管理自定义表情权限。
• list — 列出已认证用户可见的自定义表情。自定义表情仅适用于 Google Workspace 帐号，且管理员必须为组织开启自定义表情功能。更多信息请参阅 了解 Google Chat 中的自定义表情 和 管理自定义表情权限。

media (媒体)

• download — 下载媒体。下载支持通过 URI /v1/media/{+name}?alt=media 进行。
• upload — 上传附件。示例请参阅 将媒体作为文件附件上传。

spaces (空间)

• completeImport — 完成指定空间的导入过程，使其对用户可见。
• create — 创建空间。可用于创建命名空间，或处于“导入模式”的群聊。示例请参阅 创建空间。
• delete — 删除命名空间。始终执行级联删除，即空间中的子资源（如空间中的消息和成员关系）也会被删除。示例请参阅 删除空间。
• findDirectMessage — 返回与指定用户的现有直接消息。如果未找到直接消息空间，则返回 404 NOT_FOUND 错误。示例请参阅 查找直接消息。使用应用认证时，返回指定用户与调用 Chat 应用之间的直接消息空间。
• get — 返回空间的详细信息。示例请参阅 获取空间详情。
• list — 列出调用者为其成员的空间。群聊和私信在发送第一条消息之前不会列出。示例请参阅 列出空间。
• patch — 更新空间。示例请参阅 更新空间。如果更新 displayName 字段时收到错误消息 ALREADY_EXISTS，请尝试使用其他显示名称。Google Workspace 组织中可能已存在使用该显示名称的空间。
• search — 根据管理员搜索，返回 Google Workspace 组织中的空间列表。在请求中设置 use_admin_access 为 true。示例请参阅 搜索和管理空间。
• setup — 创建空间并向其中添加指定用户。调用用户会自动添加到空间中，不应在请求中指定为成员关系。示例请参阅 使用初始成员设置空间。要添加人类成员，请使用适当的 membership.member.name 添加成员关系。要添加人类用户，请使用 users/{user}，其中 {user} 可以是用户的电子邮件地址。
• members — “成员”资源上的操作
• messages — “消息”资源上的操作
• spaceEvents — “空间事件”资源上的操作

users (用户)

• sections — “分区”资源上的操作
• spaces — “空间”资源上的操作

发现命令

在调用任何 API 方法之前，先进行检查：

# 浏览资源和方法
gws chat --help

# 检查方法的必需参数、类型和默认值
gws schema chat.<resource>.<method>

使用 gws schema 的输出来构建您的 --params 和 --json 标志。