谷歌日历管理

技能简介

gcal-pro 让用户通过对话方式查看、创建和管理 Google Calendar 事件。支持自然语言指令如”明天有什么安排”或”周五中午约 Alex 吃饭”，无需手动打开日历应用。

业务背景

销售、咨询等频繁约见客户的岗位，无需切换应用即可快速确认档期。自然语言指令降低操作门槛，减少因手动翻查日历导致的响应延迟，让对外沟通更顺畅。

落地案例：客户经理收到客户消息"周三下午能否面谈"，直接询问"我周三下午有空吗"，系统返回空闲时段后即时回复客户；确认会面后说"周四上午10点约客户王总，地点公司会议室"，自动生成日历邀请并同步双方日程。

能做什么

• 查看今日、明日、本周或指定日期范围的日程
• 搜索特定关键词的事件
• 列出所有可用日历
• 查找空闲时间段
• 快速添加事件（Pro）
• 修改或删除已有事件（Pro）
• 生成每日晨间简报（Pro）

使用说明

安装与首次配置：

1. 用户需先在 Google Cloud 创建项目并获取 OAuth 凭证
2. 将 client_secret.json 保存至 ~/.config/gcal-pro/
3. 运行认证命令：
   python scripts/gcal_auth.py auth
4. 浏览器自动打开，用户授权后即可使用

检查认证状态：
python scripts/gcal_auth.py status

常用操作示例：

• 查看今天：python scripts/gcal_core.py today
• 搜索事件：python scripts/gcal_core.py search -q "会议"
• 快速添加（Pro）：python scripts/gcal_core.py quick -q "周五中午和 Alex 吃饭"
• 删除事件（Pro）：先搜索获取事件 ID，再执行 python scripts/gcal_core.py delete --id EVENT_ID -y

输入与输出

见下方输入与输出表格。

风险提示

• 删除或重大修改操作前必须向用户确认，禁止直接执行
• Free 用户尝试写入操作时会提示升级，需明确告知功能限制
• OAuth token 过期后需重新运行认证流程
• 时区默认 America/New_York，跨时区安排需特别说明

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/bilalmohamed187-cpu/gcal-pro/SKILL.md
来源类型：GitHub 仓库