Apple Calendar Pal 可協助你管理重複性事務與一次性計畫，同時安全地檢查及更新 Apple Calendar。
安裝與下載
1. ClawHub CLI
從來源直接安裝技能的最快方式。
npx clawhub@latest install pkg
2. 手動安裝
將技能資料夾複製到以下位置之一
~/.openclaw/skills/ <project>/skills/ 優先級：工作區 > 本地 > 內建
3. 提示詞安裝
將此提示詞複製到 OpenClaw 即可自動安裝。
請幫我使用 Clawhub 安裝 pkg。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。
想要直接下載？
取得包含原生技能檔案的ZIP壓縮檔。
什麼是 Apple Calendar Pal？
Apple Calendar Pal 是一款行事曆助理，可用於匯入固定行程、檢查空檔、規劃外出，以及管理 Apple Calendar 中的事件。它會將課程、班次和考試等權威的重複性事務，與旅程、約會和提醒等對話式計畫分開，並將各類型儲存在自己的行事曆中。
此技能使用 Python 標準函式庫腳本，透過 CalDAV 查詢、新增和取消事件，變更會同步至 iPhone 行事曆。它可以結合行事曆空檔、目的地資訊、營業時間、天氣、日落和路線資訊，以估算出發時間。這些謹慎的工作流程讓 Apple Calendar Pal 成為 Openclaw Skills 中的實用選擇，適合想有效規劃又不希望意外變更固定事務的人。
Apple Calendar Pal 應用場景
- 在檢查並確認擷取出的事件後，匯入課表、工作輪班表、考試行程或其他重複性事務。
- 選擇見面或前往某處的時間前，檢查某日期已有的事務與計畫。
- 結合目的地資訊、營業時間、天氣、日落和可用路線估算來規劃外出。
- 從事件開始時間反向推算，建議出發時間與行事曆提醒。
- 將確認的一次性計畫新增至計畫行事曆，或檢查並取消符合的臨時事件。
- 更新或移除臨時計畫時，保護重複性事務不受影響。
Apple Calendar Pal 運作原理
- 載入
data/profile.json，讀取住家座標、行事曆名稱和偏好；讀取data/commitments/中的所有檔案，以了解固定行程限制。 - 將「下週三」等相對日期解析為特定日期；日期不確定時要求釐清。
- 匯入行程時，將事件擷取至事務規格，展開交替週或跳過週，並要求使用者在儲存或推送前核對每個事件。
- 對於規劃中的外出，查詢行事曆空檔，並取得目的地、營業時間、天氣、日落以及（完成設定後）大眾運輸和駕車資訊。
- 使用使用者指定的出發時間計算出發時刻；若未提供，則以事件開始時間減去行程時間與 10 分鐘緩衝。清楚標示估算路線，並提示行程或天氣衝突。
- 顯示完整事件資訊，包括日期、開始與結束時間、標題、地點和提醒，並在寫入或刪除行事曆事件前取得使用者確認。
- 將確認的變更推送至適當的行事曆。取消時檢查當天事件並先確認目標；腳本只會移除符合的
calpal-事件。
Apple Calendar Pal 設定指南
- 確認可使用 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。沒有它時，必須保守估算行程時間，並揭露這是估算值。 - 推送或取消行事曆事件前，在聊天中檢查並確認完整事件資訊。固定行程應使用事務匯入與驗證流程；不要將其視為一般臨時計畫。
Apple Calendar Pal 資料結構與分類體系
此技能將資訊組織成兩類由行事曆支援的資料：
| 資料類別 | 來源與用途 | 儲存位置與行事曆 |
|---|---|---|
| 事務 | 課程、班次、考試或定期會議等權威且相對穩定的行程 | 每個行程在 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- 前綴的事件，協助保護手動建立的事件。設定檔也保存住家座標、行事曆名稱及相關偏好；提供的檔案未記錄完整的設定檔結構。
Apple Calendar Pal 進階特性
- 將受保護的重複性事務與可編輯的一次性計畫分開，並透過腳本層級的保護措施，避免一般取消操作修改事務行事曆。
- 將包含交替週或跳過週的學期週行程展開成有日期的行事曆事件，並透過
skip_dates支援排除假日。 - 支援使用
--dry-run預覽行事曆推送，並使用--calendar選擇行事曆。 - 將行事曆查詢與目的地查找、營業時間、天氣、日出或日落資訊，以及可選的大眾運輸和駕車路線結合。
- 根據行程時間與事件開始時間計算出發提醒，同時遵守使用者指定的出發時間，不會暗中將其提前。
- 使用由內容產生的事件識別碼進行可重複推送；時間變更遵循先取消再推送的流程。
- 使用 Python 3 和標準函式庫執行，不依賴第三方 Python 相依套件；腳本可在技能目錄外呼叫。
SKILL.md
加載中
Openclaw 相關技能
Software Concept Architect · Refine
一個以證據為導向的 coding-agent skill，旨在透過尋求最小化且合理的變更來改進軟體概念或概念系統。
Instagram Highlights Scraper
透過 Apify 從公開 Instagram 精選動態網址擷取限時動態項目，驗證輸入、透明呈現價格，並在每次付費執行前取得明確核准。
精選*
