Windows 日历同步

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

认证（首次使用） 一键引导配置（首次运行必选） 运行配置向导，脚本会自动引导你完成 Azure AD 应用注册 + OAuth 登录： python "C:\Users\johnx\.qclaw\skills\windows-calendar-sync\scripts\setup_and_auth.py" 脚本会自动： 打开 Azure 门户 → 引导注册免费 Azure AD 应用（获取 Client ID） 打开浏览器 → 设备代码登录 Microsoft 账户 保存 token → 验证日历访问 全程约 2-3 分钟，Token 有效期约 90 天（自动刷新） Azure AD 应用注册是免费的，无需信用卡，只需要一个 Microsoft 账户。

再次认证（token 过期后） 同样运行上面的命令，脚本检测到已有 Client ID 会跳过注册步骤，直接进行登录。

工作流程 当用户提出以下类型的请求时，触发本技能： 创建提醒 + 同步日历：「明天 10 点提醒我开会，同步到日历」 直接创建日历事件：「在日历里加一个下周一的周会」 查询日历：「看看我这周有什么日程」 删除日历事件：「把那个提醒从日历里删掉」 工作流程： 解析用户意图，提取：标题、开始时间、结束时间/时长、提醒设置、是否重复 构造 ISO 8601 时间格式（如 2026-04-15T10:00:00） 调用 calendar_sync.py add 将事件写入 Outlook 日历 告知用户事件已创建，可通过 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 参数说明： 参数 必填 说明 --title / -t 事件标题 --start / -s 开始时间，ISO 8601 格式 --end / -e 与 --duration 二选一 结束时间 --duration / -d 与 --end 二选一 持续分钟数（默认30分钟） --reminder / -r 否 提前多少分钟提醒（默认15，设为0则不提醒） --body / -b 否 事件描述 --location / -l 否 地点 --category / -c 否 分类标签（可多次指定）

列出未来事件： 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

时间解析规则 将自然语言时间转换为 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 提醒的配合 创建定时提醒时，建议同时做两件事： 创建 OpenClaw Cron 任务（即时精确提醒，通过 App/消息推送） 写入 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

注意事项 认证文件位置：scripts/token_store.json，不要移动或删除 Token 有效期：约 90 天，过期后脚本会自动尝试刷新，刷新失败会引导重新认证 权限说明：只需 Calendars.ReadWrite，不读写邮件或文件 事件链接：创建成功后会返回 webLink，可直接在浏览器打开 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