name: gws-keep
description: 管理 Google Keep 笔记
metadata:
    version: 0.22.5
    openclaw:
        category: "productivity"
        requires:
            bins:
                - gws
        cliHelp: "gws keep --help"

keep (v1)

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

gws keep <资源> <方法> [flags]

API 资源

media

• download — 获取附件。要通过 REST 下载附件媒体，需使用 alt=media 查询参数。如果附件媒体在请求的 MIME 类型中不可用，则返回 400 错误请求。

notes

• create — 创建新笔记。
• delete — 删除笔记。调用者必须具有笔记的 OWNER 角色才能删除。删除笔记会立即移除资源，且不可撤销。任何协作者将失去对笔记的访问权限。
• get — 获取笔记。
• list — 列出笔记。每次列表调用返回一页结果，page_size 为返回项数的上限。page_size 为零时允许服务器自行选择上限。ListNotesResponse 最多包含 page_size 条记录。如果还有更多条目需要列出，会提供 next_page_token 值（分页令牌为不透明值）。要获取下一页结果，请将返回的 next_page_token 复制到下一个请求的 page_token 中。
• permissions — 对'permissions'资源的操作

发现命令

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

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

# 检查方法所需的参数、类型和默认值
gws schema keep.<资源>.<方法>

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