技能名称: google-keep
详细描述:

Google Keep CLI 技能

使用非官方的 gkeepapi 从命令行管理 Google Keep 笔记和列表。

设置

安装后，CLI 位于技能目录中。设置一个便捷的别名或包装器：

bash
SKILL_DIR=<此技能路径> # 例如 skills/google-keep
alias gkeep=$SKILLDIR/.venv/bin/python3 $SKILLDIR/gkeep.py

或者创建一个全局包装器：

bash
cat > ~/.local/bin/gkeep << EOF
#!/bin/bash
SKILL_DIR=$(dirname $(readlink -f $0))/../.openclaw/workspace/skills/google-keep
exec $SKILLDIR/.venv/bin/python3 $SKILLDIR/gkeep.py $@
EOF
chmod +x ~/.local/bin/gkeep

身份验证

首次设置（OAuth 令牌交换）：

1. 1. 在浏览器中访问 https://accounts.google.com/EmbeddedSetup
2. 使用您的 Google 帐户登录
3. 在同意屏幕上点击“我同意”（页面可能会无限旋转——忽略它）
4. 打开开发者工具：F12 → 应用程序标签 → Cookie → accounts.google.com
5. 复制 oauth_token cookie 的值
6. 运行：

bash
gkeep auth <邮箱>

使用预先获取的主令牌：

bash
gkeep auth-master <邮箱>

凭据存储在 <技能目录>/.config/ 中（权限为 600）。主令牌拥有完整的帐户访问权限——请像对待密码一样对待它。它不会过期（与标准的 OAuth 刷新令牌不同）。

命令

列出笔记

bash
gkeep list # 活跃笔记
gkeep list --archived # 包含已归档的
gkeep list --pinned # 仅显示已置顶的
gkeep list --label 购物 # 按标签筛选
gkeep list --json # JSON 输出
gkeep list -v # 显示 ID

搜索

bash
gkeep search 杂货
gkeep search 待办事项 --json

获取特定笔记

bash
gkeep get <笔记-id>
gkeep get 购物清单 # 按标题搜索（不区分大小写）
gkeep get --json

创建笔记

bash
gkeep create --title 想法 --text 一些想法
gkeep create --title 杂货 --list --items 牛奶 鸡蛋 面包
gkeep create --title 重要 --pin --color Red --label 工作

编辑笔记

bash
gkeep edit --title 新标题
gkeep edit --text 更新后的文本
gkeep edit --pin true
gkeep edit --archive true
gkeep edit --color Blue

列表操作

bash
gkeep check 杂货 牛奶 # 勾选一个项目
gkeep check 杂货 牛奶 --uncheck # 取消勾选
gkeep check 杂货 m --all # 勾选所有匹配项
gkeep add-item 杂货 黄油 奶酪 # 添加项目

删除（移至回收站）

bash
gkeep delete

标签

bash
gkeep labels # 列出所有标签
gkeep labels --json

导出 / 备份

bash
gkeep dump # 所有笔记以 JSON 格式输出
gkeep dump > backup.json

颜色

有效颜色：白色、红色、橙色、黄色、绿色、青色、蓝色、深蓝、紫色、粉色、棕色、灰色

工作原理

• - 使用 gkeepapi（1600+ 星标，积极维护）——一个非官方的逆向工程 Google Keep 客户端
• 通过 gpsoauth 进行身份验证——Google Play 服务 OAuth 流程以获取主令牌
• 状态在本地缓存（.config/state.json），以便在初始同步后快速启动
• 主令牌不会过期，因此无需重新进行身份验证
• 非官方 API——Google 随时可能破坏兼容性（但 gkeepapi 多年来一直保持稳定）

安全说明

• - 主令牌授予对关联 Google 帐户的完全访问权限
• 凭据以 600 权限存储在 .config/ 中
• 切勿将 .config/ 提交到版本控制
• delete 将笔记移至回收站（可恢复）——不会永久删除