Apple Calendar Pal

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install pkg
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 pkg。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Apple Calendar Pal 是一款日历助手，可用于导入固定日程、检查空闲时间、规划出行以及管理 Apple Calendar 中的事件。它将课程、班次和考试等权威的重复性事务，与旅行、预约和提醒等对话式计划分开，并将每种类型保存在各自的日历中。
该技能使用 Python 标准库脚本，通过 CalDAV 查询、添加和取消事件，变更会同步到 iPhone 日历。它可以将日历空闲时间与目的地详情、营业时间、天气、日落和路线信息结合起来，以估算出发时间。这些谨慎的工作流程使 Apple Calendar Pal 成为 Openclaw Skills 中的实用选择，适合希望高效规划且不冒险误改固定事务的人。

应用场景

在检查并确认提取出的事件后，导入课程表、工作轮班表、考试日程或其他重复性事务。
在选择见面或出行时间前，检查某个日期已有的事务和计划。
结合目的地详情、营业时间、天气、日落和可用路线估算来规划出行。
从事件开始时间倒推，建议出发时间和日历提醒时间。
将确认后的一次性计划添加到计划日历，或查看并取消匹配的临时事件。
在更新或删除临时计划时，保护重复性事务不受影响。

工作原理

加载 data/profile.json，读取家庭坐标、日历名称和偏好；读取 data/commitments/ 中的所有文件，以了解固定日程限制。
将“下周三”等相对日期解析为具体日期；日期不确定时请求澄清。
对于日程导入，将事件提取到事务规范中，展开交替周或跳过周，并要求用户在保存或推送前核验每个事件。
对于拟议出行，查询日历空闲时间，并收集目的地、营业时间、天气、日落以及（配置后）公共交通和驾车信息。
使用用户指定的出发时间计算出发时刻；若未提供，则用事件开始时间减去行程时间和 10 分钟缓冲。明确标注估算路线，并提示日程或天气冲突。
显示完整事件详情，包括日期、开始和结束时间、标题、地点及提醒，并在写入或删除日历事件前取得用户确认。
将确认后的变更推送到相应日历。取消时检查当天事件并先确认目标；脚本只会删除匹配的 calpal- 事件。

配置指南

确保可使用 Python 3。脚本仅使用 Python 标准库，不需要第三方 Python 包。
使用家庭坐标、事务日历和计划日历的名称，以及支持的偏好或默认值配置 data/profile.json。提供的技能文档未规定确切的配置文件结构和 CalDAV 凭据设置。
将固定日程规范添加到 data/commitments/。导入课程表前，应确认课时与时间的对应关系等细节，不要猜测。
可从技能目录或其他位置使用脚本；路径均相对于各脚本解析。示例命令：
python scripts/cal.py calendars
python scripts/cal.py query --date 2026-10-03
python scripts/cal.py push plan.json --dry-run
python scripts/env_tools.py trip "Destination" 2026-10-03
如果希望路线脚本获取公共交通和驾车路线，请配置 amap_key。没有该配置时，必须保守估算行程时间，并明确说明这是估算值。
推送或取消日历事件前，在聊天中检查并确认完整事件详情。固定日程应使用事务导入和核验流程；不要将其视为普通临时计划。

数据架构

该技能将信息组织为两类由日历支持的数据：
数据类别 来源和用途 存储位置与日历
事务 课程、班次、考试或定期会议等权威且相对稳定的日程 每个日程在 data/commitments/ 下对应一个 JSON 规范；推送到 calendars.commitments
计划 通过对话创建的一次性事件，如出行、预约或提醒 临时计划 JSON；推送到 calendars.plans（计划日历是推送的默认日历）
事务规范包含 name、week1_monday（YYYY-MM-DD）、skip_dates（节假日日期）和 events 数组。每个事件可以包含 title、teacher、location、weekday（周一为 1，周日为 7）、start、end、weeks（学期周数）和 alarm_minutes。推送时会将周模式展开为具体日期；跳过的日期会被排除。如果省略提醒值，则对导入事务使用配置文件中的默认值。
一次性计划使用具体的 date，而不是重复性的 weeks 或 week1_monday。事件备注可以包含路线、行程时间、天气和日落背景。事件标识由内容生成，因此推送相同标题、日期和开始时间的事件会替换匹配事件。取消操作只针对带有 calpal- 前缀的事件，有助于保护手动创建的事件。配置文件还保存家庭坐标、日历名称和相关偏好；提供的文件没有记录完整的配置文件结构。

高级特性

将受保护的重复性事务与可编辑的一次性计划分开，并通过脚本级保护措施防止普通取消操作修改事务日历。
将包含交替周或跳过周的学期周日程展开为带日期的日历事件，并通过
skip_dates
支持排除节假日。
支持使用 --dry-run 预览日历推送，并使用 --calendar 选择日历。
将日历查询与目的地查找、营业时间、天气、日出或日落信息以及可选的公共交通和驾车路线结合起来。
根据行程时间和事件开始时间计算出发提醒，同时尊重用户指定的出发时间，不会悄悄将其提前。
使用由内容生成的事件标识实现可重复推送；时间变更遵循先取消再推送的流程。
使用 Python 3 和标准库运行，不依赖第三方 Python 包；脚本可在技能目录之外调用。

name: apple-calpal description: >- Apple Calendar Pal —— 个人日程管家。导入课表/排班/考试等固定日程并推送 iPhone 日历；
聊天规划行程：查空闲、天气、日落、路程，倒推「几点必须出门」；查询/写入/取消 iCloud
日历（CalDAV 直连苹果服务器，手机几秒同步）。Use whenever the user mentions their
课表/排班/值班/考试安排, says they 想去哪/想做什么/约了谁, asks 有没有空/哪天合适/几点出门,
or wants events added to, removed from, or checked in their Apple calendar.