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

chat (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 — 对 'members' 资源的操作
• messages — 对 'messages' 资源的操作
• spaceEvents — 对 'spaceEvents' 资源的操作

users

• sections — 对 'sections' 资源的操作
• spaces — 对 'spaces' 资源的操作

发现命令

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

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

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

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