- name
- claw-calendar
- description
- Create and manage calendar events via Claw Calendar API. Use when users ask to schedule meetings, add reminders, or manage personal calendars. Trigger: "create an event", "add a meeting", "帮我创建日程", "安排一个事件".
- version
- 1.3.0
- homepage
- https://github.com/5twang/claw-calendar
- repository
- https://github.com/5twang/claw-calendar
- metadata
- openclaw
- requires
- env
- primaryEnv
- CALENDAR_API_KEY
Claw Calendar
Overview
This skill enables AI assistants to interact with Claw Calendar, a calendar management API. It provides the ability to create, view, update, and delete calendar events through natural language commands.
How to Use
When user wants to create/manage calendar events:
- Check if user has configured:
- CALENDAR_API_BASE_URL (e.g., https://claw-calendar.com) - CALENDAR_API_KEY (API Key from Claw Calendar settings)
- If not configured, tell user to configure these environment variables in WorkBuddy settings.
- If configured, use the API endpoints below.
API Authentication
IMPORTANT: Use X-API-Key header, NOT Authorization: Bearer
Headers:
X-API-Key: ${CALENDAR_API_KEY}API Endpoints
Base URL: ${CALENDAR_API_BASE_URL}
List Calendars
GET /api/calendars
Headers: X-API-Key: ${CALENDAR_API_KEY}Create Event
POST /api/calendars/{calendarId}/events
Headers:
X-API-Key: ${CALENDAR_API_KEY}
Content-Type: application/json
Body: {
"title": "Event Title",
"startDate": "YYYY-MM-DD",
"endDate": "YYYY-MM-DD",
"startTime": "HH:mm (optional)",
"endTime": "HH:mm (optional)",
"isAllDay": true,
"description": "optional",
"location": "optional",
"alarmEnabled": true,
"alarmMinutes": 15
}List Events
GET /api/events
Headers: X-API-Key: ${CALENDAR_API_KEY}Update Event
PUT /api/calendars/{calendarId}/events/{eventId}
Headers: X-API-Key: ${CALENDAR_API_KEY}Delete Event
DELETE /api/calendars/{calendarId}/events/{eventId}
Headers: X-API-Key: ${CALENDAR_API_KEY}Response Format
Success: { "success": true, event/calendars/events: {...} } Error: { "success": false, error: { code, message } }
Parsing Examples
- "明天上午10点会议" → tomorrow, 10:00
- "下周三生日派对" → next Wednesday
- "今天下午3-4点面试" → today, 15:00-16:00
Defaults: isAllDay=true if no time, alarmMinutes=15, endDate=same as startDate