📦 Claw Calendar

Claw Calendar 概览 该技能让 AI 助手通过自然语言命令与日历管理 API Claw Calendar 交互，实现事件的创建、查看、更新与删除。

使用方法 当用户需要创建/管理日历时：

• 检查是否已配置：

- CALENDAR_API_BASE_URL（例：https://claw-calendar.com） - CALENDAR_API_KEY（来自 Claw Calendar 设置的 API Key）

• 若未配置，提示用户在 WorkBuddy 设置中配置以上环境变量。
• 若已配置，使用下方 API 端点。

API 认证 重要：使用 X-API-Key 请求头，而非 Authorization: Bearer Headers: X-API-Key: ${CALENDAR_API_KEY}

API 端点 Base URL: ${CALENDAR_API_BASE_URL}

• 列出日历

GET /api/calendars Headers: X-API-Key: ${CALENDAR_API_KEY}

• 创建事件

POST /api/calendars/{calendarId}/events Headers: X-API-Key: ${CALENDAR_API_KEY}, Content-Type: application/json Body: { "title": "事件标题", "startDate": "YYYY-MM-DD", "endDate": "YYYY-MM-DD", "startTime": "HH:mm（可选）", "endTime": "HH:mm（可选）", "isAllDay": true, "description": "可选", "location": "可选", "alarmEnabled": true, "alarmMinutes": 15 }

• 列出事件

GET /api/events Headers: X-API-Key: ${CALENDAR_API_KEY}

• 更新事件

PUT /api/calendars/{calendarId}/events/{eventId} Headers: X-API-Key: ${CALENDAR_API_KEY}

• 删除事件

DELETE /api/calendars/{calendarId}/events/{eventId} Headers: X-API-Key: ${CALENDAR_API_KEY}

响应格式 成功：{ "success": true, event/calendars/events: {...} } 错误：{ "success": false, error: { code, message } }

解析示例 “明天上午10点会议” → tomorrow, 10:00 “下周三生日派对” → next Wednesday “今天下午3-4点面试” → today, 15:00-16:00

默认值： 无时间则 isAllDay=true，alarmMinutes=15，endDate 与 startDate 相同。