Google Calendar — OpenClaw AI Agent Skill

Интеграция Google Calendar API с управляемой OAuth-аутентификацией. Этот навык позволяет создавать события, просматривать календари, проверять занятость и управлять расписанием — всё через единый интерфейс.

Используйте данный навык, когда требуется взаимодействие с Google Calendar. Для работы с другими сторонними сервисами рекомендуется использовать API Gateway.

Обзор

Навык предоставляет доступ к Google Calendar API через прокси-шлюз с автоматической OAuth-аутентификацией. Это означает, что вам не нужно самостоятельно управлять токенами — система делает это за вас.

• Создание и редактирование событий
• Просмотр списка календарей
• Получение событий
• Проверка занятости (free/busy)
• Удаление и обновление событий

Быстрый старт

Пример запроса для получения ближайших событий:

import urllib.request, os, json

req = urllib.request.Request(
 'https://gateway.maton.ai/google-calendar/calendar/v3/calendars/primary/events?maxResults=10&orderBy=startTime&singleEvents=true'
)
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')

print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

Базовый URL

https://gateway.maton.ai/google-calendar/{native-api-path}

Замените {native-api-path} на соответствующий путь API Google Calendar. Шлюз автоматически перенаправляет запросы к оригинальному API и добавляет OAuth-токен.

Аутентификация

Все запросы требуют наличия API-ключа Maton:

Authorization: Bearer $MATON_API_KEY

Перед использованием необходимо задать переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

API-ключ можно получить в настройках аккаунта на платформе Maton.

Основные возможности API

Список календарей

GET /google-calendar/calendar/v3/users/me/calendarList

Список событий

GET /google-calendar/calendar/v3/calendars/primary/events

Создание события

POST /google-calendar/calendar/v3/calendars/primary/events

Пример тела запроса:

{
 "summary": "Встреча команды",
 "description": "Еженедельный синк",
 "start": {
 "dateTime": "2024-01-15T10:00:00",
 "timeZone": "Europe/Copenhagen"
 },
 "end": {
 "dateTime": "2024-01-15T11:00:00",
 "timeZone": "Europe/Copenhagen"
 }
}

Обновление события

PUT /google-calendar/calendar/v3/calendars/primary/events/{eventId}

Удаление события

DELETE /google-calendar/calendar/v3/calendars/primary/events/{eventId}

Быстрое добавление события

POST /google-calendar/calendar/v3/calendars/primary/events/quickAdd?text=Meeting+tomorrow+at+3pm

Проверка занятости

POST /google-calendar/calendar/v3/freeBusy

Примечания

• Аутентификация происходит автоматически через шлюз
• Используйте primary для основного календаря
• Дата и время должны быть в формате RFC3339
• Для повторяющихся событий используйте singleEvents=true
• Сортировка по времени требует orderBy=startTime

Установка

clawhub install google-calendar-api

После установки навык готов к использованию в вашем AI-агенте.

Интеграция Google Calendar через OpenClaw позволяет значительно упростить автоматизацию расписания и взаимодействие с календарями, объединяя все операции в единый API-интерфейс. :