Claw Calendar

概述

该技能使 AI 助手能够与 Claw Calendar（一款日历管理 API）进行交互，支持通过自然语言指令创建、查看、更新和删除日历事件。

使用方法

当用户希望创建或管理日历事件时：

1. 检查用户是否已完成以下配置：

   • CALENDAR_API_BASE_URL（例如：https://claw-calendar.com）
   • CALENDAR_API_KEY（来自 Claw Calendar 设置页面的 API 密钥）

2. 若尚未配置，请提示用户在 WorkBuddy 设置中配置上述环境变量。

3. 若已配置，则使用下方列出的 API 端点。

API 认证

重要提示：请使用 X-API-Key 请求头，不要使用 Authorization: Bearer

Headers:
  X-API-Key: ${CALENDAR_API_KEY}

API 端点

基础 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点会议” → 明天，10:00
• “下周三生日派对” → 下周三
• “今天下午3-4点面试” → 今天，15:00–16:00

默认行为：未指定时间时 isAllDay=true；默认提醒提前 alarmMinutes=15；未指定结束日期时 endDate 与 startDate 相同。