Apple Calendar Pal cho Openclaw

1. Đảm bảo Python 3 khả dụng. Các script chỉ dùng thư viện chuẩn Python và không cần gói Python bên thứ ba.
2. Cấu hình data/profile.json với tọa độ nhà, tên lịch cam kết và lịch kế hoạch, cùng các tùy chọn hoặc giá trị mặc định được hỗ trợ. Tài liệu skill được cung cấp không nêu rõ schema profile và cách thiết lập thông tin xác thực CalDAV.
3. Thêm đặc tả lịch cố định vào data/commitments/. Trước khi nhập thời khóa biểu, hãy xác nhận các chi tiết như ánh xạ giữa tiết học và thời gian thay vì đoán.
4. Sử dụng script từ thư mục skill hoặc nơi khác; đường dẫn được phân giải tương đối với từng script. Ví dụ lệnh:

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

5. Cấu hình amap_key nếu muốn script tuyến đường lấy tuyến giao thông công cộng và lái xe. Nếu không có, thời gian di chuyển phải được ước tính thận trọng và công khai là giá trị ước tính.
6. Xem xét và xác nhận đầy đủ thông tin sự kiện trong cuộc trò chuyện trước khi đẩy hoặc hủy sự kiện lịch. Dùng quy trình nhập và xác minh cam kết cho lịch cố định; không coi chúng như các kế hoạch tạm thời thông thường.

Skill tổ chức thông tin thành hai lớp dữ liệu được hỗ trợ bởi lịch:

Đặc tả cam kết gồm name, week1_monday (YYYY-MM-DD), skip_dates (ngày nghỉ lễ) và mảng events. Mỗi sự kiện có thể gồm title, teacher, location, weekday (1 là thứ Hai, 7 là Chủ nhật), start, end, weeks (số tuần trong học kỳ) và alarm_minutes. Mẫu tuần được mở rộng thành ngày khi đẩy lên lịch; các ngày bị bỏ qua sẽ bị loại trừ. Nếu bỏ qua giá trị báo thức, giá trị mặc định trong profile sẽ được áp dụng cho các cam kết đã nhập.

Kế hoạch một lần dùng date cụ thể thay vì weeks hoặc week1_monday lặp lại. Ghi chú sự kiện có thể chứa ngữ cảnh về tuyến đường, thời gian di chuyển, thời tiết và hoàng hôn. Nhận dạng sự kiện được tạo từ nội dung, vì vậy việc đẩy cùng tiêu đề, ngày và giờ bắt đầu sẽ thay thế sự kiện tương ứng. Hủy chỉ nhắm đến các sự kiện có tiền tố calpal-, giúp bảo vệ sự kiện được tạo thủ công. Profile cũng lưu tọa độ nhà, tên lịch và các tùy chọn liên quan; schema profile đầy đủ không được ghi trong tệp được cung cấp.