Интеграция с Google Workspace

В этом руководстве объясняется, как интегрировать Google Workspace с OpenClaw Ultra с помощью GoG CLI.

Поддерживаемые сервисы

Сервис	Возможности
Gmail	Чтение, отправка, поиск, организация электронных писем
Calendar	События, расписания, напоминания
Drive	Управление файлами, общий доступ, поиск
Docs	Создание, редактирование, форматирование документов
Sheets	Операции с таблицами, запросы данных
Slides	Создание и редактирование презентаций
Contacts	Управление и синхронизация контактов
Tasks	Создание и отслеживание задач

Предварительные требования

Элемент	Требование
OpenClaw Ultra	Установлен и настроен
Google Аккаунт	Активный аккаунт Gmail/Workspace

Шаг 1: Установка GoG CLI в OpenClaw Ultra

1. Откройте OpenClaw Ultra и начните новый чат
2. Попросите агента установить GoG CLI:

   Установить GoG CLI для Windows

3. Агент поможет вам загрузить с официального релиза и добавить в PATH системы
4. Проверка установки:

   gog --version

Шаг 2: Создание клиента OAuth

1. Посетите Google Cloud Console
2. Создайте новый проект
3. Включите необходимые API (Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, Tasks) — только те, которые вам действительно нужны
4. Настройте экран согласия OAuth на «Внешний»
5. Создайте клиент OAuth для настольного приложения в Клиентах OAuth
6. Скачайте файл JSON и сохраните его в безопасном месте

Шаг 3: Аутентификация в OpenClaw Ultra

1. В чате укажите путь к файлу OAuth JSON и пройдите аутентификацию:

   gog auth credentials /path/to/your/client_secret.json
   gog auth add [email protected] --services gmail,calendar,drive,docs,sheets,slides,contacts,tasks

2. Откроется окно браузера для авторизации
3. Предоставьте запрашиваемые разрешения
4. Агент подтвердит, когда все сервисы будут подключены

Шаг 4: Начало работы с Google Workspace

Теперь вы можете использовать естественный язык в чате:

Gmail

• Проверь мои непрочитанные письма за сегодня
• Отправь письмо [email protected] о встрече
• Найди письма об обновлениях проекта

Calendar

• Запланируй встречу завтра в 14:00
• Покажи мой календарь на эту неделю
• Создай событие с названием Обзор команды

Drive

• Загрузи этот файл на мой Drive
• Найди документы по планированию Q4
• Поделись отчётом с [email protected]

Docs

• Создай новый документ с названием Протокол совещания
• Отредактируй последний созданный мной документ

Sheets

• Покажи данные из Sheet1 с A1 по D20
• Создай таблицу для отслеживания бюджета

Slides

• Создай презентацию из этого markdown
• Обнови слайды еженедельного статуса

Contacts

• Покажи контакты из Acme Corp
• Добавь новый контакт для Jane Doe

Tasks

• Создай задачу для проверки предложения
• Покажи мои задачи на эту неделю

Советы по безопасности

WARNING

• Предоставляйте только необходимые разрешения
• Регулярно проверяйте подключённые приложения в вашем аккаунте Google
• Отзывайте доступ, когда он больше не нужен

Устранение неполадок

Проблема	Решение
Ошибка аутентификации	Повторите аутентификацию в чате
Команды не работают	Проверьте установку GoG CLI
Ошибки синхронизации	Проверьте подключение к интернету и попробуйте снова