​

Google Chat (Chat API)

​

Быстрая настройка (для начинающих)

1. Создайте проект Google Cloud и включите Google Chat API.
   • Перейдите: Google Chat API Credentials
   • Включите API, если он ещё не включён.
2. Создайте Service Account:
   • Нажмите Create Credentials > Service Account.
   • Задайте любое имя (например, openclaw-chat).
   • Оставьте права доступа пустыми (нажмите Continue).
   • Оставьте список субъектов с доступом пустым (нажмите Done).
3. Создайте и скачайте JSON Key:
   • В списке сервисных аккаунтов нажмите на только что созданный.
   • Перейдите на вкладку Keys.
   • Нажмите Add Key > Create new key.
   • Выберите JSON и нажмите Create.
4. Сохраните загруженный JSON‑файл на хосте шлюза Gateway (например, ~/.openclaw/googlechat-service-account.json).
5. Создайте приложение Google Chat в Google Cloud Console Chat Configuration:
   • Заполните Application info:
     • App name: (например, OpenClaw)
     • Avatar URL: (например, https://openclaw.ai/logo.png)
     • Description: (например, Personal AI Assistant)
   • Включите Interactive features.
   • В разделе Functionality отметьте Join spaces and group conversations.
   • В разделе Connection settings выберите HTTP endpoint URL.
   • В разделе Triggers выберите Use a common HTTP endpoint URL for all triggers и укажите публичный URL вашего шлюза с добавлением /googlechat.
     • Совет: выполните openclaw status, чтобы узнать публичный URL вашего шлюза.
   • В разделе Visibility отметьте Make this Chat app available to specific people and groups in <Your Domain>.
   • Введите свой адрес электронной почты (например, [email protected]) в текстовое поле.
   • Нажмите Save внизу страницы.
6. Включите статус приложения:
   • После сохранения обновите страницу.
   • Найдите раздел App status (обычно сверху или снизу после сохранения).
   • Измените статус на Live - available to users.
   • Снова нажмите Save.
7. Настройте OpenClaw, указав путь к сервисному аккаунту и audience вебхука:
   • Переменная окружения: GOOGLE_CHAT_SERVICE_ACCOUNT_FILE=/path/to/service-account.json
   • Или в конфиге: channels.googlechat.serviceAccountFile: "/path/to/service-account.json".
8. Задайте тип и значение audience вебхука (должны совпадать с конфигурацией приложения Chat).
9. Запустите шлюз. Google Chat будет отправлять POST‑запросы на путь вашего вебхука.

​

Добавление в Google Chat

1. Перейдите на Google Chat.
2. Нажмите значок + рядом с Direct Messages.
3. В строке поиска (где обычно добавляют людей) введите App name, который вы настроили в Google Cloud Console.
   • Примечание: бот не появится в списке «Marketplace», так как это приватное приложение. Его нужно искать по имени.
4. Выберите вашего бота из результатов.
5. Нажмите Add или Chat, чтобы начать диалог 1:1.
6. Отправьте «Hello», чтобы запустить ассистента!

​

Публичный URL (только вебхуки)

​

Вариант A: Tailscale Funnel (рекомендуется)

1. Проверьте, к какому адресу привязан ваш шлюз:
   ss -tlnp | grep 18789
   
   Запомните IP‑адрес (например, 127.0.0.1, 0.0.0.0 или ваш IP Tailscale, например 100.x.x.x).
2. Откройте панель только для tailnet (порт 8443):
   # If bound to localhost (127.0.0.1 or 0.0.0.0):
   tailscale serve --bg --https 8443 http://127.0.0.1:18789
   
   # If bound to Tailscale IP only (e.g., 100.106.161.80):
   tailscale serve --bg --https 8443 http://100.106.161.80:18789
   
3. Публично откройте только путь вебхука:
   # If bound to localhost (127.0.0.1 or 0.0.0.0):
   tailscale funnel --bg --set-path /googlechat http://127.0.0.1:18789/googlechat
   
   # If bound to Tailscale IP only (e.g., 100.106.161.80):
   tailscale funnel --bg --set-path /googlechat http://100.106.161.80:18789/googlechat
   
4. Авторизуйте узел для доступа Funnel: Если появится запрос, перейдите по URL авторизации, показанному в выводе, чтобы включить Funnel для этого узла в политике tailnet.
5. Проверьте конфигурацию:
   tailscale serve status
   tailscale funnel status
   

Примечание: эта конфигурация сохраняется между перезагрузками. Чтобы удалить её позже, выполните tailscale funnel reset и tailscale serve reset.

​

Вариант B: Обратный прокси (Caddy)

your-domain.com {
    reverse_proxy /googlechat* localhost:18789
}

​

Вариант C: Cloudflare Tunnel

• Путь: /googlechat -> http://localhost:18789/googlechat
• Правило по умолчанию: HTTP 404 (Не найдено)

​

Как это работает

1. Google Chat отправляет POST‑запросы вебхука на шлюз. Каждый запрос включает заголовок Authorization: Bearer <token>.
2. OpenClaw проверяет токен относительно настроенных audienceType + audience:
   • audienceType: "app-url" → audience — это ваш HTTPS‑URL вебхука.
   • audienceType: "project-number" → audience — это номер проекта Cloud.
3. Сообщения маршрутизируются по пространству:
   • Личные сообщения используют ключ сеанса agent:<agentId>:googlechat:dm:<spaceId>.
   • Пространства используют ключ сеанса agent:<agentId>:googlechat:group:<spaceId>.
4. Доступ к личным сообщениям по умолчанию — через сопряжение. Неизвестные отправители получают код сопряжения; подтвердите с помощью:
   • openclaw pairing approve googlechat <code>
5. Групповые пространства по умолчанию требуют @‑упоминания. Используйте botUser, если обнаружение упоминаний должно учитывать имя пользователя приложения.

​

Цели

• Личные сообщения: users/<userId> или users/<email> (адреса электронной почты принимаются).
• Устарело: users/<email> рассматривается как идентификатор пользователя, а не как список разрешённых email-адресов.
• Пространства: spaces/<spaceId>.

​

Основные моменты конфига

{
  channels: {
    googlechat: {
      enabled: true,
      serviceAccountFile: "/path/to/service-account.json",
      audienceType: "app-url",
      audience: "https://gateway.example.com/googlechat",
      webhookPath: "/googlechat",
      botUser: "users/1234567890", // optional; helps mention detection
      dm: {
        policy: "pairing",
        allowFrom: ["users/1234567890", "[email protected]"],
      },
      groupPolicy: "allowlist",
      groups: {
        "spaces/AAAA": {
          allow: true,
          requireMention: true,
          users: ["users/1234567890"],
          systemPrompt: "Short answers only.",
        },
      },
      actions: { reactions: true },
      typingIndicator: "message",
      mediaMaxMb: 20,
    },
  },
}

• Учётные данные сервисного аккаунта также можно передавать inline с помощью serviceAccount (строка JSON).
• Путь вебхука по умолчанию — /googlechat, если webhookPath не задан.
• Реакции доступны через инструмент reactions и channels action, когда включён actions.reactions.
• typingIndicator поддерживает none, message (по умолчанию) и reaction (реакции требуют OAuth пользователя).
• Вложения загружаются через Chat API и сохраняются в медиапайплайне (размер ограничен mediaMaxMb).

​

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

​

405 Method Not Allowed

status code: 405, reason phrase: HTTP error response: HTTP/1.1 405 Method Not Allowed

1. Канал не настроен: в конфиге отсутствует раздел channels.googlechat. Проверьте с помощью:
   openclaw config get channels.googlechat
   
   Если возвращается «Config path not found», добавьте конфигурацию (см. Основные моменты конфига).
2. Плагин не включён: проверьте статус плагина:
   openclaw plugins list | grep googlechat
   
   Если отображается «disabled», добавьте plugins.entries.googlechat.enabled: true в конфиг.
3. Шлюз не перезапущен: после добавления конфига перезапустите шлюз:
   openclaw gateway restart
   

openclaw channels status
# Should show: Google Chat default: enabled, configured, ...

​

Другие проблемы

• Проверьте openclaw channels status --probe на ошибки аутентификации или отсутствующую конфигурацию audience.
• Если сообщения не приходят, проверьте URL вебхука и подписки на события в приложении Chat.
• Если ответы блокируются проверкой упоминаний, задайте botUser равным имени ресурса пользователя приложения и проверьте requireMention.
• Используйте openclaw logs --follow при отправке тестового сообщения, чтобы увидеть, доходят ли запросы до шлюза.

• Конфигурация Gateway (шлюз)
• Безопасность
• Реакции