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 <resource> <method> [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.<resource>.<method>

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