安装方式

命令行安装

在项目根目录执行以下命令，完成 Skill 安装。

npx bzskills add googleworkspace/cli --skill gws-drive

ZIP 包安装

点击下方按钮下载 ZIP 包，并解压到本地 Skills 目录。

下载 ZIP 包 →

# 下载 gws-drive.zip
unzip gws-drive.zip -d ./skills

skill.md

name: gws-drive
description: Google Drive：管理文件、文件夹和共享云端硬盘。
metadata:
    version: 0.22.5
    openclaw:
        category: "productivity"
        requires:
            bins:
                - gws
        cliHelp: "gws drive --help"

drive (v3)

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

gws drive <resource> <method> [flags]

辅助命令

命令	描述
`+upload`	上传文件并自动添加元数据

API 资源

about

get — 获取有关用户、用户的云端硬盘和系统能力的信息。更多信息请参阅返回用户信息。必需：必须设置 fields 参数。要返回所需的精确字段，请参阅返回特定字段。

accessproposals

get — 根据 ID 检索访问建议。更多信息请参阅管理待处理的访问建议。
list — 列出文件上的访问建议。更多信息请参阅管理待处理的访问建议。注意：只有审批人才能列出文件上的访问建议。如果用户不是审批人，将返回 403 错误。
resolve — 批准或拒绝访问建议。更多信息请参阅管理待处理的访问建议。

approvals

get — 根据 ID 获取审批。
list — 列出文件上的审批。

apps

get — 获取特定应用。更多信息请参阅返回用户信息。
list — 列出用户已安装的应用。更多信息请参阅返回用户信息。

changes

getStartPageToken — 获取用于列出未来更改的起始 pageToken。更多信息请参阅检索更改。
list — 列出用户或共享云端硬盘的更改。更多信息请参阅检索更改。
watch — 订阅用户的更改。更多信息请参阅资源更改通知。

channels

stop — 停止通过此频道监视资源。更多信息请参阅资源更改通知。

comments

create — 在文件上创建评论。更多信息请参阅管理评论和回复。必需：必须设置 fields 参数。要返回所需的精确字段，请参阅返回特定字段。
delete — 删除评论。更多信息请参阅管理评论和回复。
get — 根据 ID 获取评论。更多信息请参阅管理评论和回复。必需：必须设置 fields 参数。要返回所需的精确字段，请参阅返回特定字段。
list — 列出文件的评论。更多信息请参阅管理评论和回复。必需：必须设置 fields 参数。要返回所需的精确字段，请参阅返回特定字段。
update — 使用补丁语义更新评论。更多信息请参阅管理评论和回复。必需：必须设置 fields 参数。要返回所需的精确字段，请参阅返回特定字段。

drives

create — 创建共享云端硬盘。更多信息请参阅管理共享云端硬盘。
get — 根据 ID 获取共享云端硬盘的元数据。更多信息请参阅管理共享云端硬盘。
hide — 从默认视图中隐藏共享云端硬盘。更多信息请参阅管理共享云端硬盘。
list — 列出用户的共享云端硬盘。此方法接受 q 参数，该参数是由一个或多个搜索词组合而成的搜索查询。更多信息请参阅搜索共享云端硬盘指南。
unhide — 将共享云端硬盘恢复到默认视图。更多信息请参阅管理共享云端硬盘。
update — 更新共享云端硬盘的元数据。更多信息请参阅管理共享云端硬盘。

files

