名称： google-tasks
版本： 1.0.0
描述： 使用 Google Tasks API 获取、显示、创建和删除 Google 任务。当用户要求查看、列出、获取、添加、创建、移除或删除其 Google 任务、待办事项列表或任务项时使用。通过 bash 脚本结合 curl 和 jq 自动处理 OAuth 身份验证。
作者： OpenClaw Community
关键词： [google-tasks, tasks, todo, productivity, bash, oauth]
许可证： MIT

Google Tasks 技能

使用轻量级 bash 脚本管理所有任务列表中的 Google 任务。

快速开始

查看任务

bash scripts/get_tasks.sh

创建任务

# 使用默认列表（在 google-tasks-config.sh 中配置）
bash scripts/create_task.sh "任务标题" ["截止日期"] ["备注"]

# 指定列表名称
bash scripts/create_task.sh "列表名称" "任务标题" ["截止日期"] ["备注"]

示例：

# 简单任务（使用默认列表）
bash scripts/create_task.sh "购买杂货"

# 带截止日期的任务（使用默认列表）
bash scripts/create_task.sh "完成报告" "2026-02-10"

# 指定列表的任务
bash scripts/create_task.sh "工作" "完成报告" "2026-02-10"

# 包含列表、截止日期和备注的任务
bash scripts/create_task.sh "个人" "给妈妈打电话" "2026-02-05" "询问她的健康状况"

默认列表配置：
编辑 google-tasks-config.sh 以设置您的默认列表：

DEFAULT_LIST="Private"  # 更改为您偏好的默认列表

删除任务

bash scripts/delete_task.sh "列表名称" <任务编号或标题>

示例：

# 按任务编号删除（列表中的位置）
bash scripts/delete_task.sh "工作" 2

# 按任务标题删除
bash scripts/delete_task.sh "收件箱" "购买杂货"

要求

• jq - JSON 处理器（通常已预装）
• curl - HTTP 客户端（通常已预装）
• 有效的包含 OAuth 访问令牌的 token.json
• 所需权限范围： https://www.googleapis.com/auth/tasks（读写权限）

首次设置

如果 token.json 不存在：

1. 用户需要 OAuth 凭据 (credentials.json) - 参见 setup.md
2. 首先运行 Node.js 身份验证流程以生成 token.json
3. 之后即可使用 bash 脚本进行所有后续调用

输出格式

📋 您的 Google 任务：

📌 列表名称
──────────────────────────────────────────────────
  1. ⬜ 任务标题 (截止日期: YYYY-MM-DD)
     备注：如果存在任务备注
  2. ⬜ 另一个任务

📌 另一个列表
──────────────────────────────────────────────────
  (无任务)

文件位置

• token.json - 访问/刷新令牌（工作区根目录）
• google-tasks-config.sh - 配置文件（默认列表设置）
• scripts/get_tasks.sh - 查看任务的 Bash 脚本
• scripts/create_task.sh - 创建任务的 Bash 脚本
• scripts/delete_task.sh - 删除任务的 Bash 脚本
• references/setup.md - 详细设置指南

实现方式

Bash 脚本使用：
- 直接调用 Google Tasks REST API
- curl 进行 HTTP 请求
- jq 解析 JSON
- 从 token.json 获取 Bearer 令牌进行身份验证

无需 Python 依赖。

故障排除

令牌过期：

错误：凭据无效

删除 token.json 并重新进行身份验证。

缺少 jq：

bash: jq: 未找到命令

安装 jq：apt-get install jq 或 brew install jq

更多详细信息，请参阅 setup.md。