Google Calendar 技能

概述

此技能为 Google Calendar REST API 提供了一个轻量级的封装。它使您可以：

• 列出即将发生的事件（可选择按时间范围或查询条件过滤）
• 添加包含标题、开始/结束时间、描述、地点和参与者的新事件
• 更新现有事件（通过其ID）
• 删除事件（通过其ID）

该技能使用 Python 实现 (scripts/google_calendar.py)。它需要设置以下环境变量（您可以使用openclaw secret set安全地存储它们）：

GOOGLE_CLIENT_ID=…
GOOGLE_CLIENT_SECRET=…
GOOGLE_REFRESH_TOKEN=…   # 在 OAuth 授权后获得
GOOGLE_CALENDAR_ID=primary   # 或特定日历的ID

首次运行此技能时，您可能需要执行 OAuth 流程以获取刷新令牌 – 请参阅下面的设置部分。

命令

google-calendar list [--from <ISO> --to <ISO> --max <N>]
google-calendar add   --title <title> [--start <ISO> --end <ISO>]
                     [--desc <description> --location <loc> --attendees <email1,email2>]
google-calendar update --event-id <id> [--title <title> ... 其他字段]
google-calendar delete --event-id <id>

所有命令都会将 JSON 格式的有效载荷打印到标准输出。错误信息会打印到标准错误输出，并导致非零退出码。

设置

1. 创建一个 Google Cloud 项目并启用Google Calendar API。
2. 创建 OAuth 凭证（类型桌面应用）。请记下客户端ID和客户端密钥。
3. 运行辅助脚本以获取刷新令牌：

   GOOGLE_CLIENT_ID=… GOOGLE_CLIENT_SECRET=… python3 -m google_calendar.auth

   脚本将打开浏览器（或打印一个您可以在其他地方打开的URL）并要求您授予访问权限。批准后，请复制脚本输出的刷新令牌。
4. 安全地存储凭证：

   openclaw secret set GOOGLE_CLIENT_ID <值>
   openclaw secret set GOOGLE_CLIENT_SECRET <值>
   openclaw secret set GOOGLE_REFRESH_TOKEN <值>
   openclaw secret set GOOGLE_CALENDAR_ID primary   # 可选

5. 安装所需的 Python 包（仅需一次）：

   pip install --user google-auth google-auth-oauthlib google-api-python-client

工作原理（简要说明）

脚本从环境变量加载凭证，使用刷新令牌更新访问令牌，构建一个service = build('calendar', 'v3', credentials=creds)，然后调用相应的 API 方法。

参考链接

• Google Calendar API 参考：https://developers.google.com/calendar/api/v3/reference
• 适用于已安装应用的 OAuth 2.0：https://developers.google.com/identity/protocols/oauth2/native-app

注意：此技能无需图形用户界面；它完全通过 HTTP 调用工作，因此适用于无头服务器。