Windows 日历同步#

将提醒和日程写入用户本人的 Microsoft Outlook 日历（即 Windows 日历），同步到所有设备。

认证（首次使用）#

一键引导配置（首次运行必选）#

运行配置向导，脚本会自动引导你完成 Azure AD 应用注册 + OAuth 登录：

powershell

python "C:\Users\johnx\.qclaw\skills\windows-calendar-sync\scripts\setup_and_auth.py"

脚本会自动：

1. 打开 Azure 门户 → 引导注册免费 Azure AD 应用（获取 Client ID）
2. 打开浏览器 → 设备代码登录 Microsoft 账户
3. 保存 token → 验证日历访问
4. 全程约 2-3 分钟，Token 有效期约 90 天（自动刷新）

Azure AD 应用注册是免费的，无需信用卡，只需要一个 Microsoft 账户。

再次认证（token 过期后）#

同样运行上面的命令，脚本检测到已有 Client ID 会跳过注册步骤，直接进行登录。

---

工作流程#

当用户提出以下类型的请求时，触发本技能：

1. 创建提醒 + 同步日历：「明天 10 点提醒我开会，同步到日历」
2. 直接创建日历事件：「在日历里加一个下周一的周会」
3. 查询日历：「看看我这周有什么日程」
4. 删除日历事件：「把那个提醒从日历里删掉」

工作流程：

1. 解析用户意图，提取：标题、开始时间、结束时间/时长、提醒设置、是否重复
2. 构造 ISO 8601 时间格式（如 2026-04-15T10:00:00）
3. 调用 calendar_sync.py add 将事件写入 Outlook 日历
4. 告知用户事件已创建，可通过 Windows 日历或 Outlook 查看

---

核心脚本#

scripts/calendar_sync.py — 添加 / 查询 / 删除日历事件#

添加事件：

powershell

python "C:\Users\johnx\.qclaw\skills\windows-calendar-sync\scripts\calendar_sync.py" add `
  --title "团队周会" `
  --start "2026-04-16T09:00:00" `
  --duration 60 `
  --reminder 15

参数说明：

参数必填说明--title / -t✅事件标题--start / -s✅开始时间，ISO 8601 格式--end / -e与 --duration 二选一结束时间--duration / -d与 --end 二选一持续分钟数（默认30分钟）--reminder / -r否提前多少分钟提醒（默认15，设为0则不提醒）--body / -b否事件描述--location / -l否地点--category / -c否分类标签（可多次指定）

列出未来事件：

powershell

python "C:\Users\johnx\.qclaw\skills\windows-calendar-sync\scripts\calendar_sync.py" list --days 7

删除事件：

powershell

python "C:\Users\johnx\.qclaw\skills\windows-calendar-sync\scripts\calendar_sync.py" delete <event_id>

---

时间解析规则#

将自然语言时间转换为 ISO 8601：

用户输入解析结果示例明天 10 点2026-04-13T10:00:00今天下午 3 点半2026-04-12T15:30:00下周一早上9点下一个周一 09:00周五 18:00本周/下周周五 18:00结合当前日期判断2 小时后当前时间 + 2h

时区：始终使用 Asia/Shanghai（中国用户），Windows 上自动检测本地时区。

---

与 OpenClaw Cron 提醒的配合#

创建定时提醒时，建议 同时做两件事：

1. 创建 OpenClaw Cron 任务（即时精确提醒，通过 App/消息推送）
2. 写入 Windows 日历（可视化日程，同步到所有设备）

示例 — 用户说「每天早上 8 点提醒我做运动」：

python

# 1. 创建 cron 任务（精确提醒）
cron.schedule("0 8 * * *", message="运动时间到！💪", repeat="daily")

# 2. 写入日历（可视化作息安排）
# 调用 calendar_sync.py:
python "C:\Users\johnx\.qclaw\skills\windows-calendar-sync\scripts\calendar_sync.py" add `
  --title "🏃 运动时间" `
  --start "2026-04-13T08:00:00" `
  --duration 60 `
  --reminder 10

---

注意事项#

1. 认证文件位置： scripts/token_store.json，不要移动或删除
2. Token 有效期：约 90 天，过期后脚本会自动尝试刷新，刷新失败会引导重新认证
3. 权限说明：只需 Calendars.ReadWrite，不读写邮件或文件
4. 事件链接：创建成功后会返回 webLink，可直接在浏览器打开
5. Microsoft 账户：支持 personal Microsoft account (Outlook.com / Hotmail / Live) 和工作/学校账户 (Microsoft 365)

---

故障排除#

问题解决方案access_token 获取失败运行 authenticate.py 重新认证Token 已过期删除 token_store.json，重新运行 authenticate.py事件时间显示错误确认 --start 使用 ISO 8601 格式，带 T 分隔符提醒没响检查 Outlook/Windows 日历的通知权限是否开启想删除事件但不知道 ID先运行 list 命令查找事件 ID