copy — 创建文件的副本，并使用补丁语义应用任何请求的更新。更多信息请参阅创建和管理文件。
create — 创建文件。更多信息请参阅创建和管理文件。此方法支持 */upload* URI，并接受具有以下特性的上传媒体： - *最大文件大小：* 5,120 GB - *接受的媒体 MIME 类型：* */*（请指定有效的 MIME 类型，而不是字面值 */*。字面值 */* 仅用于表示可以上传任何有效的 MIME 类型。）
download — 下载文件内容。更多信息请参阅下载和导出文件。操作自创建之时起 24 小时内有效。
export — 将 Google Workspace 文档导出为请求的 MIME 类型，并返回导出的字节内容。更多信息请参阅下载和导出文件。注意导出的内容限制为 10 MB。
generateIds — 生成一组文件 ID，可在创建或复制请求中使用。更多信息请参阅创建和管理文件。
get — 根据 ID 获取文件的元数据或内容。更多信息请参阅搜索文件和文件夹。如果您提供 URL 参数 alt=media，则响应将包含响应正文中的文件内容。使用 alt=media 下载内容仅当文件存储在云端硬盘中时才有效。
list — 列出用户的文件。更多信息请参阅搜索文件和文件夹。此方法接受 q 参数，该参数是由一个或多个搜索词组合而成的搜索查询。此方法默认返回*所有*文件，包括已删除的文件。如果您不希望列表中显示已删除的文件，请使用 trashed=false 查询参数从结果中移除已删除的文件。
listLabels — 列出文件上的标签。更多信息请参阅列出文件上的标签。
modifyLabels — 修改应用于文件的标签集。更多信息请参阅在文件上设置标签字段。返回已添加或修改的标签列表。
update — 更新文件的元数据、内容或两者。调用此方法时，仅填充请求中您要修改的字段。更新字段时，某些字段可能会自动更改，例如 modifiedDate。此方法支持补丁语义。此方法支持 */upload* URI，并接受具有以下特性的上传媒体： - *最大文件大小：* 5,120 GB - *接受的媒体 MIME 类型：* */*（请指定有效的 MIME 类型，而不是字面值 */* 值。）
watch — 订阅文件的更改。更多信息请参阅资源更改通知。

operations

get — 获取长时间运行操作的最新状态。客户端可以使用此方法按 API 服务建议的时间间隔轮询操作结果。

permissions

create — 为文件或共享云端硬盘创建权限。更多信息请参阅共享文件、文件夹和云端硬盘。警告： 不支持对同一文件进行并发权限操作；仅应用最后的更新。
delete — 删除权限。更多信息请参阅共享文件、文件夹和云端硬盘。警告： 不支持对同一文件进行并发权限操作；仅应用最后的更新。
get — 根据 ID 获取权限。更多信息请参阅共享文件、文件夹和云端硬盘。
list — 列出文件或共享云端硬盘的权限。更多信息请参阅共享文件、文件夹和云端硬盘。
update — 使用补丁语义更新权限。更多信息请参阅共享文件、文件夹和云端硬盘。警告： 不支持对同一文件进行并发权限操作；仅应用最后的更新。

replies

create — 创建对评论的回复。更多信息请参阅管理评论和回复。
delete — 删除回复。更多信息请参阅管理评论和回复。
get — 根据 ID 获取回复。更多信息请参阅管理评论和回复。
list — 列出评论的回复。更多信息请参阅管理评论和回复。
update — 使用补丁语义更新回复。更多信息请参阅管理评论和回复。

revisions

delete — 永久删除文件版本。您只能删除 Google 云端硬盘中具有二进制内容的文件（如图像或视频）的修订版本。其他文件（如 Google 文档或表格）的修订版本以及最后一个文件版本无法删除。更多信息请参阅管理文件修订版本。
get — 根据 ID 获取修订版本的元数据或内容。更多信息请参阅管理文件修订版本。
list — 列出文件的修订版本。更多信息请参阅管理文件修订版本。重要： 此方法返回的修订版本列表对于具有大量修订历史的文件（包括频繁编辑的 Google 文档、表格和幻灯片）可能不完整。较旧的修订版本可能从响应中省略，这意味着返回的第一个修订版本可能不是最早的现有修订版本。
update — 使用补丁语义更新修订版本。更多信息请参阅管理文件修订版本。

teamdrives

create — 已弃用：请改用 drives.create。
get — 已弃用：请改用 drives.get。
list — 已弃用：请改用 drives.list。
update — 已弃用：请改用 drives.update。

发现命令

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

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

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

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