diff --git a/docs/uk/plugins/google-meet.md b/docs/uk/plugins/google-meet.md index 95d44ac27..07b798138 100644 --- a/docs/uk/plugins/google-meet.md +++ b/docs/uk/plugins/google-meet.md @@ -1,48 +1,95 @@ --- read_when: - Ви хочете, щоб агент OpenClaw приєднався до виклику Google Meet - - Ви налаштовуєте Chrome або Twilio як транспорт Google Meet -summary: 'Plugin Google Meet: приєднання до явних URL-адрес Meet через Chrome або Twilio із типовими налаштуваннями голосу в реальному часі' + - Ви налаштовуєте Chrome або Twilio як транспорт для Google Meet +summary: 'Plugin Google Meet: приєднання до явних URL-адрес Meet через Chrome або Twilio з типовими налаштуваннями голосу в реальному часі' title: Plugin Google Meet x-i18n: - generated_at: "2026-04-24T02:07:03Z" + generated_at: "2026-04-24T02:09:11Z" model: gpt-5.4 provider: openai - source_hash: 6a3b040007d09f1bc13aea1b046868b85c39380f287b1185e644cb8b83761bf5 + source_hash: 57a354040e81dc769f14927364c9fa6aebd95844c2e105badc70341a246fac29 source_path: plugins/google-meet.md workflow: 15 --- # Google Meet (Plugin) -Підтримка учасників Google Meet для OpenClaw. +Підтримка учасника Google Meet для OpenClaw. -Plugin є навмисно явним: +Plugin є явно керованим за задумом: -- Він приєднується лише до явного URL `https://meet.google.com/...`. -- Голос `realtime` є режимом за замовчуванням. -- Голос у режимі реального часу може повертатися до повного агента OpenClaw, коли потрібні глибші міркування або інструменти. -- Автентифікація починається з особистого Google OAuth або вже виконаного входу в профіль Chrome. +- Він приєднується лише за явною URL-адресою `https://meet.google.com/...`. +- Голосовий режим `realtime` є типовим режимом. +- Голосовий режим реального часу може повертатися до повного агента OpenClaw, коли потрібні глибші міркування або інструменти. +- Автентифікація починається як персональний Google OAuth або вже виконаний вхід у профілі Chrome. - Автоматичного оголошення згоди немає. - Типовий аудіобекенд Chrome — `BlackHole 2ch`. -- Twilio приймає номер для дозвону, а також необов’язковий PIN або послідовність DTMF. -- Команда CLI — `googlemeet`; `meet` зарезервовано для ширших сценаріїв телеконференцій агентів. +- Twilio приймає номер для дозвону плюс необов’язковий PIN або послідовність DTMF. +- Команда CLI — `googlemeet`; `meet` зарезервовано для ширших сценаріїв агентських телеконференцій. + +## Швидкий старт + +Установіть локальні аудіозалежності та переконайтеся, що постачальник `realtime` може використовувати OpenAI: + +```bash +brew install blackhole-2ch sox +export OPENAI_API_KEY=sk-... +``` + +Увімкніть Plugin: + +```json5 +{ + plugins: { + entries: { + "google-meet": { + enabled: true, + config: {}, + }, + }, + }, +} +``` + +Перевірте налаштування: + +```bash +openclaw googlemeet setup +``` + +Приєднайтеся до зустрічі: + +```bash +openclaw googlemeet join https://meet.google.com/abc-defg-hij +``` + +Або дозвольте агенту приєднатися через інструмент `google_meet`: + +```json +{ + "action": "join", + "url": "https://meet.google.com/abc-defg-hij" +} +``` + +Chrome приєднується як профіль Chrome, у якому виконано вхід. У Meet виберіть `BlackHole 2ch` для шляху мікрофона/динаміка, який використовує OpenClaw. Для чистого дуплексного аудіо використовуйте окремі віртуальні пристрої або граф у стилі Loopback; одного пристрою BlackHole достатньо для першого smoke-тесту, але може виникати луна. ## Транспорти ### Chrome -Транспорт Chrome відкриває URL Meet у Google Chrome і приєднується як профіль Chrome, у якому виконано вхід. У macOS Plugin перед запуском перевіряє наявність `BlackHole 2ch`. Якщо це налаштовано, він також запускає команду перевірки стану аудіомоста та команду запуску перед відкриттям Chrome. +Транспорт Chrome відкриває URL-адресу Meet у Google Chrome і приєднується як профіль Chrome, у якому виконано вхід. На macOS Plugin перевіряє наявність `BlackHole 2ch` перед запуском. Якщо налаштовано, він також запускає команду перевірки стану аудіомоста та команду запуску перед відкриттям Chrome. ```bash openclaw googlemeet join https://meet.google.com/abc-defg-hij --transport chrome ``` -Спрямуйте аудіо мікрофона та динаміка Chrome через локальний аудіоміст OpenClaw. Якщо `BlackHole 2ch` не встановлено, приєднання завершується помилкою налаштування, а не тихим приєднанням без аудіошляху. +Спрямуйте аудіо мікрофона й динаміка Chrome через локальний аудіоміст OpenClaw. Якщо `BlackHole 2ch` не встановлено, приєднання завершується помилкою налаштування замість тихого приєднання без аудіошляху. ### Twilio -Транспорт Twilio — це строгий план набору, делегований Plugin Voice Call. Він не аналізує сторінки Meet у пошуку телефонних номерів. +Транспорт Twilio — це строгий план дозвону, делегований Plugin Voice Call. Він не розбирає сторінки Meet для пошуку телефонних номерів. ```bash openclaw googlemeet join https://meet.google.com/abc-defg-hij \ @@ -62,13 +109,13 @@ openclaw googlemeet join https://meet.google.com/abc-defg-hij \ ## OAuth і попередня перевірка -Доступ до Google Meet Media API спочатку використовує особистий клієнт OAuth. Налаштуйте `oauth.clientId` і, за бажання, `oauth.clientSecret`, а потім виконайте: +Доступ до Google Meet Media API спочатку використовує персональний клієнт OAuth. Налаштуйте `oauth.clientId` і за потреби `oauth.clientSecret`, а потім виконайте: ```bash openclaw googlemeet auth login --json ``` -Команда виводить блок конфігурації `oauth` з токеном оновлення. Вона використовує PKCE, локальний callback на `http://localhost:8085/oauth2callback` і ручний потік копіювання/вставлення з `--manual`. +Команда виводить блок конфігурації `oauth` з токеном оновлення. Вона використовує PKCE, callback localhost на `http://localhost:8085/oauth2callback` і ручний потік копіювання/вставлення з `--manual`. Ці змінні середовища приймаються як резервні варіанти: @@ -81,23 +128,23 @@ openclaw googlemeet auth login --json - `OPENCLAW_GOOGLE_MEET_DEFAULT_MEETING` або `GOOGLE_MEET_DEFAULT_MEETING` - `OPENCLAW_GOOGLE_MEET_PREVIEW_ACK` або `GOOGLE_MEET_PREVIEW_ACK` -Розв’яжіть URL Meet, код або `spaces/{id}` через `spaces.get`: +Розв’яжіть URL-адресу Meet, код або `spaces/{id}` через `spaces.get`: ```bash openclaw googlemeet resolve-space --meeting https://meet.google.com/abc-defg-hij ``` -Запускайте попередню перевірку перед роботою з медіа: +Запустіть попередню перевірку перед роботою з медіа: ```bash openclaw googlemeet preflight --meeting https://meet.google.com/abc-defg-hij ``` -Установлюйте `preview.enrollmentAcknowledged: true` лише після підтвердження, що ваш Cloud project, принципал OAuth і учасники зустрічі зареєстровані в Google Workspace Developer Preview Program для медіа-API Meet. +Установлюйте `preview.enrollmentAcknowledged: true` лише після підтвердження, що ваш Cloud project, принципал OAuth і учасники зустрічі зареєстровані в Google Workspace Developer Preview Program для Meet media APIs. ## Конфігурація -Поширений шлях Chrome realtime потребує лише ввімкненого Plugin, BlackHole, SoX і ключа OpenAI: +Для поширеного шляху Chrome realtime потрібно лише ввімкнений Plugin, BlackHole, SoX і ключ OpenAI: ```bash brew install blackhole-2ch sox @@ -124,8 +171,8 @@ export OPENAI_API_KEY=sk-... - `defaultTransport: "chrome"` - `defaultMode: "realtime"` - `chrome.audioBackend: "blackhole-2ch"` -- `chrome.audioInputCommand`: команда SoX `rec`, яка записує аудіо 8 кГц G.711 mu-law у stdout -- `chrome.audioOutputCommand`: команда SoX `play`, яка читає аудіо 8 кГц G.711 mu-law зі stdin +- `chrome.audioInputCommand`: команда SoX `rec`, що записує 8 кГц G.711 mu-law аудіо в stdout +- `chrome.audioOutputCommand`: команда SoX `play`, що читає 8 кГц G.711 mu-law аудіо зі stdin - `realtime.provider: "openai"` - `realtime.toolPolicy: "safe-read-only"` - `realtime.instructions`: короткі усні відповіді, з @@ -175,33 +222,31 @@ export OPENAI_API_KEY=sk-... } ``` -Використовуйте `action: "status"`, щоб перелічити активні сесії або перевірити ідентифікатор сесії. Використовуйте `action: "leave"`, щоб позначити сесію як завершену. +Використовуйте `action: "status"`, щоб перелічити активні сесії або перевірити ID сесії. Використовуйте `action: "leave"`, щоб позначити сесію завершеною. -## Консультація агента в режимі реального часу +## Консультація агента в реальному часі -Режим Chrome realtime оптимізований для живого голосового циклу. Постачальник голосу в режимі реального часу чує аудіо зустрічі та говорить через налаштований аудіоміст. Коли моделі реального часу потрібні глибші міркування, актуальна інформація або звичайні інструменти OpenClaw, вона може викликати `openclaw_agent_consult`. +Режим Chrome realtime оптимізований для живого голосового циклу. Постачальник голосу реального часу чує аудіо зустрічі й говорить через налаштований аудіоміст. Коли моделі реального часу потрібні глибші міркування, актуальна інформація або звичайні інструменти OpenClaw, вона може викликати `openclaw_agent_consult`. -Інструмент консультації запускає звичайного агента OpenClaw у фоновому режимі з контекстом нещодавньої стенограми зустрічі та повертає стислу усну відповідь у голосову сесію реального часу. Потім голосова модель може озвучити цю відповідь назад у зустрічі. +Інструмент консультації запускає звичайного агента OpenClaw за лаштунками з контекстом недавньої стенограми зустрічі й повертає стислу усну відповідь до голосової сесії реального часу. Потім голосова модель може озвучити цю відповідь назад у зустріч. `realtime.toolPolicy` керує запуском консультації: -- `safe-read-only`: надає інструмент консультації та обмежує звичайного агента інструментами - `read`, `web_search`, `web_fetch`, `x_search`, `memory_search` і - `memory_get`. -- `owner`: надає інструмент консультації та дозволяє звичайному агенту використовувати стандартну політику інструментів агента. -- `none`: не надає інструмент консультації голосовій моделі реального часу. +- `safe-read-only`: показувати інструмент консультації й обмежувати звичайного агента інструментами `read`, `web_search`, `web_fetch`, `x_search`, `memory_search` і `memory_get`. +- `owner`: показувати інструмент консультації й дозволяти звичайному агенту використовувати звичайну політику інструментів агента. +- `none`: не показувати інструмент консультації моделі голосу реального часу. -Ключ сесії консультації має область дії в межах кожної сесії Meet, тому подальші виклики консультації можуть повторно використовувати попередній контекст консультацій під час тієї самої зустрічі. +Ключ сесії консультації має область дії на кожну сесію Meet, тож наступні виклики консультації можуть повторно використовувати попередній контекст консультації під час тієї самої зустрічі. ## Примітки -Офіційний медіа-API Google Meet орієнтований на прийом, тому для мовлення у виклик Meet усе ще потрібен шлях участі. Цей Plugin робить цю межу видимою: Chrome забезпечує участь через браузер і локальне маршрутизування аудіо; Twilio забезпечує участь через телефонний дозвін. +Офіційний media API Google Meet орієнтований на прийом, тому для мовлення в дзвінок Meet усе ще потрібен шлях учасника. Цей Plugin зберігає цю межу видимою: Chrome обробляє участь через браузер і локальне маршрутизування аудіо; Twilio обробляє участь через телефонний дозвін. -Режим Chrome realtime потребує одного з таких варіантів: +Для режиму Chrome realtime потрібен один із варіантів: -- `chrome.audioInputCommand` плюс `chrome.audioOutputCommand`: OpenClaw керує мостом моделі реального часу та передає аудіо 8 кГц G.711 mu-law між цими командами та вибраним постачальником голосу реального часу. -- `chrome.audioBridgeCommand`: зовнішня команда мосту керує всім локальним аудіошляхом і має завершитися після запуску або перевірки свого демона. +- `chrome.audioInputCommand` плюс `chrome.audioOutputCommand`: OpenClaw керує мостом моделі реального часу та передає 8 кГц G.711 mu-law аудіо між цими командами й вибраним постачальником голосу реального часу. +- `chrome.audioBridgeCommand`: зовнішня команда моста керує всім локальним аудіошляхом і має завершитися після запуску або перевірки свого демона. -Для чистого двостороннього аудіо спрямовуйте вихід Meet і мікрофон Meet через окремі віртуальні пристрої або граф віртуальних пристроїв у стилі Loopback. Один спільний пристрій BlackHole може повертати голоси інших учасників назад у виклик. +Для чистого дуплексного аудіо маршрутизуйте вихід Meet і мікрофон Meet через окремі віртуальні пристрої або граф віртуальних пристроїв у стилі Loopback. Один спільний пристрій BlackHole може повертати голоси інших учасників назад у дзвінок. -`googlemeet leave` зупиняє аудіоміст реального часу на парі команд для сесій Chrome. Для сесій Twilio, делегованих через Plugin Voice Call, команда також завершує базовий голосовий виклик. +`googlemeet leave` зупиняє аудіоміст реального часу на основі пари команд для сесій Chrome. Для сесій Twilio, делегованих через Plugin Voice Call, він також кладе слухавку в базовому голосовому дзвінку.