openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh uk translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-27 06:53:12 +00:00
parent 16b5f65ce2
commit aa5bb981b2
1 changed files with 125 additions and 120 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

245
docs/uk/providers/google.md
View File

@ -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/*`.
## Початок роботи
Виберіть бажаний спосіб автентифікації й виконайте кроки налаштування.
Виберіть бажаний спосіб автентифікації та виконайте кроки налаштування.
<Tabs>
<Tab title="API-ключ">
**Найкраще для:** стандартного доступу до Gemini API через Google AI Studio.
<Tab title="API key">
**Найкраще підходить для:** стандартного доступу до Gemini API через Google AI Studio.
<Steps>
<Step title="Запустіть онбординг">
<Step title="Run onboarding">
```bash
openclaw onboard --auth-choice gemini-api-key
```
@ -46,7 +46,7 @@ Gemini Grounding.
--gemini-api-key "$GEMINI_API_KEY"
```
</Step>
<Step title="Установіть типову model">
<Step title="Set a default model">
```json5
{
agents: {
@ -57,7 +57,7 @@ Gemini Grounding.
}
```
</Step>
<Step title="Перевірте, що model доступна">
<Step title="Verify the model is available">
```bash
openclaw models list --provider google
```
@ -65,21 +65,21 @@ Gemini Grounding.
</Steps>
<Tip>
Змінні середовища `GEMINI_API_KEY` і `GOOGLE_API_KEY` обидві підтримуються. Використовуйте ту, яка у вас уже налаштована.
Змінні середовища `GEMINI_API_KEY` і `GOOGLE_API_KEY` обидві підтримуються. Використовуйте ту, яку у вас уже налаштовано.
</Tip>
</Tab>
<Tab title="Gemini CLI (OAuth)">
**Найкраще для:** повторного використання наявного входу Gemini CLI через PKCE OAuth замість окремого API-ключа.
**Найкраще підходить для:** повторного використання наявного входу Gemini CLI через PKCE OAuth замість окремого API-ключа.
<Warning>
Provider `google-gemini-cli` є неофіційною інтеграцією. Деякі користувачі
повідомляють про обмеження акаунтів при використанні OAuth у такий спосіб. Використовуйте на власний ризик.
Провайдер `google-gemini-cli` є неофіційною інтеграцією. Деякі користувачі
повідомляють про обмеження акаунта під час використання OAuth таким способом. Використовуйте на власний ризик.
</Warning>
<Steps>
<Step title="Установіть Gemini CLI">
<Step title="Install the Gemini CLI">
Локальна команда `gemini` має бути доступною в `PATH`.
```bash
@ -90,23 +90,23 @@ Gemini Grounding.
npm install -g @google/gemini-cli
```
OpenClaw підтримує як інсталяції через Homebrew, так і глобальні інсталяції npm, зокрема
OpenClaw підтримує як встановлення через Homebrew, так і глобальні встановлення npm, зокрема
типові схеми Windows/npm.
</Step>
<Step title="Увійдіть через OAuth">
<Step title="Log in via OAuth">
```bash
openclaw models auth login --provider google-gemini-cli --set-default
```
</Step>
<Step title="Перевірте, що model доступна">
<Step title="Verify the model is available">
```bash
openclaw models list --provider google
```
</Step>
</Steps>
- Типова 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_*`.)
<Note>
Якщо запити Gemini CLI OAuth після входу завершуються помилкою, установіть `GOOGLE_CLOUD_PROJECT` або
`GOOGLE_CLOUD_PROJECT_ID` на хості gateway і повторіть спробу.
Якщо запити OAuth Gemini CLI не вдаються після входу, установіть `GOOGLE_CLOUD_PROJECT` або
`GOOGLE_CLOUD_PROJECT_ID` на хості шлюзу й повторіть спробу.
</Note>
<Note>
Якщо вхід завершується помилкою ще до запуску потоку в браузері, переконайтеся, що локальну команду `gemini`
встановлено й вона є в `PATH`.
Якщо вхід завершується помилкою до запуску браузерного потоку, переконайтеся, що локальну команду `gemini`
встановлено й додано до `PATH`.
</Note>
Посилання на model `google-gemini-cli/*` — це застарілі сумісні псевдоніми. Нові
конфігурації мають використовувати посилання на model `google/*` плюс runtime `google-gemini-cli`,
Посилання на моделі `google-gemini-cli/*` — це застарілі псевдоніми сумісності. Нові
конфігурації мають використовувати посилання на моделі `google/*` разом із середовищем виконання `google-gemini-cli`,
якщо потрібне локальне виконання Gemini CLI.
</Tab>
@ -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 | Так |
<Tip>
Моделі 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`.
</Tip>
## Генерація зображень
Вбудований 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 надсилає
```
<Note>
Див. [Генерація зображень](/uk/tools/image-generation), щоб дізнатися про спільні параметри tools, вибір provider і поведінку failover.
Див. [Генерація зображень](/uk/tools/image-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою резервного перемикання.
</Note>
## Генерація відео
Вбудований 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`.
```
<Note>
Див. [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри tools, вибір provider і поведінку failover.
Див. [Генерація відео](/uk/tools/video-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою резервного перемикання.
</Note>
## Генерація музики
Вбудований 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`.
```
<Note>
Див. [Генерація музики](/uk/tools/music-generation), щоб дізнатися про спільні параметри tools, вибір provider і поведінку failover.
Див. [Генерація музики](/uk/tools/music-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою резервного перемикання.
</Note>
## 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]]
```
<Note>
API-ключ Google Cloud Console, обмежений Gemini API, є валідним для цього
provider. Це не окремий шлях Cloud Text-to-Speech API.
API-ключ Google Cloud Console, обмежений Gemini API, є дійсним для цього
провайдера. Це не окремий шлях Cloud Text-to-Speech API.
</Note>
## Голос у 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 для серверних аудіомостів, таких я
```
<Note>
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.
</Note>
<Note>
Сеанси browser Talk у Control UI все ще вимагають provider голосу в realtime з
реалізацією browser-сеансу WebRTC. Наразі цей шлях — OpenAI Realtime; provider
Google призначений для серверних мостів у realtime.
Сеанси браузера Talk у Control UI усе ще потребують провайдера голосу в реальному часі з
реалізацією браузерного сеансу WebRTC. Сьогодні цим шляхом є OpenAI Realtime; провайдер
Google призначений для серверних мостів реального часу.
</Note>
## Розширена конфігурація
<AccordionGroup>
<Accordion title="Пряме повторне використання кешу Gemini">
Для прямих запусків Gemini API (`api: "google-generative-ai"`) OpenClaw
передає налаштований дескриптор `cachedContent` безпосередньо в запити Gemini.
<Accordion title="Direct Gemini cache reuse">
Для прямих запусків 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
</Accordion>
<Accordion title="Примітки щодо використання JSON Gemini CLI">
Під час використання OAuth provider `google-gemini-cli` OpenClaw нормалізує
<Accordion title="Gemini CLI JSON usage notes">
Під час використання 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`.
</Accordion>
<Accordion title="Налаштування середовища та daemon">
Якщо Gateway працює як daemon (launchd/systemd), переконайтеся, що `GEMINI_API_KEY`
<Accordion title="Environment and daemon setup">
Якщо Gateway працює як демон (launchd/systemd), переконайтеся, що `GEMINI_API_KEY`
доступний цьому процесу (наприклад, у `~/.openclaw/.env` або через
`env.shellEnv`).
</Accordion>
@ -412,16 +417,16 @@ Google призначений для серверних мостів у realtime
## Пов’язане
<CardGroup cols={2}>
<Card title="Вибір model" href="/uk/concepts/model-providers" icon="layers">
Вибір provider, refs моделей і поведінка failover.
<Card title="Model selection" href="/uk/concepts/model-providers" icon="layers">
Вибір провайдерів, посилань на моделі та поведінки резервного перемикання.
</Card>
<Card title="Генерація зображень" href="/uk/tools/image-generation" icon="image">
Спільні параметри tool для зображень і вибір provider.
<Card title="Image generation" href="/uk/tools/image-generation" icon="image">
Спільні параметри інструмента зображень і вибір провайдера.
</Card>
<Card title="Генерація відео" href="/uk/tools/video-generation" icon="video">
Спільні параметри tool для відео і вибір provider.
<Card title="Video generation" href="/uk/tools/video-generation" icon="video">
Спільні параметри інструмента відео і вибір провайдера.
</Card>
<Card title="Генерація музики" href="/uk/tools/music-generation" icon="music">
Спільні параметри tool для музики і вибір provider.
<Card title="Music generation" href="/uk/tools/music-generation" icon="music">
Спільні параметри інструмента музики і вибір провайдера.
</Card>
</CardGroup>