windows-calendar-sync（Windows 日历同步）

Windows 日历同步

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

认证（首次使用）

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

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

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 — 添加 / 查询 / 删除日历事件

添加事件：

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

参数说明：

列出未来事件：

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

删除事件：

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

时间解析规则

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

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

与 OpenClaw Cron 提醒的配合

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

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

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

# 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)

故障排除