From aa5bb981b2f108214cd038596e9a44167068cc06 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 27 Apr 2026 06:53:12 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/providers/google.md | 245 ++++++++++++++++++------------------ 1 file changed, 125 insertions(+), 120 deletions(-) diff --git a/docs/uk/providers/google.md b/docs/uk/providers/google.md index ce2770b61..c6f1458d7 100644 --- a/docs/uk/providers/google.md +++ b/docs/uk/providers/google.md @@ -5,34 +5,34 @@ read_when: summary: Налаштування Google Gemini (API-ключ + OAuth, генерація зображень, розуміння медіа, TTS, вебпошук) title: Google (Gemini) x-i18n: - generated_at: "2026-04-26T07:50:36Z" + generated_at: "2026-04-27T06:52:18Z" model: gpt-5.4 provider: openai - source_hash: 312c7a5bc433831d98d1d47c42c5cac6a4cd8d4948ddbf16f1ae11aaec7a0339 + source_hash: 7130cd7e13a4ca76572572bb77f1926be0fbe1fa4e1d3c0f9619d31ba564a163 source_path: providers/google.md workflow: 15 --- -Plugin Google надає доступ до моделей Gemini через Google AI Studio, а також до -генерації зображень, розуміння медіа (зображення/аудіо/відео), text-to-speech і вебпошуку через +Плагін Google надає доступ до моделей Gemini через Google AI Studio, а також до +генерації зображень, розуміння медіа (зображення/аудіо/відео), перетворення тексту на мовлення та вебпошуку через Gemini Grounding. -- Provider: `google` -- Auth: `GEMINI_API_KEY` або `GOOGLE_API_KEY` +- Провайдер: `google` +- Автентифікація: `GEMINI_API_KEY` або `GOOGLE_API_KEY` - API: Google Gemini API -- Параметр runtime: `agents.defaults.agentRuntime.id: "google-gemini-cli"` - повторно використовує OAuth Gemini CLI, зберігаючи canonical refs моделей як `google/*`. +- Параметр середовища виконання: `agents.defaults.agentRuntime.id: "google-gemini-cli"` + повторно використовує OAuth Gemini CLI, зберігаючи канонічні посилання на моделі як `google/*`. ## Початок роботи -Виберіть бажаний спосіб автентифікації й виконайте кроки налаштування. +Виберіть бажаний спосіб автентифікації та виконайте кроки налаштування. - - **Найкраще для:** стандартного доступу до Gemini API через Google AI Studio. + + **Найкраще підходить для:** стандартного доступу до Gemini API через Google AI Studio. - + ```bash openclaw onboard --auth-choice gemini-api-key ``` @@ -46,7 +46,7 @@ Gemini Grounding. --gemini-api-key "$GEMINI_API_KEY" ``` - + ```json5 { agents: { @@ -57,7 +57,7 @@ Gemini Grounding. } ``` - + ```bash openclaw models list --provider google ``` @@ -65,21 +65,21 @@ Gemini Grounding. - Змінні середовища `GEMINI_API_KEY` і `GOOGLE_API_KEY` обидві підтримуються. Використовуйте ту, яка у вас уже налаштована. + Змінні середовища `GEMINI_API_KEY` і `GOOGLE_API_KEY` обидві підтримуються. Використовуйте ту, яку у вас уже налаштовано. - **Найкраще для:** повторного використання наявного входу Gemini CLI через PKCE OAuth замість окремого API-ключа. + **Найкраще підходить для:** повторного використання наявного входу Gemini CLI через PKCE OAuth замість окремого API-ключа. - Provider `google-gemini-cli` є неофіційною інтеграцією. Деякі користувачі - повідомляють про обмеження акаунтів при використанні OAuth у такий спосіб. Використовуйте на власний ризик. + Провайдер `google-gemini-cli` є неофіційною інтеграцією. Деякі користувачі + повідомляють про обмеження акаунта під час використання OAuth таким способом. Використовуйте на власний ризик. - + Локальна команда `gemini` має бути доступною в `PATH`. ```bash @@ -90,23 +90,23 @@ Gemini Grounding. npm install -g @google/gemini-cli ``` - OpenClaw підтримує як інсталяції через Homebrew, так і глобальні інсталяції npm, зокрема + OpenClaw підтримує як встановлення через Homebrew, так і глобальні встановлення npm, зокрема типові схеми Windows/npm. - + ```bash openclaw models auth login --provider google-gemini-cli --set-default ``` - + ```bash openclaw models list --provider google ``` - - Типова model: `google/gemini-3.1-pro-preview` - - Runtime: `google-gemini-cli` + - Модель за замовчуванням: `google/gemini-3.1-pro-preview` + - Середовище виконання: `google-gemini-cli` - Псевдонім: `gemini-cli` **Змінні середовища:** @@ -117,17 +117,17 @@ Gemini Grounding. (Або варіанти `GEMINI_CLI_*`.) - Якщо запити Gemini CLI OAuth після входу завершуються помилкою, установіть `GOOGLE_CLOUD_PROJECT` або - `GOOGLE_CLOUD_PROJECT_ID` на хості gateway і повторіть спробу. + Якщо запити OAuth Gemini CLI не вдаються після входу, установіть `GOOGLE_CLOUD_PROJECT` або + `GOOGLE_CLOUD_PROJECT_ID` на хості шлюзу й повторіть спробу. - Якщо вхід завершується помилкою ще до запуску потоку в браузері, переконайтеся, що локальну команду `gemini` - встановлено й вона є в `PATH`. + Якщо вхід завершується помилкою до запуску браузерного потоку, переконайтеся, що локальну команду `gemini` + встановлено й додано до `PATH`. - Посилання на model `google-gemini-cli/*` — це застарілі сумісні псевдоніми. Нові - конфігурації мають використовувати посилання на model `google/*` плюс runtime `google-gemini-cli`, + Посилання на моделі `google-gemini-cli/*` — це застарілі псевдоніми сумісності. Нові + конфігурації мають використовувати посилання на моделі `google/*` разом із середовищем виконання `google-gemini-cli`, якщо потрібне локальне виконання Gemini CLI. @@ -137,38 +137,38 @@ Gemini Grounding. | Можливість | Підтримка | | --------------------- | ------------------------------ | -| Доповнення чату | Так | +| Завершення чату | Так | | Генерація зображень | Так | | Генерація музики | Так | -| Text-to-speech | Так | -| Голос у realtime | Так (Google Live API) | +| Перетворення тексту на мовлення | Так | +| Голос у реальному часі| Так (Google Live API) | | Розуміння зображень | Так | -| Транскрипція аудіо | Так | +| Транскрибування аудіо | Так | | Розуміння відео | Так | | Вебпошук (Grounding) | Так | -| Thinking/reasoning | Так (Gemini 2.5+ / Gemini 3+) | +| Мислення/міркування | Так (Gemini 2.5+ / Gemini 3+) | | Моделі Gemma 4 | Так | Моделі Gemini 3 використовують `thinkingLevel` замість `thinkingBudget`. OpenClaw зіставляє -елементи керування reasoning для Gemini 3, Gemini 3.1 і псевдонімів `gemini-*-latest` з -`thinkingLevel`, щоб типові/низьколатентні запуски не надсилали вимкнені +елементи керування міркуванням для Gemini 3, Gemini 3.1 і псевдонімів `gemini-*-latest` з +`thinkingLevel`, щоб типові запуски або запуски з низькою затримкою не надсилали вимкнені значення `thinkingBudget`. -`/think adaptive` зберігає семантику динамічного thinking Google замість вибору -фіксованого рівня OpenClaw. Gemini 3 і Gemini 3.1 не надсилають фіксований `thinkingLevel`, тож -Google може сам вибрати рівень; Gemini 2.5 надсилає динамічний sentinel Google +`/think adaptive` зберігає динамічну семантику мислення Google замість вибору +фіксованого рівня OpenClaw. Gemini 3 і Gemini 3.1 не передають фіксований `thinkingLevel`, щоб +Google могла вибрати рівень; Gemini 2.5 надсилає динамічний sentinel Google `thinkingBudget: -1`. -Моделі Gemma 4 (наприклад, `gemma-4-26b-a4b-it`) підтримують режим thinking. OpenClaw -переписує `thinkingBudget` у підтримуваний Google `thinkingLevel` для Gemma 4. -Установлення thinking у `off` зберігає вимкнений стан thinking замість зіставлення з +Моделі Gemma 4 (наприклад, `gemma-4-26b-a4b-it`) підтримують режим мислення. OpenClaw +перезаписує `thinkingBudget` на підтримуваний Google `thinkingLevel` для Gemma 4. +Установлення мислення в `off` зберігає мислення вимкненим замість зіставлення з `MINIMAL`. ## Генерація зображень -Вбудований provider генерації зображень `google` типово використовує +Вбудований провайдер генерації зображень `google` за замовчуванням використовує `google/gemini-3.1-flash-image-preview`. - Також підтримує `google/gemini-3-pro-image-preview` @@ -176,7 +176,7 @@ Google може сам вибрати рівень; Gemini 2.5 надсилає - Режим редагування: увімкнено, до 5 вхідних зображень - Керування геометрією: `size`, `aspectRatio` і `resolution` -Щоб використовувати Google як типовий provider зображень: +Щоб використовувати Google як провайдера зображень за замовчуванням: ```json5 { @@ -191,20 +191,20 @@ Google може сам вибрати рівень; Gemini 2.5 надсилає ``` -Див. [Генерація зображень](/uk/tools/image-generation), щоб дізнатися про спільні параметри tools, вибір provider і поведінку failover. +Див. [Генерація зображень](/uk/tools/image-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою резервного перемикання. ## Генерація відео Вбудований Plugin `google` також реєструє генерацію відео через спільний -tool `video_generate`. +інструмент `video_generate`. -- Типова відеомодель: `google/veo-3.1-fast-generate-preview` -- Режими: text-to-video, image-to-video і потоки з одним опорним відео +- Модель відео за замовчуванням: `google/veo-3.1-fast-generate-preview` +- Режими: текст у відео, зображення у відео та потоки з одним еталонним відео - Підтримує `aspectRatio`, `resolution` і `audio` - Поточне обмеження тривалості: **від 4 до 8 секунд** -Щоб використовувати Google як типовий відеопровайдер: +Щоб використовувати Google як провайдера відео за замовчуванням: ```json5 { @@ -219,22 +219,22 @@ tool `video_generate`. ``` -Див. [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри tools, вибір provider і поведінку failover. +Див. [Генерація відео](/uk/tools/video-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою резервного перемикання. ## Генерація музики Вбудований Plugin `google` також реєструє генерацію музики через спільний -tool `music_generate`. +інструмент `music_generate`. -- Типова музична model: `google/lyria-3-clip-preview` +- Модель музики за замовчуванням: `google/lyria-3-clip-preview` - Також підтримує `google/lyria-3-pro-preview` -- Керування prompt: `lyrics` і `instrumental` -- Формат виводу: типово `mp3`, а також `wav` у `google/lyria-3-pro-preview` -- Опорні входи: до 10 зображень -- Запуски з підтримкою sessions відокремлюються через спільний потік task/status, зокрема `action: "status"` +- Керування підказкою: `lyrics` і `instrumental` +- Формат виводу: `mp3` за замовчуванням, а також `wav` для `google/lyria-3-pro-preview` +- Еталонні вхідні дані: до 10 зображень +- Запуски з підтримкою сесій від’єднуються через спільний потік завдань/стану, зокрема `action: "status"` -Щоб використовувати Google як типовий музичний provider: +Щоб використовувати Google як провайдера музики за замовчуванням: ```json5 { @@ -249,20 +249,20 @@ tool `music_generate`. ``` -Див. [Генерація музики](/uk/tools/music-generation), щоб дізнатися про спільні параметри tools, вибір provider і поведінку failover. +Див. [Генерація музики](/uk/tools/music-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою резервного перемикання. -## Text-to-speech +## Перетворення тексту на мовлення -Вбудований speech provider `google` використовує шлях Gemini API TTS з +Вбудований мовленнєвий провайдер `google` використовує шлях TTS Gemini API з `gemini-3.1-flash-tts-preview`. -- Типовий голос: `Kore` -- Auth: `messages.tts.providers.google.apiKey`, `models.providers.google.apiKey`, `GEMINI_API_KEY` або `GOOGLE_API_KEY` -- Вивід: WAV для звичайних вкладень TTS, Opus для цілей voice-note, PCM для Talk/телефонії -- Вивід voice-note: Google PCM обгортається у WAV і перекодовується в 48 kHz Opus за допомогою `ffmpeg` +- Голос за замовчуванням: `Kore` +- Автентифікація: `messages.tts.providers.google.apiKey`, `models.providers.google.apiKey`, `GEMINI_API_KEY` або `GOOGLE_API_KEY` +- Вивід: WAV для звичайних вкладень TTS, Opus для цілей голосових нотаток, PCM для Talk/телефонії +- Вивід голосових нотаток: Google PCM обгортається у WAV і перекодовується в 48 кГц Opus за допомогою `ffmpeg` -Щоб використовувати Google як типовий TTS provider: +Щоб використовувати Google як TTS-провайдера за замовчуванням: ```json5 { @@ -274,7 +274,7 @@ tool `music_generate`. google: { model: "gemini-3.1-flash-tts-preview", voiceName: "Kore", - audioProfile: "Говоріть професійно й спокійним тоном.", + audioProfile: "Speak professionally with a calm tone.", }, }, }, @@ -282,41 +282,44 @@ tool `music_generate`. } ``` -Gemini API TTS використовує підказки природною мовою для керування стилем. Установіть -`audioProfile`, щоб додавати багаторазово використовуваний стильовий prompt перед озвучуваним текстом. Установіть -`speakerName`, коли текст вашого prompt посилається на іменованого мовця. +TTS Gemini API використовує підказки природною мовою для керування стилем. Установіть +`audioProfile`, щоб додавати багаторазово використовувану підказку стилю перед озвученим текстом. Установіть +`speakerName`, якщо текст вашої підказки посилається на іменованого мовця. -Gemini API TTS також приймає виразні квадратні audio-теги в тексті, -наприклад `[whispers]` або `[laughs]`. Щоб приховати теги з видимої відповіді чату, -але передати їх у TTS, помістіть їх у блок `[[tts:text]]...[[/tts:text]]`: +TTS Gemini API також приймає виразні аудіотеги в квадратних дужках у тексті, +наприклад `[whispers]` або `[laughs]`. Щоб не показувати теги у видимій відповіді чату, +але надсилати їх у TTS, помістіть їх у блок `[[tts:text]]...[[/tts:text]]`: ```text -Ось чистий текст відповіді. +Тут чистий текст відповіді. -[[tts:text]][whispers] Ось озвучена версія.[[/tts:text]] +[[tts:text]][whispers] Тут озвучена версія.[[/tts:text]] ``` -API-ключ Google Cloud Console, обмежений Gemini API, є валідним для цього -provider. Це не окремий шлях Cloud Text-to-Speech API. +API-ключ Google Cloud Console, обмежений Gemini API, є дійсним для цього +провайдера. Це не окремий шлях Cloud Text-to-Speech API. -## Голос у realtime +## Голос у реальному часі -Вбудований Plugin `google` реєструє provider голосу в realtime на основі +Вбудований Plugin `google` реєструє провайдера голосу в реальному часі на базі Gemini Live API для серверних аудіомостів, таких як Voice Call і Google Meet. -| Параметр | Шлях конфігурації | Типове значення | -| --------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | -| Model | `plugins.entries.voice-call.config.realtime.providers.google.model` | `gemini-2.5-flash-native-audio-preview-12-2025` | -| Голос | `...google.voice` | `Kore` | -| Temperature | `...google.temperature` | (не встановлено) | -| Чутливість початку VAD| `...google.startSensitivity` | (не встановлено) | -| Чутливість кінця VAD | `...google.endSensitivity` | (не встановлено) | -| Тривалість тиші | `...google.silenceDurationMs` | (не встановлено) | -| API-ключ | `...google.apiKey` | Використовує `models.providers.google.apiKey`, `GEMINI_API_KEY` або `GOOGLE_API_KEY` | +| Налаштування | Шлях конфігурації | За замовчуванням | +| --------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | +| Модель | `plugins.entries.voice-call.config.realtime.providers.google.model` | `gemini-2.5-flash-native-audio-preview-12-2025` | +| Голос | `...google.voice` | `Kore` | +| Температура | `...google.temperature` | (не встановлено) | +| Чутливість початку VAD| `...google.startSensitivity` | (не встановлено) | +| Чутливість завершення VAD | `...google.endSensitivity` | (не встановлено) | +| Тривалість тиші | `...google.silenceDurationMs` | (не встановлено) | +| Обробка активності | `...google.activityHandling` | Значення Google за замовчуванням, `start-of-activity-interrupts` | +| Охоплення ходу | `...google.turnCoverage` | Значення Google за замовчуванням, `only-activity` | +| Вимкнути автоматичний VAD | `...google.automaticActivityDetectionDisabled` | `false` | +| API-ключ | `...google.apiKey` | Резервно використовує `models.providers.google.apiKey`, `GEMINI_API_KEY` або `GOOGLE_API_KEY` | -Приклад конфігурації realtime для Voice Call: +Приклад конфігурації Voice Call у реальному часі: ```json5 { @@ -332,6 +335,8 @@ Gemini Live API для серверних аудіомостів, таких я google: { model: "gemini-2.5-flash-native-audio-preview-12-2025", voice: "Kore", + activityHandling: "start-of-activity-interrupts", + turnCoverage: "only-activity", }, }, }, @@ -343,33 +348,33 @@ Gemini Live API для серверних аудіомостів, таких я ``` -Google Live API використовує двонапрямлений audio і function calling через WebSocket. -OpenClaw адаптує audio телефонії/мосту Meet до потоку Gemini PCM Live API і -зберігає виклики tools у межах спільного контракту голосу в realtime. Залишайте `temperature` -не встановленим, якщо вам не потрібно змінювати семплювання; OpenClaw не надсилає недодатні значення, -оскільки Google Live може повертати транскрипти без audio для `temperature: 0`. -Транскрипція Gemini API вмикається без `languageCodes`; поточний SDK Google -відхиляє підказки кодів мов на цьому шляху API. +Google Live API використовує двонапрямне аудіо та виклик функцій через WebSocket. +OpenClaw адаптує аудіо телекомунікаційного/Meet-моста до потоку PCM Live API Gemini і +зберігає виклики інструментів у спільному контракті голосу в реальному часі. Залишайте `temperature` +не встановленим, якщо вам не потрібні зміни семплювання; OpenClaw пропускає недодатні значення, +оскільки Google Live може повертати транскрипти без аудіо для `temperature: 0`. +Транскрибування Gemini API увімкнено без `languageCodes`; поточний Google +SDK відхиляє підказки кодів мов у цьому шляху API. -Сеанси browser Talk у Control UI все ще вимагають provider голосу в realtime з -реалізацією browser-сеансу WebRTC. Наразі цей шлях — OpenAI Realtime; provider -Google призначений для серверних мостів у realtime. +Сеанси браузера Talk у Control UI усе ще потребують провайдера голосу в реальному часі з +реалізацією браузерного сеансу WebRTC. Сьогодні цим шляхом є OpenAI Realtime; провайдер +Google призначений для серверних мостів реального часу. ## Розширена конфігурація - - Для прямих запусків Gemini API (`api: "google-generative-ai"`) OpenClaw - передає налаштований дескриптор `cachedContent` безпосередньо в запити Gemini. + + Для прямих запусків Gemini API (`api: "google-generative-ai"`), OpenClaw + передає налаштований дескриптор `cachedContent` у запити Gemini. - - Налаштуйте параметри для кожної model або глобально за допомогою - `cachedContent` або застарілого `cached_content` + - Налаштовуйте параметри для моделі або глобально через + `cachedContent` або застарілий `cached_content` - Якщо присутні обидва, пріоритет має `cachedContent` - Приклад значення: `cachedContents/prebuilt-context` - - Використання збігів кешу Gemini нормалізується в OpenClaw як `cacheRead` з + - Використання Gemini cache-hit нормалізується в OpenClaw `cacheRead` з вихідного `cachedContentTokenCount` ```json5 @@ -390,20 +395,20 @@ Google призначений для серверних мостів у realtime - - Під час використання OAuth provider `google-gemini-cli` OpenClaw нормалізує + + Під час використання OAuth-провайдера `google-gemini-cli` OpenClaw нормалізує JSON-вивід CLI таким чином: - Текст відповіді береться з поля CLI JSON `response`. - - Використання повертається до `stats`, якщо CLI залишає `usage` порожнім. - - `stats.cached` нормалізується в OpenClaw як `cacheRead`. - - Якщо `stats.input` відсутнє, OpenClaw виводить вхідні токени з + - Використання резервно береться зі `stats`, якщо CLI залишає `usage` порожнім. + - `stats.cached` нормалізується в OpenClaw `cacheRead`. + - Якщо `stats.input` відсутній, OpenClaw виводить вхідні токени з `stats.input_tokens - stats.cached`. - - Якщо Gateway працює як daemon (launchd/systemd), переконайтеся, що `GEMINI_API_KEY` + + Якщо Gateway працює як демон (launchd/systemd), переконайтеся, що `GEMINI_API_KEY` доступний цьому процесу (наприклад, у `~/.openclaw/.env` або через `env.shellEnv`). @@ -412,16 +417,16 @@ Google призначений для серверних мостів у realtime ## Пов’язане - - Вибір provider, refs моделей і поведінка failover. + + Вибір провайдерів, посилань на моделі та поведінки резервного перемикання. - - Спільні параметри tool для зображень і вибір provider. + + Спільні параметри інструмента зображень і вибір провайдера. - - Спільні параметри tool для відео і вибір provider. + + Спільні параметри інструмента відео і вибір провайдера. - - Спільні параметри tool для музики і вибір provider. + + Спільні параметри інструмента музики і вибір провайдера.