diff --git a/docs/uk/providers/anthropic.md b/docs/uk/providers/anthropic.md index 2c19cbded..0a9b9ac75 100644 --- a/docs/uk/providers/anthropic.md +++ b/docs/uk/providers/anthropic.md @@ -4,42 +4,42 @@ read_when: summary: Використовуйте Anthropic Claude через API-ключі або Claude CLI в OpenClaw title: Anthropic x-i18n: - generated_at: "2026-04-12T09:50:38Z" + generated_at: "2026-04-12T11:08:30Z" model: gpt-5.4 provider: openai - source_hash: dabb5adc0d626995c3649c57cf4e1a94e48ce8908c004eecc21582af9c227f4d + source_hash: 5e3dda5f98ade9d4c3841888103bfb43d59e075d358a701ed0ae3ffb8d5694a7 source_path: providers/anthropic.md workflow: 15 --- # Anthropic (Claude) -Anthropic створює сімейство моделей **Claude**. OpenClaw підтримує два способи автентифікації: +Anthropic створює сімейство моделей **Claude**. OpenClaw підтримує два шляхи автентифікації: -- **API key** — прямий доступ до Anthropic API з оплатою за використання (моделі `anthropic/*`) +- **API key** — прямий доступ до API Anthropic з тарифікацією за використання (`anthropic/*` моделі) - **Claude CLI** — повторне використання наявного входу Claude CLI на тому самому хості -Співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому +Співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тож OpenClaw вважає повторне використання Claude CLI та використання `claude -p` санкціонованими, якщо Anthropic не опублікує нову політику. -Для довготривалих хостів Gateway ключі Anthropic API key все ще є найзрозумілішим і -найпередбачуванішим шляхом для продакшну. +Для довготривалих хостів Gateway API-ключі Anthropic усе ще є найзрозумілішим і +найпередбачуванішим шляхом для production. Поточна публічна документація Anthropic: - [Довідка з Claude Code CLI](https://code.claude.com/docs/en/cli-reference) - [Огляд Claude Agent SDK](https://platform.claude.com/docs/en/agent-sdk/overview) -- [Використання Claude Code з планом Pro або Max](https://support.claude.com/en/articles/11145838-using-claude-code-with-your-pro-or-max-plan) -- [Використання Claude Code з планом Team або Enterprise](https://support.anthropic.com/en/articles/11845131-using-claude-code-with-your-team-or-enterprise-plan/) +- [Використання Claude Code з вашим планом Pro або Max](https://support.claude.com/en/articles/11145838-using-claude-code-with-your-pro-or-max-plan) +- [Використання Claude Code з вашим планом Team або Enterprise](https://support.anthropic.com/en/articles/11845131-using-claude-code-with-your-team-or-enterprise-plan/) ## Початок роботи - **Найкраще для:** стандартного доступу до API та оплати за використання. + **Найкраще підходить для:** стандартного доступу до API і тарифікації за використання. @@ -76,10 +76,10 @@ Anthropic не опублікує нову політику. - **Найкраще для:** повторного використання наявного входу Claude CLI без окремого API key. + **Найкраще підходить для:** повторного використання наявного входу Claude CLI без окремого API key. - + Перевірте командою: ```bash @@ -106,17 +106,17 @@ Anthropic не опублікує нову політику. - Якщо вам потрібен найзрозуміліший шлях білінгу, використовуйте Anthropic API key. OpenClaw також підтримує варіанти у стилі підписки від [OpenAI Codex](/uk/providers/openai), [Qwen Cloud](/uk/providers/qwen), [MiniMax](/uk/providers/minimax) і [Z.AI / GLM](/uk/providers/glm). + Якщо вам потрібен найпрозоріший шлях тарифікації, натомість використовуйте API key Anthropic. OpenClaw також підтримує варіанти на основі підписки від [OpenAI Codex](/uk/providers/openai), [Qwen Cloud](/uk/providers/qwen), [MiniMax](/uk/providers/minimax) і [Z.AI / GLM](/uk/providers/glm). -## Типові налаштування thinking (Claude 4.6) +## Значення thinking за замовчуванням (Claude 4.6) -Моделі Claude 4.6 типово використовують `adaptive` thinking в OpenClaw, якщо явний рівень thinking не задано. +Для моделей Claude 4.6 в OpenClaw значення thinking за замовчуванням — `adaptive`, якщо явний рівень thinking не встановлено. -Перевизначайте для окремого повідомлення через `/think:` або в параметрах моделі: +Перевизначте для окремого повідомлення через `/think:` або в параметрах моделі: ```json5 { @@ -138,15 +138,15 @@ Anthropic не опублікує нову політику. - [Extended thinking](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) -## Кешування промптів +## Кешування prompt -OpenClaw підтримує функцію кешування промптів Anthropic для автентифікації через API key. +OpenClaw підтримує функцію кешування prompt від Anthropic для автентифікації через API key. -| Value | Тривалість кешу | Опис | -| ------------------- | --------------- | -------------------------------------- | +| Значення | Тривалість кешу | Опис | +| ------------------- | --------------- | ---------------------------------------- | | `"short"` (типово) | 5 хвилин | Застосовується автоматично для автентифікації через API key | -| `"long"` | 1 година | Розширений кеш | -| `"none"` | Без кешування | Вимкнути кешування промптів | +| `"long"` | 1 година | Розширений кеш | +| `"none"` | Без кешування | Вимкнути кешування prompt | ```json5 { @@ -164,7 +164,7 @@ OpenClaw підтримує функцію кешування промптів A - Використовуйте параметри на рівні моделі як базову лінію, а потім перевизначайте для конкретних агентів через `agents.list[].params`: + Використовуйте параметри на рівні моделі як базу, а потім перевизначайте для конкретних агентів через `agents.list[].params`: ```json5 { @@ -188,27 +188,27 @@ OpenClaw підтримує функцію кешування промптів A Порядок об’єднання конфігурації: 1. `agents.defaults.models["provider/model"].params` - 2. `agents.list[].params` (відповідний `id`, перевизначення за ключем) + 2. `agents.list[].params` (відповідний `id`, перевизначає за ключем) - Це дозволяє одному агенту зберігати довготривалий кеш, тоді як інший агент на тій самій моделі вимикає кешування для імпульсного трафіку або трафіку з низьким повторним використанням. + Це дає змогу одному агенту зберігати довготривалий кеш, тоді як інший агент на тій самій моделі вимикає кешування для імпульсного трафіку або трафіку з низьким повторним використанням. - - - Моделі Anthropic Claude на Bedrock (`amazon-bedrock/*anthropic.claude*`) приймають наскрізну передачу `cacheRetention`, якщо це налаштовано. + + - Моделі Anthropic Claude у Bedrock (`amazon-bedrock/*anthropic.claude*`) приймають наскрізну передачу `cacheRetention`, якщо її налаштовано. - Для моделей Bedrock, що не належать Anthropic, під час виконання примусово встановлюється `cacheRetention: "none"`. - - Типові розумні налаштування для API key також задають `cacheRetention: "short"` для посилань Claude-on-Bedrock, якщо явне значення не встановлено. + - Розумні типові значення для API key також ініціалізують `cacheRetention: "short"` для посилань Claude-on-Bedrock, якщо явне значення не задано. -## Розширене налаштування +## Розширена конфігурація - Спільний перемикач `/fast` в OpenClaw підтримує прямий трафік Anthropic (API key та OAuth до `api.anthropic.com`). + Спільний перемикач `/fast` в OpenClaw підтримує прямий трафік Anthropic (API key і OAuth до `api.anthropic.com`). - | Command | Відповідає | - |---------|------------| + | Команда | Відображається на | + |---------|-------------------| | `/fast on` | `service_tier: "auto"` | | `/fast off` | `service_tier: "standard_only"` | @@ -227,15 +227,30 @@ OpenClaw підтримує функцію кешування промптів A ``` - - Вставляється лише для прямих запитів до `api.anthropic.com`. Для маршрутів через проксі `service_tier` залишається без змін. - - Явні параметри `serviceTier` або `service_tier` мають пріоритет над `/fast`, якщо задано обидва. - - Для акаунтів без доступної ємності Priority Tier значення `service_tier: "auto"` може звестися до `standard`. + - Вставляється лише для прямих запитів до `api.anthropic.com`. Маршрути через проксі залишають `service_tier` без змін. + - Явні параметри `serviceTier` або `service_tier` мають пріоритет над `/fast`, якщо встановлено обидва. + - Для облікових записів без місткості Priority Tier значення `service_tier: "auto"` може визначитися як `standard`. + + Вбудований Plugin Anthropic реєструє розуміння зображень і PDF. OpenClaw + автоматично визначає медіа-можливості з налаштованої автентифікації Anthropic — + додаткова конфігурація не потрібна. + + | Property | Value | + | -------------- | -------------------- | + | Default model | `claude-opus-4-6` | + | Supported input | Images, PDF documents | + + Коли зображення або PDF додається до розмови, OpenClaw автоматично + маршрутизує його через провайдера розуміння медіа Anthropic. + + + - Вікно контексту Anthropic 1M доступне лише в бета-режимі. Увімкніть його для конкретної моделі: + Вікно контексту 1M від Anthropic доступне лише в межах beta. Увімкніть його для окремої моделі: ```json5 { @@ -251,10 +266,10 @@ OpenClaw підтримує функцію кешування промптів A } ``` - OpenClaw відображає це у `anthropic-beta: context-1m-2025-08-07` у запитах. + OpenClaw відображає це в `anthropic-beta: context-1m-2025-08-07` у запитах. - Потрібен доступ до довгого контексту для ваших облікових даних Anthropic. Застаріла автентифікація токеном (`sk-ant-oat-*`) відхиляється для запитів із контекстом 1M — OpenClaw записує попередження в лог і повертається до стандартного вікна контексту. + Потрібен доступ до довгого контексту для ваших облікових даних Anthropic. Застаріла автентифікація токеном (`sk-ant-oat-*`) відхиляється для запитів із контекстом 1M — OpenClaw записує попередження в журнал і повертається до стандартного вікна контексту. @@ -264,24 +279,24 @@ OpenClaw підтримує функцію кешування промптів A - Токен-автентифікація Anthropic може завершити дію або бути відкликаною. Для нових налаштувань перейдіть на Anthropic API key. + Автентифікація токеном Anthropic може завершитися або бути відкликана. Для нових налаштувань перейдіть на API key Anthropic. - - Автентифікація є **окремою для кожного агента**. Нові агенти не успадковують ключі головного агента. Повторно запустіть онбординг для цього агента або налаштуйте API key на хості Gateway, а потім перевірте командою `openclaw models status`. + + Автентифікація є **для кожного агента окремо**. Нові агенти не успадковують ключі головного агента. Повторно запустіть онбординг для цього агента або налаштуйте API key на хості Gateway, а потім перевірте через `openclaw models status`. - - Виконайте `openclaw models status`, щоб побачити, який профіль автентифікації активний. Повторно запустіть онбординг або налаштуйте API key для шляху цього профілю. + + Запустіть `openclaw models status`, щоб побачити, який профіль автентифікації активний. Повторно запустіть онбординг або налаштуйте API key для шляху цього профілю. - Перевірте `openclaw models status --json` для `auth.unusableProfiles`. Обмеження Anthropic за частотою запитів можуть бути прив’язані до конкретної моделі, тому сусідня модель Anthropic усе ще може бути придатною для використання. Додайте ще один профіль Anthropic або дочекайтеся завершення cooldown. + Перевірте `openclaw models status --json` для `auth.unusableProfiles`. Cooldown через обмеження швидкості Anthropic може бути прив’язаний до моделі, тому споріднена модель Anthropic все ще може бути придатною до використання. Додайте інший профіль Anthropic або дочекайтеся завершення cooldown. -Більше допомоги: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). +Більше довідки: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). ## Пов’язане @@ -293,10 +308,10 @@ OpenClaw підтримує функцію кешування промптів A Налаштування бекенда Claude CLI та подробиці виконання. - - Як працює кешування промптів у різних провайдерів. + + Як працює кешування prompt у різних провайдерів. - + Подробиці автентифікації та правила повторного використання облікових даних. diff --git a/docs/uk/providers/github-copilot.md b/docs/uk/providers/github-copilot.md index 78d498fe5..5c6d8110a 100644 --- a/docs/uk/providers/github-copilot.md +++ b/docs/uk/providers/github-copilot.md @@ -1,31 +1,27 @@ --- read_when: - - Ви хочете використовувати GitHub Copilot як постачальника моделі - - Вам потрібен потік `openclaw models auth login-github-copilot` + - Ви хочете використовувати GitHub Copilot як постачальника моделей + - Вам потрібен процес `openclaw models auth login-github-copilot` summary: Увійдіть у GitHub Copilot з OpenClaw за допомогою device flow title: GitHub Copilot x-i18n: - generated_at: "2026-04-12T10:30:03Z" + generated_at: "2026-04-12T11:08:29Z" model: gpt-5.4 provider: openai - source_hash: 147a3c2d37919a36e54fb2739a54500be7ebd34eeed0efe3bde448da7376d541 + source_hash: 51fee006e7d4e78e37b0c29356b0090b132de727d99b603441767d3fb642140b source_path: providers/github-copilot.md workflow: 15 --- # GitHub Copilot -GitHub Copilot — це AI-асистент GitHub для програмування. Він надає доступ до моделей -Copilot для вашого облікового запису GitHub і тарифного плану. OpenClaw може використовувати Copilot як -постачальника моделі двома різними способами. +GitHub Copilot — це помічник для програмування на базі ШІ від GitHub. Він надає доступ до моделей Copilot для вашого облікового запису та плану GitHub. OpenClaw може використовувати Copilot як постачальника моделей двома різними способами. ## Два способи використання Copilot в OpenClaw - Використовуйте нативний потік входу через device-login, щоб отримати токен GitHub, а потім обмінювати його на - API-токени Copilot під час роботи OpenClaw. Це **типовий** і найпростіший шлях, - оскільки він не потребує VS Code. + Використовуйте нативний процес входу через device flow, щоб отримати токен GitHub, а потім обмінювати його на API-токени Copilot під час роботи OpenClaw. Це **типовий** і найпростіший шлях, оскільки він не потребує VS Code. @@ -33,10 +29,10 @@ Copilot для вашого облікового запису GitHub і тари openclaw models auth login-github-copilot ``` - Вам буде запропоновано перейти за URL-адресою та ввести одноразовий код. Не закривайте - термінал, доки процес не завершиться. + Вам буде запропоновано перейти за URL-адресою та ввести одноразовий код. Тримайте + термінал відкритим, доки процес не завершиться. - + ```bash openclaw models set github-copilot/gpt-4o ``` @@ -55,11 +51,11 @@ Copilot для вашого облікового запису GitHub і тари Використовуйте розширення VS Code **Copilot Proxy** як локальний міст. OpenClaw звертається до - кінцевої точки `/v1` проксі й використовує список моделей, який ви там налаштуєте. + кінцевої точки `/v1` проксі та використовує список моделей, який ви там налаштуєте. - Обирайте цей варіант, якщо ви вже використовуєте Copilot Proxy у VS Code або вам потрібно маршрутизувати - через нього. Ви повинні ввімкнути Plugin і тримати розширення VS Code запущеним. + Виберіть це, якщо ви вже запускаєте Copilot Proxy у VS Code або вам потрібно маршрутизувати + через нього. Ви повинні ввімкнути Plugin і підтримувати роботу розширення VS Code. @@ -67,38 +63,55 @@ Copilot для вашого облікового запису GitHub і тари ## Необов’язкові прапорці -| Flag | Опис | -| --------------- | --------------------------------------------------- | -| `--yes` | Пропустити запит підтвердження | -| `--set-default` | Також застосувати рекомендовану модель постачальника за замовчуванням | +| Flag | Опис | +| --------------- | ------------------------------------------------------ | +| `--yes` | Пропустити запит на підтвердження | +| `--set-default` | Також застосувати рекомендовану типову модель постачальника | ```bash # Пропустити підтвердження openclaw models auth login-github-copilot --yes -# Увійти й одразу встановити модель за замовчуванням +# Увійти та встановити типову модель за один крок openclaw models auth login --provider github-copilot --method device --set-default ``` - Потік входу через device-login потребує інтерактивного TTY. Запускайте його безпосередньо в - терміналі, а не в неінтерактивному скрипті чи CI-конвеєрі. + Для процесу входу через device flow потрібен інтерактивний TTY. Запускайте його безпосередньо в + терміналі, а не в неінтерактивному скрипті чи конвеєрі CI. - - Доступність моделей Copilot залежить від вашого тарифного плану GitHub. Якщо модель - відхиляється, спробуйте інший ідентифікатор (наприклад, `github-copilot/gpt-4.1`). + + Доступність моделей Copilot залежить від вашого плану GitHub. Якщо модель + відхиляється, спробуйте інший ID (наприклад, `github-copilot/gpt-4.1`). - Ідентифікатори моделей Claude автоматично використовують транспорт Anthropic Messages. Моделі GPT, - o-series і Gemini використовують транспорт OpenAI Responses. OpenClaw + Ідентифікатори моделей Claude автоматично використовують транспорт Anthropic Messages. GPT, + моделі серії o та Gemini зберігають транспорт OpenAI Responses. OpenClaw вибирає правильний транспорт на основі посилання на модель. + + OpenClaw визначає автентифікацію Copilot зі змінних середовища в такому + порядку пріоритету: + + | Priority | Variable | Notes | + | -------- | --------------------- | ---------------------------------- | + | 1 | `COPILOT_GITHUB_TOKEN` | Найвищий пріоритет, специфічний для Copilot | + | 2 | `GH_TOKEN` | Токен GitHub CLI (резервний варіант) | + | 3 | `GITHUB_TOKEN` | Стандартний токен GitHub (найнижчий пріоритет) | + + Коли задано кілька змінних, OpenClaw використовує змінну з найвищим пріоритетом. + Процес входу через device flow (`openclaw models auth login-github-copilot`) зберігає + свій токен у сховищі профілів автентифікації та має пріоритет над усіма змінними + середовища. + + + - Під час входу токен GitHub зберігається в сховищі профілів автентифікації та обмінюється + Під час входу токен GitHub зберігається у сховищі профілів автентифікації та обмінюється на API-токен Copilot під час роботи OpenClaw. Вам не потрібно керувати токеном вручну. @@ -113,7 +126,7 @@ openclaw models auth login --provider github-copilot --method device --set-defau - Вибір постачальників, посилань на моделі та поведінки резервного перемикання. + Вибір постачальників, посилань на моделі та поведінки перемикання на резервний варіант. Докладно про автентифікацію та правила повторного використання облікових даних. diff --git a/docs/uk/providers/ollama.md b/docs/uk/providers/ollama.md index 558ee3d20..a1d9bb2b2 100644 --- a/docs/uk/providers/ollama.md +++ b/docs/uk/providers/ollama.md @@ -5,20 +5,20 @@ read_when: summary: Запустіть OpenClaw з Ollama (хмарні та локальні моделі) title: Ollama x-i18n: - generated_at: "2026-04-12T10:03:22Z" + generated_at: "2026-04-12T11:08:31Z" model: gpt-5.4 provider: openai - source_hash: 48c956d7b933d2ac637784eff1f0613b15a2b3eb5da7c030133427a73b064117 + source_hash: ec796241b884ca16ec7077df4f3f1910e2850487bb3ea94f8fdb37c77e02b219 source_path: providers/ollama.md workflow: 15 --- # Ollama -Ollama — це локальне середовище виконання LLM, яке спрощує запуск моделей із відкритим кодом на вашому комп’ютері. OpenClaw інтегрується з рідним API Ollama (`/api/chat`), підтримує потокову передачу та виклик інструментів, а також може автоматично виявляти локальні моделі Ollama, коли ви вмикаєте це за допомогою `OLLAMA_API_KEY` (або профілю автентифікації) і не визначаєте явний запис `models.providers.ollama`. +Ollama — це локальне середовище виконання LLM, яке спрощує запуск моделей з відкритим кодом на вашій машині. OpenClaw інтегрується з нативним API Ollama (`/api/chat`), підтримує потокову передачу та виклик інструментів, а також може автоматично виявляти локальні моделі Ollama, якщо ви ввімкнете це через `OLLAMA_API_KEY` (або профіль автентифікації) і не визначите явний запис `models.providers.ollama`. -**Користувачі віддаленого Ollama**: Не використовуйте OpenAI-сумісну URL-адресу `/v1` (`http://host:11434/v1`) з OpenClaw. Це ламає виклик інструментів, і моделі можуть виводити необроблений JSON інструментів як звичайний текст. Натомість використовуйте рідну URL-адресу API Ollama: `baseUrl: "http://host:11434"` (без `/v1`). +**Користувачі віддаленого Ollama**: Не використовуйте OpenAI-сумісну URL-адресу `/v1` (`http://host:11434/v1`) з OpenClaw. Це ламає виклик інструментів, і моделі можуть виводити сирий JSON інструментів як звичайний текст. Натомість використовуйте нативну URL-адресу API Ollama: `baseUrl: "http://host:11434"` (без `/v1`). ## Початок роботи @@ -26,27 +26,27 @@ Ollama — це локальне середовище виконання LLM, я Виберіть бажаний спосіб налаштування та режим. - - **Найкраще для:** найшвидшого способу отримати працездатне налаштування Ollama з автоматичним виявленням моделей. + + **Найкраще для:** найшвидшого шляху до робочого налаштування Ollama з автоматичним виявленням моделей. - + ```bash openclaw onboard ``` - Виберіть **Ollama** зі списку постачальників. + Виберіть **Ollama** зі списку провайдерів. - - - **Cloud + Local** — хмарні та локальні моделі разом + + - **Cloud + Local** — хмарні моделі та локальні моделі разом - **Local** — лише локальні моделі - Якщо ви виберете **Cloud + Local** і не ввійшли в ollama.com, під час онбордингу відкриється потік входу через браузер. + Якщо ви виберете **Cloud + Local** і не ввійшли на ollama.com, онбординг відкриє у браузері процес входу. - - Під час онбордингу виявляються доступні моделі та пропонуються типові значення. Якщо вибрана модель недоступна локально, її буде автоматично завантажено. + + Онбординг виявляє доступні моделі та пропонує типові варіанти. Він автоматично завантажує вибрану модель, якщо вона недоступна локально. - + ```bash openclaw models list --provider ollama ``` @@ -73,14 +73,14 @@ Ollama — це локальне середовище виконання LLM, я - - **Найкраще для:** повного контролю над встановленням, завантаженням моделей і конфігурацією. + + **Найкраще для:** повного контролю над інсталяцією, завантаженням моделей і конфігурацією. - + Завантажте з [ollama.com/download](https://ollama.com/download). - + ```bash ollama pull gemma4 # або @@ -89,31 +89,31 @@ Ollama — це локальне середовище виконання LLM, я ollama pull llama3.3 ``` - - Якщо вам також потрібні хмарні моделі: + + Якщо ви також хочете хмарні моделі: ```bash ollama signin ``` - - Установіть будь-яке значення для ключа API (Ollama не вимагає справжнього ключа): + + Встановіть будь-яке значення для API key (Ollama не потребує справжнього ключа): ```bash - # Установіть змінну середовища + # Встановити змінну середовища export OLLAMA_API_KEY="ollama-local" - # Або налаштуйте у своєму файлі конфігурації + # Або налаштувати у вашому файлі конфігурації openclaw config set models.providers.ollama.apiKey "ollama-local" ``` - + ```bash openclaw models list openclaw models set ollama/gemma4 ``` - Або встановіть типове значення в конфігурації: + Або встановіть типову модель у конфігурації: ```json5 { @@ -134,41 +134,41 @@ Ollama — це локальне середовище виконання LLM, я - Хмарні моделі дають змогу запускати хмарні моделі разом із локальними моделями. Приклади: `kimi-k2.5:cloud`, `minimax-m2.7:cloud` і `glm-5.1:cloud` -- для них **не** потрібен локальний `ollama pull`. + Хмарні моделі дають змогу запускати моделі, розміщені в хмарі, поряд із вашими локальними моделями. Приклади: `kimi-k2.5:cloud`, `minimax-m2.7:cloud` і `glm-5.1:cloud` -- для них **не** потрібен локальний `ollama pull`. - Під час налаштування виберіть режим **Cloud + Local**. Майстер перевіряє, чи ви ввійшли в систему, і за потреби відкриває потік входу через браузер. Якщо не вдається перевірити автентифікацію, майстер повертається до типових значень локальних моделей. + Під час налаштування виберіть режим **Cloud + Local**. Майстер перевіряє, чи ви ввійшли в систему, і за потреби відкриває у браузері процес входу. Якщо автентифікацію неможливо перевірити, майстер повертається до типових локальних моделей. - Ви також можете ввійти безпосередньо на [ollama.com/signin](https://ollama.com/signin). + Ви також можете увійти безпосередньо на [ollama.com/signin](https://ollama.com/signin). - Зараз OpenClaw пропонує такі хмарні типові значення: `kimi-k2.5:cloud`, `minimax-m2.7:cloud`, `glm-5.1:cloud`. + OpenClaw наразі пропонує такі типові хмарні варіанти: `kimi-k2.5:cloud`, `minimax-m2.7:cloud`, `glm-5.1:cloud`. - + У режимі лише локальних моделей OpenClaw виявляє моделі з локального екземпляра Ollama. Вхід у хмару не потрібен. - Зараз OpenClaw пропонує `gemma4` як локальне типове значення. + OpenClaw наразі пропонує `gemma4` як типову локальну модель. -## Виявлення моделей (неявний постачальник) +## Виявлення моделей (неявний провайдер) Коли ви встановлюєте `OLLAMA_API_KEY` (або профіль автентифікації) і **не** визначаєте `models.providers.ollama`, OpenClaw виявляє моделі з локального екземпляра Ollama за адресою `http://127.0.0.1:11434`. -| Поведінка | Докладно | +| Поведінка | Деталі | | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Запит каталогу | Виконує запити до `/api/tags` | -| Визначення можливостей | Використовує найкращі зусилля з пошуком через `/api/show`, щоб зчитати `contextWindow` і визначити можливості (зокрема підтримку зображень) | -| Моделі з підтримкою зображень | Моделі з можливістю `vision`, про яку повідомляє `/api/show`, позначаються як такі, що підтримують зображення (`input: ["text", "image"]`), тому OpenClaw автоматично додає зображення в запит | -| Визначення міркування | Позначає `reasoning` за допомогою евристики на основі назви моделі (`r1`, `reasoning`, `think`) | -| Ліміти токенів | Установлює `maxTokens` на типове максимальне обмеження токенів Ollama, яке використовує OpenClaw | -| Вартість | Установлює всю вартість у `0` | +| Виявлення можливостей | Використовує найкращі доступні запити `/api/show`, щоб зчитати `contextWindow` і виявити можливості (зокрема vision) | +| Vision-моделі | Моделі з можливістю `vision`, про яку повідомляє `/api/show`, позначаються як такі, що підтримують зображення (`input: ["text", "image"]`), тому OpenClaw автоматично додає зображення до запиту | +| Виявлення reasoning | Позначає `reasoning` за евристикою назви моделі (`r1`, `reasoning`, `think`) | +| Обмеження токенів | Встановлює `maxTokens` на типове максимальне обмеження токенів Ollama, яке використовує OpenClaw | +| Вартість | Встановлює всі вартості в `0` | Це дає змогу уникнути ручного додавання моделей і водночас зберігати каталог узгодженим із локальним екземпляром Ollama. ```bash -# Подивитися, які моделі доступні +# Переглянути, які моделі доступні ollama list openclaw models list ``` @@ -179,16 +179,16 @@ openclaw models list ollama pull mistral ``` -Нова модель буде автоматично виявлена і стане доступною для використання. +Нова модель буде автоматично виявлена та стане доступною для використання. -Якщо ви явно задаєте `models.providers.ollama`, автоматичне виявлення пропускається, і вам доведеться визначати моделі вручну. Дивіться розділ явної конфігурації нижче. +Якщо ви явно задаєте `models.providers.ollama`, автоматичне виявлення пропускається, і вам потрібно визначити моделі вручну. Дивіться розділ про явну конфігурацію нижче. ## Конфігурація - + Найпростіший спосіб увімкнути Ollama — через змінну середовища: ```bash @@ -196,13 +196,13 @@ ollama pull mistral ``` - Якщо `OLLAMA_API_KEY` задано, ви можете не вказувати `apiKey` у записі постачальника, і OpenClaw підставить його для перевірок доступності. + Якщо встановлено `OLLAMA_API_KEY`, ви можете не вказувати `apiKey` у записі провайдера, і OpenClaw підставить його для перевірок доступності. - - Використовуйте явну конфігурацію, якщо Ollama працює на іншому хості або порту, ви хочете примусово вказати певні контекстні вікна чи списки моделей, або вам потрібні повністю ручні визначення моделей. + + Використовуйте явну конфігурацію, коли Ollama працює на іншому хості/порту, ви хочете примусово задати певні розміри контекстного вікна або списки моделей, або вам потрібні повністю ручні визначення моделей. ```json5 { @@ -231,8 +231,8 @@ ollama pull mistral - - Якщо Ollama працює на іншому хості або порту (явна конфігурація вимикає автоматичне виявлення, тому визначайте моделі вручну): + + Якщо Ollama працює на іншому хості або порту (явна конфігурація вимикає автоматичне виявлення, тому визначте моделі вручну): ```json5 { @@ -240,8 +240,8 @@ ollama pull mistral providers: { ollama: { apiKey: "ollama-local", - baseUrl: "http://ollama-host:11434", // Без /v1 - використовуйте рідну URL-адресу API Ollama - api: "ollama", // Укажіть явно, щоб гарантувати рідну поведінку виклику інструментів + baseUrl: "http://ollama-host:11434", // Без /v1 — використовуйте нативну URL-адресу API Ollama + api: "ollama", // Вкажіть явно, щоб гарантувати нативну поведінку виклику інструментів }, }, }, @@ -249,7 +249,7 @@ ollama pull mistral ``` - Не додавайте `/v1` до URL-адреси. Шлях `/v1` використовує OpenAI-сумісний режим, у якому виклик інструментів працює ненадійно. Використовуйте базову URL-адресу Ollama без суфікса шляху. + Не додавайте `/v1` до URL-адреси. Шлях `/v1` використовує OpenAI-сумісний режим, у якому виклик інструментів ненадійний. Використовуйте базову URL-адресу Ollama без суфікса шляху. @@ -272,15 +272,15 @@ ollama pull mistral } ``` -## Вебпошук Ollama +## Ollama Web Search -OpenClaw підтримує **Ollama Web Search** як вбудований постачальник `web_search`. +OpenClaw підтримує **Ollama Web Search** як вбудований провайдер `web_search`. -| Властивість | Докладно | -| ----------- | ------------------------------------------------------------------------------------------------------------------ | +| Властивість | Деталі | +| ----------- | -------------------------------------------------------------------------------------------------------------------- | | Хост | Використовує налаштований хост Ollama (`models.providers.ollama.baseUrl`, якщо задано, інакше `http://127.0.0.1:11434`) | -| Автентифікація | Без ключа | -| Вимога | Ollama має працювати, і ви повинні бути авторизовані через `ollama signin` | +| Автентифікація | Без ключа | +| Вимога | Ollama має бути запущений, і потрібно виконати вхід через `ollama signin` | Виберіть **Ollama Web Search** під час `openclaw onboard` або `openclaw configure --section web`, або задайте: @@ -297,18 +297,18 @@ OpenClaw підтримує **Ollama Web Search** як вбудований по ``` -Повні відомості про налаштування та поведінку дивіться в [Ollama Web Search](/uk/tools/ollama-search). +Повний опис налаштування та деталей поведінки дивіться в [Ollama Web Search](/uk/tools/ollama-search). ## Розширена конфігурація - + - **Виклик інструментів в OpenAI-сумісному режимі працює ненадійно.** Використовуйте цей режим лише тоді, коли вам потрібен формат OpenAI для проксі й ви не залежите від рідної поведінки виклику інструментів. + **Виклик інструментів ненадійний в OpenAI-сумісному режимі.** Використовуйте цей режим лише тоді, коли вам потрібен формат OpenAI для проксі й ви не залежите від нативної поведінки виклику інструментів. - Якщо вам потрібно використовувати натомість OpenAI-сумісну кінцеву точку (наприклад, за проксі, який підтримує лише формат OpenAI), явно встановіть `api: "openai-completions"`: + Якщо вам все ж потрібно використовувати OpenAI-сумісну кінцеву точку (наприклад, за проксі, який підтримує лише формат OpenAI), явно задайте `api: "openai-completions"`: ```json5 { @@ -317,7 +317,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований по ollama: { baseUrl: "http://ollama-host:11434/v1", api: "openai-completions", - injectNumCtxForOpenAICompat: true, // типово: true + injectNumCtxForOpenAICompat: true, // default: true apiKey: "ollama-local", models: [...] } @@ -326,9 +326,9 @@ OpenClaw підтримує **Ollama Web Search** як вбудований по } ``` - Цей режим може не підтримувати одночасно потокову передачу й виклик інструментів. Можливо, вам доведеться вимкнути потокову передачу за допомогою `params: { streaming: false }` у конфігурації моделі. + У цьому режимі потокова передача та виклик інструментів можуть не підтримуватися одночасно. Можливо, вам доведеться вимкнути потокову передачу через `params: { streaming: false }` у конфігурації моделі. - Коли `api: "openai-completions"` використовується з Ollama, OpenClaw типово додає `options.num_ctx`, щоб Ollama непомітно не повертався до контекстного вікна 4096. Якщо ваш проксі або upstream відхиляє невідомі поля `options`, вимкніть цю поведінку: + Коли `api: "openai-completions"` використовується з Ollama, OpenClaw типово додає `options.num_ctx`, щоб Ollama не переходив мовчки до контекстного вікна 4096. Якщо ваш проксі/апстрим відхиляє невідомі поля `options`, вимкніть цю поведінку: ```json5 { @@ -348,10 +348,10 @@ OpenClaw підтримує **Ollama Web Search** як вбудований по - - Для автоматично виявлених моделей OpenClaw використовує контекстне вікно, про яке повідомляє Ollama, якщо воно доступне; інакше використовується типове контекстне вікно Ollama, яке застосовує OpenClaw. + + Для автоматично виявлених моделей OpenClaw використовує розмір контекстного вікна, який повідомляє Ollama, а якщо він недоступний — повертається до типового контекстного вікна Ollama, яке використовує OpenClaw. - Ви можете перевизначити `contextWindow` і `maxTokens` в явній конфігурації постачальника: + Ви можете перевизначити `contextWindow` і `maxTokens` у явній конфігурації провайдера: ```json5 { @@ -373,8 +373,8 @@ OpenClaw підтримує **Ollama Web Search** як вбудований по - - OpenClaw типово вважає моделі з назвами на кшталт `deepseek-r1`, `reasoning` або `think` такими, що підтримують міркування. + + OpenClaw типово вважає моделі з назвами на кшталт `deepseek-r1`, `reasoning` або `think` такими, що підтримують reasoning. ```bash ollama pull deepseek-r1:32b @@ -385,14 +385,38 @@ OpenClaw підтримує **Ollama Web Search** як вбудований по - Ollama є безкоштовним і працює локально, тому для всіх моделей установлено вартість $0. Це стосується як автоматично виявлених, так і вручну визначених моделей. + Ollama є безкоштовним і працює локально, тому вартість усіх моделей встановлена в $0. Це стосується як автоматично виявлених, так і вручну визначених моделей. + + + + Вбудований Plugin Ollama реєструє провайдер ембедінгів пам’яті для + [пошуку в пам’яті](/uk/concepts/memory). Він використовує налаштовану базову URL-адресу Ollama + та API key. + + | Властивість | Значення | + | --------------- | ------------------- | + | Типова модель | `nomic-embed-text` | + | Автозавантаження | Так — модель ембедінгів завантажується автоматично, якщо її немає локально | + + Щоб вибрати Ollama як провайдера ембедінгів для пошуку в пам’яті: + + ```json5 + { + agents: { + defaults: { + memorySearch: { provider: "ollama" }, + }, + }, + } + ``` + - Інтеграція Ollama в OpenClaw типово використовує **рідний API Ollama** (`/api/chat`), який повністю підтримує одночасно потокову передачу та виклик інструментів. Жодної спеціальної конфігурації не потрібно. + Інтеграція Ollama в OpenClaw типово використовує **нативний API Ollama** (`/api/chat`), який повністю підтримує одночасно потокову передачу та виклик інструментів. Жодна спеціальна конфігурація не потрібна. - Якщо вам потрібно використовувати OpenAI-сумісну кінцеву точку, дивіться розділ "Legacy OpenAI-compatible mode" вище. У цьому режимі потокова передача та виклик інструментів можуть не працювати одночасно. + Якщо вам потрібно використовувати OpenAI-сумісну кінцеву точку, дивіться розділ "Застарілий OpenAI-сумісний режим" вище. У цьому режимі потокова передача та виклик інструментів можуть не працювати одночасно. @@ -402,7 +426,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований по - Переконайтеся, що Ollama запущено, що ви встановили `OLLAMA_API_KEY` (або профіль автентифікації) і що ви **не** визначили явний запис `models.providers.ollama`: + Переконайтеся, що Ollama запущено, що ви встановили `OLLAMA_API_KEY` (або профіль автентифікації), і що ви **не** визначили явний запис `models.providers.ollama`: ```bash ollama serve @@ -417,10 +441,10 @@ OpenClaw підтримує **Ollama Web Search** як вбудований по - Якщо вашу модель не вказано у списку, або завантажте її локально, або визначте її явно в `models.providers.ollama`. + Якщо ваша модель не відображається у списку, або завантажте її локально, або визначте її явно в `models.providers.ollama`. ```bash - ollama list # Подивитися, що встановлено + ollama list # Переглянути, що встановлено ollama pull gemma4 ollama pull gpt-oss:20b ollama pull llama3.3 # Або іншу модель @@ -429,7 +453,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований по - Переконайтеся, що Ollama працює на правильному порту: + Перевірте, що Ollama працює на правильному порту: ```bash # Перевірити, чи запущено Ollama @@ -443,20 +467,20 @@ OpenClaw підтримує **Ollama Web Search** як вбудований по -Більше довідки: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). +Більше допомоги: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). ## Пов’язане - - Огляд усіх постачальників, посилань на моделі та поведінки перемикання при відмові. + + Огляд усіх провайдерів, посилань на моделі та поведінки failover. Як вибирати та налаштовувати моделі. - Повні відомості про налаштування та поведінку вебпошуку на основі Ollama. + Повні відомості про налаштування та поведінку вебпошуку на базі Ollama. Повний довідник із конфігурації. diff --git a/docs/uk/providers/openai.md b/docs/uk/providers/openai.md index 3ccaf090f..83c36c411 100644 --- a/docs/uk/providers/openai.md +++ b/docs/uk/providers/openai.md @@ -1,39 +1,39 @@ --- read_when: - Ви хочете використовувати моделі OpenAI в OpenClaw - - Ви хочете автентифікацію через підписку Codex замість API-ключів + - Ви хочете автентифікацію за підпискою Codex замість API-ключів - Вам потрібна суворіша поведінка виконання агента GPT-5 summary: Використовуйте OpenAI через API-ключі або підписку Codex в OpenClaw title: OpenAI x-i18n: - generated_at: "2026-04-12T09:46:37Z" + generated_at: "2026-04-12T11:08:32Z" model: gpt-5.4 provider: openai - source_hash: 0a2eb5f742a68c4cdd1cff3bc9c0f52663b3d668b00a0db61ccf7dfb0d3f7b1d + source_hash: 6aeb756618c5611fed56e4bf89015a2304ff2e21596104b470ec6e7cb459d1c9 source_path: providers/openai.md workflow: 15 --- # OpenAI -OpenAI надає API для розробників для моделей GPT. OpenClaw підтримує два способи автентифікації: +OpenAI надає API для розробників для моделей GPT. OpenClaw підтримує два варіанти автентифікації: -- **API key** — прямий доступ до OpenAI Platform з оплатою за використання (`openai/*` моделі) -- **Codex subscription** — вхід через ChatGPT/Codex із доступом за підпискою (`openai-codex/*` моделі) +- **API-ключ** — прямий доступ до OpenAI Platform з оплатою за використання (моделі `openai/*`) +- **Підписка Codex** — вхід через ChatGPT/Codex із доступом за підпискою (моделі `openai-codex/*`) -OpenAI прямо підтримує використання OAuth за підпискою у зовнішніх інструментах і робочих процесах, таких як OpenClaw. +OpenAI явно підтримує використання OAuth за підпискою в зовнішніх інструментах і робочих процесах, таких як OpenClaw. ## Початок роботи Виберіть бажаний спосіб автентифікації та виконайте кроки налаштування. - - **Найкраще для:** прямого доступу до API та оплати за використання. + + **Найкраще підходить для:** прямого доступу до API та оплати за використання. - - Створіть або скопіюйте API key з [панелі OpenAI Platform](https://platform.openai.com/api-keys). + + Створіть або скопіюйте API-ключ на [панелі керування OpenAI Platform](https://platform.openai.com/api-keys). ```bash @@ -55,13 +55,13 @@ OpenAI прямо підтримує використання OAuth за під ### Підсумок маршрутів - | Model ref | Маршрут | Автентифікація | + | Посилання на модель | Маршрут | Автентифікація | |-----------|-------|------| | `openai/gpt-5.4` | Прямий API OpenAI Platform | `OPENAI_API_KEY` | | `openai/gpt-5.4-pro` | Прямий API OpenAI Platform | `OPENAI_API_KEY` | - Вхід через ChatGPT/Codex спрямовується через `openai-codex/*`, а не `openai/*`. + Вхід через ChatGPT/Codex маршрутизується через `openai-codex/*`, а не `openai/*`. ### Приклад конфігурації @@ -74,13 +74,13 @@ OpenAI прямо підтримує використання OAuth за під ``` - OpenClaw **не** надає `openai/gpt-5.3-codex-spark` через прямий шлях API. Реальні запити до OpenAI API відхиляють цю модель. Spark доступний лише в Codex. + OpenClaw **не** надає `openai/gpt-5.3-codex-spark` у прямому маршруті API. Живі запити до OpenAI API відхиляють цю модель. Spark доступний лише в Codex. - - **Найкраще для:** використання вашої підписки ChatGPT/Codex замість окремого API key. Codex cloud потребує входу через ChatGPT. + + **Найкраще підходить для:** використання вашої підписки ChatGPT/Codex замість окремого API-ключа. Codex cloud потребує входу в ChatGPT. @@ -108,13 +108,13 @@ OpenAI прямо підтримує використання OAuth за під ### Підсумок маршрутів - | Model ref | Маршрут | Автентифікація | + | Посилання на модель | Маршрут | Автентифікація | |-----------|-------|------| | `openai-codex/gpt-5.4` | ChatGPT/Codex OAuth | вхід Codex | - | `openai-codex/gpt-5.3-codex-spark` | ChatGPT/Codex OAuth | вхід Codex (залежить від прав доступу) | + | `openai-codex/gpt-5.3-codex-spark` | ChatGPT/Codex OAuth | вхід Codex (залежить від наявності права доступу) | - Цей маршрут навмисно відокремлений від `openai/gpt-5.4`. Використовуйте `openai/*` з API key для прямого доступу до Platform, а `openai-codex/*` — для доступу за підпискою Codex. + Цей маршрут навмисно відокремлено від `openai/gpt-5.4`. Використовуйте `openai/*` з API-ключем для прямого доступу до Platform, а `openai-codex/*` — для доступу за підпискою Codex. ### Приклад конфігурації @@ -126,19 +126,19 @@ OpenAI прямо підтримує використання OAuth за під ``` - Якщо онбординг повторно використовує наявний вхід Codex CLI, цими обліковими даними й надалі керує Codex CLI. Після завершення строку дії OpenClaw спочатку повторно зчитує зовнішнє джерело Codex, а потім записує оновлені облікові дані назад у сховище Codex. + Якщо онбординг повторно використовує наявний вхід Codex CLI, цими обліковими даними й далі керує Codex CLI. Після завершення строку дії OpenClaw спочатку повторно зчитує зовнішнє джерело Codex, а потім записує оновлені облікові дані назад у сховище Codex. ### Обмеження вікна контексту - OpenClaw розглядає метадані моделі та обмеження контексту під час виконання як окремі значення. + OpenClaw розглядає метадані моделі та ліміт контексту під час виконання як окремі значення. Для `openai-codex/gpt-5.4`: - - Нативний `contextWindow`: `1050000` - - Обмеження `contextTokens` під час виконання за замовчуванням: `272000` + - Нативне `contextWindow`: `1050000` + - Стандартний ліміт `contextTokens` під час виконання: `272000` - Менше обмеження за замовчуванням на практиці дає кращі характеристики затримки та якості. Перевизначте його за допомогою `contextTokens`: + Менший стандартний ліміт на практиці забезпечує кращі характеристики затримки та якості. Ви можете перевизначити його через `contextTokens`: ```json5 { @@ -153,7 +153,7 @@ OpenAI прямо підтримує використання OAuth за під ``` - Використовуйте `contextWindow`, щоб оголосити нативні метадані моделі. Використовуйте `contextTokens`, щоб обмежити бюджет контексту під час виконання. + Використовуйте `contextWindow`, щоб указати нативні метадані моделі. Використовуйте `contextTokens`, щоб обмежити бюджет контексту під час виконання. @@ -163,12 +163,12 @@ OpenAI прямо підтримує використання OAuth за під Вбудований Plugin `openai` реєструє генерацію зображень через інструмент `image_generate`. -| Можливість | Значення | -| ------------------------ | ----------------------------------- | -| Модель за замовчуванням | `openai/gpt-image-1` | +| Можливість | Значення | +| ------------------------- | ---------------------------------- | +| Модель за замовчуванням | `openai/gpt-image-1` | | Максимум зображень на запит | 4 | -| Режим редагування | Увімкнено (до 5 еталонних зображень) | -| Перевизначення розміру | Підтримується | +| Режим редагування | Увімкнено (до 5 еталонних зображень) | +| Перевизначення розміру | Підтримується | | Співвідношення сторін / роздільна здатність | Не передаються до OpenAI Images API | ```json5 @@ -182,7 +182,7 @@ OpenAI прямо підтримує використання OAuth за під ``` -Див. [Генерація зображень](/uk/tools/image-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку перемикання при відмові. +Див. [Генерація зображень](/uk/tools/image-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку failover. ## Генерація відео @@ -190,11 +190,11 @@ OpenAI прямо підтримує використання OAuth за під Вбудований Plugin `openai` реєструє генерацію відео через інструмент `video_generate`. | Можливість | Значення | -| --------------- | ------------------------------------------------------------------------------- | -| Модель за замовчуванням | `openai/sora-2` | -| Режими | Текст у відео, зображення у відео, редагування одного відео | -| Вхідні еталони | 1 зображення або 1 відео | -| Перевизначення розміру | Підтримується | +| ---------------- | -------------------------------------------------------------------------------- | +| Модель за замовчуванням | `openai/sora-2` | +| Режими | Текст у відео, зображення у відео, редагування одного відео | +| Вхідні еталони | 1 зображення або 1 відео | +| Перевизначення розміру | Підтримується | | Інші перевизначення | `aspectRatio`, `resolution`, `audio`, `watermark` ігноруються з попередженням інструмента | ```json5 @@ -208,21 +208,21 @@ OpenAI прямо підтримує використання OAuth за під ``` -Див. [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку перемикання при відмові. +Див. [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку failover. -## Накладка особистості +## Накладення особистості -OpenClaw додає невелику специфічну для OpenAI накладку запиту для запусків `openai/*` і `openai-codex/*`. Ця накладка робить асистента теплішим, більш налаштованим на співпрацю, лаконічнішим і трохи більш емоційно виразним, не замінюючи базовий системний запит. +OpenClaw додає невелике специфічне для OpenAI накладення промпта для запусків `openai/*` і `openai-codex/*`. Це накладення робить асистента теплим, орієнтованим на співпрацю, лаконічним і трохи більш емоційно виразним, не замінюючи базовий системний промпт. -| Значення | Ефект | -| ---------------------- | ------------------------------------ | -| `"friendly"` (за замовчуванням) | Увімкнути специфічну для OpenAI накладку | -| `"on"` | Псевдонім для `"friendly"` | -| `"off"` | Використовувати лише базовий запит OpenClaw | +| Значення | Ефект | +| ---------------------- | ---------------------------------- | +| `"friendly"` (типово) | Увімкнути специфічне для OpenAI накладення | +| `"on"` | Псевдонім для `"friendly"` | +| `"off"` | Використовувати лише базовий промпт OpenClaw | - + ```json5 { plugins: { @@ -241,24 +241,95 @@ OpenClaw додає невелику специфічну для OpenAI накл -Під час виконання значення нечутливі до регістру, тому і `"Off"`, і `"off"` вимикають накладку. +Під час виконання значення не чутливі до регістру, тож і `"Off"`, і `"off"` вимикають накладення. +## Голос і мовлення + + + + Вбудований Plugin `openai` реєструє синтез мовлення для поверхні `messages.tts`. + + | Параметр | Шлях конфігурації | Типово | + |---------|------------|---------| + | Модель | `messages.tts.providers.openai.model` | `gpt-4o-mini-tts` | + | Голос | `messages.tts.providers.openai.voice` | `coral` | + | Швидкість | `messages.tts.providers.openai.speed` | (не встановлено) | + | Інструкції | `messages.tts.providers.openai.instructions` | (не встановлено, лише `gpt-4o-mini-tts`) | + | Формат | `messages.tts.providers.openai.responseFormat` | `opus` для голосових нотаток, `mp3` для файлів | + | API-ключ | `messages.tts.providers.openai.apiKey` | Використовує `OPENAI_API_KEY` як запасний варіант | + | Base URL | `messages.tts.providers.openai.baseUrl` | `https://api.openai.com/v1` | + + Доступні моделі: `gpt-4o-mini-tts`, `tts-1`, `tts-1-hd`. Доступні голоси: `alloy`, `ash`, `ballad`, `cedar`, `coral`, `echo`, `fable`, `juniper`, `marin`, `onyx`, `nova`, `sage`, `shimmer`, `verse`. + + ```json5 + { + messages: { + tts: { + providers: { + openai: { model: "gpt-4o-mini-tts", voice: "coral" }, + }, + }, + }, + } + ``` + + + Установіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL для TTS, не впливаючи на кінцеву точку chat API. + + + + + + Вбудований Plugin `openai` реєструє транскрипцію в реальному часі для Plugin Voice Call. + + | Параметр | Шлях конфігурації | Типово | + |---------|------------|---------| + | Модель | `plugins.entries.voice-call.config.streaming.providers.openai.model` | `gpt-4o-transcribe` | + | Тривалість тиші | `...openai.silenceDurationMs` | `800` | + | Поріг VAD | `...openai.vadThreshold` | `0.5` | + | API-ключ | `...openai.apiKey` | Використовує `OPENAI_API_KEY` як запасний варіант | + + + Використовує WebSocket-з’єднання з `wss://api.openai.com/v1/realtime` з аудіо G.711 u-law. + + + + + + Вбудований Plugin `openai` реєструє голос у реальному часі для Plugin Voice Call. + + | Параметр | Шлях конфігурації | Типово | + |---------|------------|---------| + | Модель | `plugins.entries.voice-call.config.realtime.providers.openai.model` | `gpt-realtime` | + | Голос | `...openai.voice` | `alloy` | + | Temperature | `...openai.temperature` | `0.8` | + | Поріг VAD | `...openai.vadThreshold` | `0.5` | + | Тривалість тиші | `...openai.silenceDurationMs` | `500` | + | API-ключ | `...openai.apiKey` | Використовує `OPENAI_API_KEY` як запасний варіант | + + + Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двонапрямлений виклик інструментів. Використовує аудіоформат G.711 u-law. + + + + + ## Розширена конфігурація - OpenClaw використовує WebSocket у першу чергу з резервним переходом на SSE (`"auto"`) для `openai/*` і `openai-codex/*`. + OpenClaw використовує пріоритет WebSocket із запасним переходом на SSE (`"auto"`) як для `openai/*`, так і для `openai-codex/*`. У режимі `"auto"` OpenClaw: - - Повторює одну ранню помилку WebSocket перед переходом на SSE - - Після збою позначає WebSocket як деградований приблизно на 60 секунд і під час охолодження використовує SSE - - Додає стабільні заголовки ідентичності сесії та ходу для повторних спроб і перепідключень + - Повторює одну ранню невдалу спробу WebSocket перед переходом на SSE + - Після збою позначає WebSocket як деградований приблизно на 60 секунд і використовує SSE під час охолодження + - Додає стабільні заголовки ідентичності сесії та ходу для повторних спроб і повторних підключень - Нормалізує лічильники використання (`input_tokens` / `prompt_tokens`) між варіантами транспорту | Значення | Поведінка | |-------|----------| - | `"auto"` (за замовчуванням) | Спочатку WebSocket, резервно SSE | + | `"auto"` (типово) | Спочатку WebSocket, запасний перехід на SSE | | `"sse"` | Примусово лише SSE | | `"websocket"` | Примусово лише WebSocket | @@ -282,11 +353,11 @@ OpenClaw додає невелику специфічну для OpenAI накл - - OpenClaw за замовчуванням вмикає прогрівання WebSocket для `openai/*`, щоб зменшити затримку першого ходу. + + OpenClaw типово вмикає прогрів WebSocket для `openai/*`, щоб зменшити затримку першого ходу. ```json5 - // Вимкнути прогрівання + // Вимкнути прогрів { agents: { defaults: { @@ -306,9 +377,9 @@ OpenClaw додає невелику специфічну для OpenAI накл OpenClaw надає спільний перемикач швидкого режиму для `openai/*` і `openai-codex/*`: - **Чат/UI:** `/fast status|on|off` - - **Config:** `agents.defaults.models["/"].params.fastMode` + - **Конфігурація:** `agents.defaults.models["/"].params.fastMode` - Коли цей режим увімкнено, OpenClaw зіставляє швидкий режим із пріоритетною обробкою OpenAI (`service_tier = "priority"`). Наявні значення `service_tier` зберігаються, а швидкий режим не переписує `reasoning` або `text.verbosity`. + Коли ввімкнено, OpenClaw зіставляє швидкий режим із пріоритетною обробкою OpenAI (`service_tier = "priority"`). Наявні значення `service_tier` зберігаються, а швидкий режим не переписує `reasoning` або `text.verbosity`. ```json5 { @@ -324,7 +395,7 @@ OpenClaw додає невелику специфічну для OpenAI накл ``` - Перевизначення сесії мають пріоритет над конфігурацією. Очищення перевизначення сесії в UI сесій повертає сесію до налаштованого значення за замовчуванням. + Перевизначення на рівні сесії мають пріоритет над конфігурацією. Очищення перевизначення сесії в інтерфейсі Sessions повертає сесію до налаштованого типового значення. @@ -348,7 +419,7 @@ OpenClaw додає невелику специфічну для OpenAI накл Підтримувані значення: `auto`, `default`, `flex`, `priority`. - `serviceTier` передається лише до нативних endpoint-ів OpenAI (`api.openai.com`) і нативних endpoint-ів Codex (`chatgpt.com/backend-api`). Якщо ви спрямовуєте будь-якого з цих провайдерів через проксі, OpenClaw залишає `service_tier` без змін. + `serviceTier` передається лише до нативних кінцевих точок OpenAI (`api.openai.com`) і нативних кінцевих точок Codex (`chatgpt.com/backend-api`). Якщо ви маршрутизуєте будь-якого з провайдерів через проксі, OpenClaw залишає `service_tier` без змін. @@ -356,13 +427,13 @@ OpenClaw додає невелику специфічну для OpenAI накл Для прямих моделей OpenAI Responses (`openai/*` на `api.openai.com`) OpenClaw автоматично вмикає серверну Compaction: - - Примусово встановлює `store: true` (якщо сумісність моделі не задає `supportsStore: false`) - - Впроваджує `context_management: [{ type: "compaction", compact_threshold: ... }]` - - `compact_threshold` за замовчуванням: 70% від `contextWindow` (або `80000`, якщо значення недоступне) + - Примусово встановлює `store: true` (якщо лише сумісність моделі не встановлює `supportsStore: false`) + - Додає `context_management: [{ type: "compaction", compact_threshold: ... }]` + - Типове значення `compact_threshold`: 70% від `contextWindow` (або `80000`, якщо недоступно) - Корисно для сумісних endpoint-ів, таких як Azure OpenAI Responses: + Корисно для сумісних кінцевих точок, таких як Azure OpenAI Responses: ```json5 { @@ -414,7 +485,7 @@ OpenClaw додає невелику специфічну для OpenAI накл - `responsesServerCompaction` керує лише впровадженням `context_management`. Прямі моделі OpenAI Responses усе одно примусово встановлюють `store: true`, якщо compat не задає `supportsStore: false`. + `responsesServerCompaction` керує лише додаванням `context_management`. Прямі моделі OpenAI Responses усе одно примусово встановлюють `store: true`, якщо сумісність не задає `supportsStore: false`. @@ -432,32 +503,32 @@ OpenClaw додає невелику специфічну для OpenAI накл } ``` - З `strict-agentic` OpenClaw: + Із `strict-agentic` OpenClaw: - Більше не вважає хід лише з планом успішним прогресом, коли доступна дія інструмента - Повторює хід із вказівкою діяти негайно - Автоматично вмикає `update_plan` для суттєвої роботи - Показує явний заблокований стан, якщо модель продовжує планувати без дії - Поширюється лише на запуски сімейства GPT-5 від OpenAI і Codex. Для інших провайдерів і старіших сімейств моделей зберігається поведінка за замовчуванням. + Застосовується лише до запусків сімейства GPT-5 OpenAI та Codex. Інші провайдери й старіші сімейства моделей зберігають типову поведінку. - - OpenClaw по-різному обробляє прямі endpoint-и OpenAI, Codex і Azure OpenAI порівняно із загальними проксі `/v1`, сумісними з OpenAI: + + OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI та загальні сумісні з OpenAI проксі `/v1`: **Нативні маршрути** (`openai/*`, `openai-codex/*`, Azure OpenAI): - Зберігають `reasoning: { effort: "none" }` без змін, коли міркування явно вимкнено - - За замовчуванням використовують суворий режим для схем інструментів + - Типово використовують суворий режим для схем інструментів - Додають приховані заголовки атрибуції лише на перевірених нативних хостах - - Зберігають формування запитів, специфічне для OpenAI (`service_tier`, `store`, compat міркувань, підказки кешу запитів) + - Зберігають формування запитів, характерне лише для OpenAI (`service_tier`, `store`, сумісність reasoning, підказки кешу промптів) **Проксі/сумісні маршрути:** - - Використовують м’якшу compat-поведінку - - Не примушують суворі схеми інструментів або нативні заголовки + - Використовують м’якшу поведінку сумісності + - Не примушують до суворих схем інструментів або нативних заголовків - Azure OpenAI використовує нативний транспорт і compat-поведінку, але не отримує приховані заголовки атрибуції. + Azure OpenAI використовує нативний транспорт і нативну поведінку сумісності, але не отримує приховані заголовки атрибуції. @@ -466,13 +537,13 @@ OpenClaw додає невелику специфічну для OpenAI накл - Вибір провайдерів, посилань на моделі та поведінки перемикання при відмові. + Вибір провайдерів, посилань на моделі та поведінки failover. Спільні параметри інструмента зображень і вибір провайдера. - Спільні параметри інструмента відео та вибір провайдера. + Спільні параметри інструмента відео і вибір провайдера. Докладніше про автентифікацію та правила повторного використання облікових даних. diff --git a/docs/uk/providers/qwen.md b/docs/uk/providers/qwen.md index b1b388718..addc25938 100644 --- a/docs/uk/providers/qwen.md +++ b/docs/uk/providers/qwen.md @@ -2,13 +2,13 @@ read_when: - Ви хочете використовувати Qwen з OpenClaw - Раніше ви використовували Qwen OAuth -summary: Використовуйте Qwen Cloud через вбудований провайдер qwen в OpenClaw +summary: Використовуйте Qwen Cloud через вбудований провайдер qwen OpenClaw title: Qwen x-i18n: - generated_at: "2026-04-12T10:12:16Z" + generated_at: "2026-04-12T11:08:32Z" model: gpt-5.4 provider: openai - source_hash: bbd8efa131d37a5dc7578aa0318b8bcb6d492b35858fa611f3fbd8416cf6b866 + source_hash: 5247f851ef891645df6572d748ea15deeea47cd1d75858bc0d044a2930065106 source_path: providers/qwen.md workflow: 15 --- @@ -17,17 +17,16 @@ x-i18n: -**Qwen OAuth було видалено.** Безкоштовна інтеграція OAuth +**Qwen OAuth було видалено.** Безкоштовна OAuth-інтеграція (`qwen-portal`), яка використовувала ендпоїнти `portal.qwen.ai`, більше недоступна. Див. [Issue #49557](https://github.com/openclaw/openclaw/issues/49557) для -додаткового контексту. +контексту. -OpenClaw тепер розглядає Qwen як вбудованого провайдера першого класу з канонічним ідентифікатором +OpenClaw тепер розглядає Qwen як вбудованого провайдера першого класу з канонічним id `qwen`. Вбудований провайдер орієнтується на ендпоїнти Qwen Cloud / Alibaba DashScope та -Coding Plan і зберігає застарілі ідентифікатори `modelstudio` як -аліас сумісності. +Coding Plan і зберігає роботу застарілих id `modelstudio` як псевдоніма сумісності. - Провайдер: `qwen` - Бажана змінна середовища: `QWEN_API_KEY` @@ -35,7 +34,7 @@ Coding Plan і зберігає застарілі ідентифікатори - Стиль API: сумісний з OpenAI -Якщо вам потрібен `qwen3.6-plus`, віддавайте перевагу ендпоїнту **Standard (оплата за використання)**. +Якщо ви хочете використовувати `qwen3.6-plus`, віддайте перевагу ендпоїнту **Standard (оплата за використання)**. Підтримка Coding Plan може відставати від публічного каталогу. @@ -45,13 +44,13 @@ Coding Plan і зберігає застарілі ідентифікатори - **Найкраще підходить для:** доступу за підпискою через Qwen Coding Plan. + **Найкраще для:** доступу за підпискою через Qwen Coding Plan. - Створіть або скопіюйте API-ключ на [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys). + Створіть або скопіюйте API-ключ із [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys). - + Для ендпоїнта **Global**: ```bash @@ -64,7 +63,7 @@ Coding Plan і зберігає застарілі ідентифікатори openclaw onboard --auth-choice qwen-api-key-cn ``` - + ```json5 { agents: { @@ -83,21 +82,21 @@ Coding Plan і зберігає застарілі ідентифікатори - Застарілі ідентифікатори `modelstudio-*` для auth-choice і посилання на моделі `modelstudio/...` усе ще - працюють як аліаси сумісності, але нові сценарії налаштування мають віддавати перевагу канонічним - ідентифікаторам auth-choice `qwen-*` і посиланням на моделі `qwen/...`. + Застарілі id `modelstudio-*` для auth-choice і посилання на моделі `modelstudio/...` усе ще + працюють як псевдоніми сумісності, але нові сценарії налаштування мають використовувати канонічні + id auth-choice `qwen-*` і посилання на моделі `qwen/...`. - **Найкраще підходить для:** доступу з оплатою за використання через ендпоїнт Standard Model Studio, включно з моделями на кшталт `qwen3.6-plus`, які можуть бути недоступні в Coding Plan. + **Найкраще для:** доступу з оплатою за використання через ендпоїнт Standard Model Studio, включно з моделями на кшталт `qwen3.6-plus`, які можуть бути недоступні в Coding Plan. - Створіть або скопіюйте API-ключ на [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys). + Створіть або скопіюйте API-ключ із [home.qwencloud.com/api-keys](https://home.qwencloud.com/api-keys). - + Для ендпоїнта **Global**: ```bash @@ -110,7 +109,7 @@ Coding Plan і зберігає застарілі ідентифікатори openclaw onboard --auth-choice qwen-standard-api-key-cn ``` - + ```json5 { agents: { @@ -129,15 +128,15 @@ Coding Plan і зберігає застарілі ідентифікатори - Застарілі ідентифікатори `modelstudio-*` для auth-choice і посилання на моделі `modelstudio/...` усе ще - працюють як аліаси сумісності, але нові сценарії налаштування мають віддавати перевагу канонічним - ідентифікаторам auth-choice `qwen-*` і посиланням на моделі `qwen/...`. + Застарілі id `modelstudio-*` для auth-choice і посилання на моделі `modelstudio/...` усе ще + працюють як псевдоніми сумісності, але нові сценарії налаштування мають використовувати канонічні + id auth-choice `qwen-*` і посилання на моделі `qwen/...`. -## Типи планів і ендпоїнти +## Типи планів та ендпоїнти | План | Регіон | Auth choice | Ендпоїнт | | -------------------------- | ------ | -------------------------- | ------------------------------------------------ | @@ -147,7 +146,7 @@ Coding Plan і зберігає застарілі ідентифікатори | Coding Plan (підписка) | Global | `qwen-api-key` | `coding-intl.dashscope.aliyuncs.com/v1` | Провайдер автоматично вибирає ендпоїнт на основі вашого auth choice. Канонічні -варіанти використовують сімейство `qwen-*`; `modelstudio-*` залишається лише для сумісності. +варіанти використовують сімейство `qwen-*`; `modelstudio-*` лишається лише для сумісності. Ви можете перевизначити це за допомогою власного `baseUrl` у конфігурації. @@ -157,18 +156,18 @@ Coding Plan і зберігає застарілі ідентифікатори ## Вбудований каталог -Наразі OpenClaw постачається з цим вбудованим каталогом Qwen. Налаштований каталог -залежить від ендпоїнта: конфігурації Coding Plan не включають моделі, про які відомо, що вони працюють +Наразі OpenClaw постачається з таким вбудованим каталогом Qwen. Налаштований каталог +враховує ендпоїнт: конфігурації Coding Plan не включають моделі, які, як відомо, працюють лише на ендпоїнті Standard. | Посилання на модель | Вхідні дані | Контекст | Примітки | | --------------------------- | ----------- | --------- | -------------------------------------------------- | | `qwen/qwen3.5-plus` | text, image | 1,000,000 | Модель за замовчуванням | -| `qwen/qwen3.6-plus` | text, image | 1,000,000 | Віддавайте перевагу ендпоїнтам Standard, якщо вам потрібна ця модель | +| `qwen/qwen3.6-plus` | text, image | 1,000,000 | Віддавайте перевагу ендпоїнтам Standard, коли вам потрібна ця модель | | `qwen/qwen3-max-2026-01-23` | text | 262,144 | Лінійка Qwen Max | | `qwen/qwen3-coder-next` | text | 262,144 | Кодування | | `qwen/qwen3-coder-plus` | text | 1,000,000 | Кодування | -| `qwen/MiniMax-M2.5` | text | 1,000,000 | Увімкнено міркування | +| `qwen/MiniMax-M2.5` | text | 1,000,000 | Reasoning увімкнено | | `qwen/glm-5` | text | 202,752 | GLM | | `qwen/glm-4.7` | text | 202,752 | GLM | | `qwen/kimi-k2.5` | text, image | 262,144 | Moonshot AI через Alibaba | @@ -199,31 +198,46 @@ DashScope (не на ендпоїнтах Coding Plan): ``` -Див. [Video Generation](/uk/tools/video-generation) для спільних параметрів інструмента, вибору провайдера та поведінки failover. +Див. [Генерація відео](/uk/tools/video-generation) для спільних параметрів інструмента, вибору провайдера та поведінки failover. ## Додатково + + Вбудований Plugin Qwen реєструє розуміння медіа для зображень і відео + на ендпоїнтах **Standard** DashScope (не на ендпоїнтах Coding Plan). + + | Властивість | Значення | + | ------------- | --------------------- | + | Модель | `qwen-vl-max-latest` | + | Підтримуваний вхід | Зображення, відео | + + Розуміння медіа автоматично визначається з налаштованої автентифікації Qwen — + додаткова конфігурація не потрібна. Переконайтеся, що ви використовуєте ендпоїнт + Standard (оплата за використання) для підтримки розуміння медіа. + + + - `qwen3.6-plus` доступна на ендпоїнтах Model Studio Standard (оплата за використання): + `qwen3.6-plus` доступна на ендпоїнтах Standard (оплата за використання) Model Studio: - China: `dashscope.aliyuncs.com/compatible-mode/v1` - Global: `dashscope-intl.aliyuncs.com/compatible-mode/v1` Якщо ендпоїнти Coding Plan повертають помилку "unsupported model" для `qwen3.6-plus`, перейдіть на Standard (оплата за використання) замість пари - ендпоїнт/ключ від Coding Plan. + ендпоїнт/ключ Coding Plan. - Розширення `qwen` позиціонується як домашній вендорський модуль для всієї поверхні Qwen + Розширення `qwen` позиціонується як основний вендорський дім для всієї поверхні Qwen Cloud, а не лише для моделей кодування/тексту. - **Текстові/chat-моделі:** уже вбудовано - - **Виклик інструментів, структурований вивід, thinking:** успадковується від транспорту, сумісного з OpenAI - - **Генерація зображень:** запланована на рівні provider-plugin + - **Виклик інструментів, структурований вивід, thinking:** успадковано від OpenAI-сумісного транспорту + - **Генерація зображень:** заплановано на рівні provider-plugin - **Розуміння зображень/відео:** уже вбудовано на ендпоїнті Standard - **Мовлення/аудіо:** заплановано на рівні provider-plugin - **Ембеддинги пам’яті/reranking:** заплановано через поверхню адаптера ембеддингів @@ -232,14 +246,14 @@ DashScope (не на ендпоїнтах Coding Plan): - Для генерації відео OpenClaw зіставляє налаштований регіон Qwen із відповідним + Для генерації відео OpenClaw зіставляє налаштований регіон Qwen з відповідним хостом DashScope AIGC перед відправленням завдання: - Global/Intl: `https://dashscope-intl.aliyuncs.com` - China: `https://dashscope.aliyuncs.com` - Це означає, що звичайний `models.providers.qwen.baseUrl`, який вказує або на - хости Qwen Coding Plan, або Standard, усе одно зберігає генерацію відео на правильному + Це означає, що звичайний `models.providers.qwen.baseUrl`, який указує на хости + Qwen Coding Plan або Standard, усе одно зберігає генерацію відео на правильному регіональному відеоендпоїнті DashScope. Поточні обмеження вбудованої генерації відео Qwen: @@ -247,23 +261,23 @@ DashScope (не на ендпоїнтах Coding Plan): - До **1** вихідного відео на запит - До **1** вхідного зображення - До **4** вхідних відео - - До **10 секунд** тривалості + - Тривалість до **10 секунд** - Підтримує `size`, `aspectRatio`, `resolution`, `audio` і `watermark` - - Режим опорного зображення/відео наразі вимагає **віддалених URL-адрес http(s)**. Локальні + - Режим еталонного зображення/відео наразі вимагає **віддалені URL-адреси http(s)**. Локальні шляхи до файлів відхиляються одразу, оскільки відеоендпоїнт DashScope не - приймає завантажені локальні буфери для таких посилань. + приймає завантажені локальні буфери для цих посилань. - Власні ендпоїнти Model Studio декларують сумісність використання потокової передачі на - спільному транспорті `openai-completions`. Тепер OpenClaw визначає це за можливостями ендпоїнта, - тому сумісні з DashScope власні ідентифікатори провайдерів, націлені на ті самі нативні хости, - успадковують ту саму поведінку використання потокової передачі замість - вимоги саме вбудованого ідентифікатора провайдера `qwen`. + Власні ендпоїнти Model Studio оголошують сумісність використання потокової передачі на + спільному транспорті `openai-completions`. OpenClaw тепер визначає це за можливостями ендпоїнта, + тому сумісні з DashScope кастомні id провайдерів, що вказують на ті самі нативні хости, + успадковують таку саму поведінку використання потокової передачі замість того, + щоб вимагати саме вбудований id провайдера `qwen`. - Сумісність використання нативної потокової передачі застосовується як до хостів Coding Plan, так і до - сумісних із DashScope хостів Standard: + Сумісність нативного потокового використання застосовується як до хостів Coding Plan, + так і до сумісних хостів Standard DashScope: - `https://coding.dashscope.aliyuncs.com/v1` - `https://coding-intl.dashscope.aliyuncs.com/v1` @@ -274,21 +288,21 @@ DashScope (не на ендпоїнтах Coding Plan): Мультимодальні поверхні (розуміння відео та генерація відео Wan) використовують - ендпоїнти DashScope **Standard**, а не ендпоїнти Coding Plan: + ендпоїнти **Standard** DashScope, а не ендпоїнти Coding Plan: - - Базова URL-адреса Global/Intl Standard: `https://dashscope-intl.aliyuncs.com/compatible-mode/v1` - - Базова URL-адреса China Standard: `https://dashscope.aliyuncs.com/compatible-mode/v1` + - Базовий URL Global/Intl Standard: `https://dashscope-intl.aliyuncs.com/compatible-mode/v1` + - Базовий URL China Standard: `https://dashscope.aliyuncs.com/compatible-mode/v1` Якщо Gateway працює як демон (launchd/systemd), переконайтеся, що `QWEN_API_KEY` - доступна для цього процесу (наприклад, у `~/.openclaw/.env` або через + доступний цьому процесу (наприклад, у `~/.openclaw/.env` або через `env.shellEnv`). -## Пов’язані матеріали +## Пов’язане diff --git a/docs/uk/providers/xai.md b/docs/uk/providers/xai.md index eeb1dfef7..a35a936ab 100644 --- a/docs/uk/providers/xai.md +++ b/docs/uk/providers/xai.md @@ -5,17 +5,17 @@ read_when: summary: Використовуйте моделі xAI Grok в OpenClaw title: xAI x-i18n: - generated_at: "2026-04-12T10:19:22Z" + generated_at: "2026-04-12T11:08:31Z" model: gpt-5.4 provider: openai - source_hash: 064aa758f9791f704dc6b0cc0059bb73b7de68ae2edd731bb87dbc26730eea9f + source_hash: 820fef290c67d9815e41a96909d567216f67ca0f01df1d325008fd04666ad255 source_path: providers/xai.md workflow: 15 --- # xAI -OpenClaw постачається з вбудованим Plugin провайдера `xai` для моделей Grok. +OpenClaw постачається з вбудованим плагіном провайдера `xai` для моделей Grok. ## Початок роботи @@ -42,62 +42,62 @@ OpenClaw постачається з вбудованим Plugin провайд OpenClaw використовує xAI Responses API як вбудований транспорт xAI. Той самий -`XAI_API_KEY` також може забезпечувати роботу `web_search` на базі Grok, вбудованого `x_search` -та віддаленого `code_execution`. +`XAI_API_KEY` також може забезпечувати роботу Grok-backed `web_search`, повноцінного `x_search` +і віддаленого `code_execution`. Якщо ви зберігаєте ключ xAI у `plugins.entries.xai.config.webSearch.apiKey`, вбудований провайдер моделей xAI також повторно використовує цей ключ як резервний варіант. -Налаштування `code_execution` розміщуються в `plugins.entries.xai.config.codeExecution`. +Налаштування `code_execution` розміщені в `plugins.entries.xai.config.codeExecution`. ## Каталог вбудованих моделей OpenClaw містить такі сімейства моделей xAI з коробки: -| Сімейство | Ідентифікатори моделей | -| ------------- | -------------------------------------------------------------------------- | -| Grok 3 | `grok-3`, `grok-3-fast`, `grok-3-mini`, `grok-3-mini-fast` | -| Grok 4 | `grok-4`, `grok-4-0709` | -| Grok 4 Fast | `grok-4-fast`, `grok-4-fast-non-reasoning` | -| Grok 4.1 Fast | `grok-4-1-fast`, `grok-4-1-fast-non-reasoning` | +| Сімейство | Ідентифікатори моделей | +| -------------- | ----------------------------------------------------------------------- | +| Grok 3 | `grok-3`, `grok-3-fast`, `grok-3-mini`, `grok-3-mini-fast` | +| Grok 4 | `grok-4`, `grok-4-0709` | +| Grok 4 Fast | `grok-4-fast`, `grok-4-fast-non-reasoning` | +| Grok 4.1 Fast | `grok-4-1-fast`, `grok-4-1-fast-non-reasoning` | | Grok 4.20 Beta | `grok-4.20-beta-latest-reasoning`, `grok-4.20-beta-latest-non-reasoning` | -| Grok Code | `grok-code-fast-1` | +| Grok Code | `grok-code-fast-1` | -Plugin також перенаправлено розпізнає новіші ідентифікатори `grok-4*` і `grok-code-fast*`, коли +Плагін також напряму зіставляє новіші ідентифікатори `grok-4*` і `grok-code-fast*`, коли вони відповідають тій самій формі API. `grok-4-fast`, `grok-4-1-fast` і варіанти `grok-4.20-beta-*` — -це поточні посилання Grok з підтримкою зображень у вбудованому каталозі. +це поточні посилання Grok із підтримкою зображень у вбудованому каталозі. -### Відображення Fast-mode +### Зіставлення швидкого режиму `/fast on` або `agents.defaults.models["xai/"].params.fastMode: true` -перезаписує нативні запити xAI таким чином: +перезаписує нативні запити xAI так: -| Вихідна модель | Ціль Fast-mode | -| -------------- | ----------------- | -| `grok-3` | `grok-3-fast` | -| `grok-3-mini` | `grok-3-mini-fast` | -| `grok-4` | `grok-4-fast` | -| `grok-4-0709` | `grok-4-fast` | +| Вихідна модель | Ціль швидкого режиму | +| -------------- | -------------------- | +| `grok-3` | `grok-3-fast` | +| `grok-3-mini` | `grok-3-mini-fast` | +| `grok-4` | `grok-4-fast` | +| `grok-4-0709` | `grok-4-fast` | -### Застарілі аліаси сумісності +### Застарілі псевдоніми сумісності -Застарілі аліаси й далі нормалізуються до канонічних вбудованих ідентифікаторів: +Застарілі псевдоніми все ще нормалізуються до канонічних вбудованих ідентифікаторів: -| Застарілий аліас | Канонічний ідентифікатор | -| ------------------------ | ----------------------------------- | -| `grok-4-fast-reasoning` | `grok-4-fast` | -| `grok-4-1-fast-reasoning` | `grok-4-1-fast` | -| `grok-4.20-reasoning` | `grok-4.20-beta-latest-reasoning` | -| `grok-4.20-non-reasoning` | `grok-4.20-beta-latest-non-reasoning` | +| Застарілий псевдонім | Канонічний ідентифікатор | +| -------------------------- | ---------------------------------- | +| `grok-4-fast-reasoning` | `grok-4-fast` | +| `grok-4-1-fast-reasoning` | `grok-4-1-fast` | +| `grok-4.20-reasoning` | `grok-4.20-beta-latest-reasoning` | +| `grok-4.20-non-reasoning` | `grok-4.20-beta-latest-non-reasoning` | ## Можливості - - Вбудований провайдер веб-пошуку `grok` також використовує `XAI_API_KEY`: + + Вбудований провайдер вебпошуку `grok` також використовує `XAI_API_KEY`: ```bash openclaw config set tools.web.search.provider grok @@ -106,16 +106,16 @@ Plugin також перенаправлено розпізнає новіші - Вбудований Plugin `xai` реєструє генерацію відео через спільний + Вбудований плагін `xai` реєструє генерацію відео через спільний інструмент `video_generate`. - Модель відео за замовчуванням: `xai/grok-imagine-video` - - Режими: text-to-video, image-to-video та віддалені потоки редагування/розширення відео + - Режими: text-to-video, image-to-video, а також віддалені потоки редагування/розширення відео - Підтримує `aspectRatio` і `resolution` - Локальні буфери відео не приймаються. Використовуйте віддалені URL `http(s)` для - посилань на відео та вхідних даних редагування. + Локальні відеобуфери не приймаються. Для + вхідних даних video-reference і edit використовуйте віддалені URL-адреси `http(s)`. Щоб використовувати xAI як провайдера відео за замовчуванням: @@ -134,50 +134,120 @@ Plugin також перенаправлено розпізнає новіші Див. [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри інструмента, - вибір провайдера та поведінку перемикання на резервний варіант. + вибір провайдера та поведінку резервного перемикання. + + Вбудований плагін xAI надає `x_search` як інструмент OpenClaw для пошуку + контенту X (раніше Twitter) через Grok. + + Шлях конфігурації: `plugins.entries.xai.config.xSearch` + + | Ключ | Тип | За замовчуванням | Опис | + | ------------------ | ------- | ------------------- | ------------------------------------ | + | `enabled` | boolean | — | Увімкнути або вимкнути x_search | + | `model` | string | `grok-4-1-fast` | Модель для запитів x_search | + | `inlineCitations` | boolean | — | Додавати вбудовані цитати в результати | + | `maxTurns` | number | — | Максимальна кількість ходів розмови | + | `timeoutSeconds` | number | — | Тайм-аут запиту в секундах | + | `cacheTtlMinutes` | number | — | Час життя кешу в хвилинах | + + ```json5 + { + plugins: { + entries: { + xai: { + config: { + xSearch: { + enabled: true, + model: "grok-4-1-fast", + inlineCitations: true, + }, + }, + }, + }, + }, + } + ``` + + + + + Вбудований плагін xAI надає `code_execution` як інструмент OpenClaw для + віддаленого виконання коду в середовищі sandbox xAI. + + Шлях конфігурації: `plugins.entries.xai.config.codeExecution` + + | Ключ | Тип | За замовчуванням | Опис | + | ----------------- | ------- | ------------------------- | ---------------------------------------- | + | `enabled` | boolean | `true` (якщо ключ доступний) | Увімкнути або вимкнути виконання коду | + | `model` | string | `grok-4-1-fast` | Модель для запитів виконання коду | + | `maxTurns` | number | — | Максимальна кількість ходів розмови | + | `timeoutSeconds` | number | — | Тайм-аут запиту в секундах | + + + Це віддалене виконання в sandbox xAI, а не локальний [`exec`](/uk/tools/exec). + + + ```json5 + { + plugins: { + entries: { + xai: { + config: { + codeExecution: { + enabled: true, + model: "grok-4-1-fast", + }, + }, + }, + }, + }, + } + ``` + + + - - Наразі автентифікація підтримується лише через API-ключ. У - OpenClaw поки немає потоку xAI OAuth або device-code. - - `grok-4.20-multi-agent-experimental-beta-0304` не підтримується у - звичайному шляху провайдера xAI, оскільки він вимагає іншої поверхні + - Наразі автентифікація підтримується лише через API-ключ. В OpenClaw поки що немає потоку xAI OAuth або device-code. + - `grok-4.20-multi-agent-experimental-beta-0304` не підтримується в + звичайному шляху провайдера xAI, оскільки він потребує іншої поверхні upstream API, ніж стандартний транспорт xAI в OpenClaw. - - OpenClaw автоматично застосовує виправлення сумісності, специфічні для xAI, для схем інструментів і викликів інструментів + - OpenClaw автоматично застосовує виправлення сумісності схем інструментів і викликів інструментів, специфічні для xAI, у спільному шляху виконання. - - Для нативних запитів xAI за замовчуванням використовується `tool_stream: true`. Установіть + - Нативні запити xAI за замовчуванням використовують `tool_stream: true`. Установіть `agents.defaults.models["xai/"].params.tool_stream` у `false`, щоб вимкнути це. - - Вбудована обгортка xAI вилучає непідтримувані строгі прапорці схем інструментів і + - Вбудована обгортка xAI видаляє непідтримувані прапорці суворої схеми інструментів і ключі payload reasoning перед надсиланням нативних запитів xAI. - `web_search`, `x_search` і `code_execution` доступні як інструменти OpenClaw. - OpenClaw вмикає конкретний вбудований інструмент xAI, який потрібен, усередині кожного запиту інструмента, - замість того щоб прикріплювати всі нативні інструменти до кожного ходу чату. - - `x_search` і `code_execution` належать вбудованому Plugin xAI, а не - жорстко закодовані в основному середовищі виконання моделі. - - `code_execution` — це віддалене виконання в пісочниці xAI, а не локальний + OpenClaw вмикає конкретний вбудований інструмент xAI, який потрібен у кожному запиті інструмента, + замість того щоб додавати всі нативні інструменти до кожного ходу чату. + - `x_search` і `code_execution` належать вбудованому плагіну xAI, а не + жорстко закодовані в базове середовище виконання моделі. + - `code_execution` — це віддалене виконання в sandbox xAI, а не локальний [`exec`](/uk/tools/exec). -## Пов’язані матеріали +## Пов’язане Вибір провайдерів, посилань на моделі та поведінки резервного перемикання. - Спільні параметри інструмента відео та вибір провайдера. + Спільні параметри відеоінструмента та вибір провайдера. Ширший огляд провайдерів. - + Поширені проблеми та способи їх вирішення. diff --git a/docs/uk/providers/zai.md b/docs/uk/providers/zai.md index a87270846..4508ab71e 100644 --- a/docs/uk/providers/zai.md +++ b/docs/uk/providers/zai.md @@ -5,10 +5,10 @@ read_when: summary: Використовуйте Z.AI (моделі GLM) з OpenClaw title: Z.AI x-i18n: - generated_at: "2026-04-12T10:33:34Z" + generated_at: "2026-04-12T11:08:34Z" model: gpt-5.4 provider: openai - source_hash: eddb57770e6f1f9c72e62585d7d43a5e25f0d08f1b793f1ba5b0168c4c47f3cd + source_hash: 972b467dab141c8c5126ac776b7cb6b21815c27da511b3f34e12bd9e9ac953b7 source_path: providers/zai.md workflow: 15 --- @@ -21,7 +21,7 @@ Z.AI — це API-платформа для моделей **GLM**. Вона н - Провайдер: `zai` - Автентифікація: `ZAI_API_KEY` -- API: Z.AI Chat Completions (Bearer auth) +- API: Z.AI Chat Completions (Bearer-автентифікація) ## Початок роботи @@ -53,7 +53,7 @@ Z.AI — це API-платформа для моделей **GLM**. Вона н - **Найкраще для:** користувачів, які хочуть примусово вибрати певний Coding Plan або загальну поверхню API. + **Найкраще для:** користувачів, які хочуть примусово використовувати певний Coding Plan або загальний API-інтерфейс. @@ -91,23 +91,23 @@ Z.AI — це API-платформа для моделей **GLM**. Вона н ## Вбудований каталог GLM -OpenClaw наразі наповнює вбудованого провайдера `zai` такими моделями: +Наразі OpenClaw ініціалізує вбудованого провайдера `zai` такими моделями: -| Model ref | Примітки | -| -------------------- | -------------------- | +| Model ref | Примітки | +| -------------------- | ----------------- | | `zai/glm-5.1` | Модель за замовчуванням | -| `zai/glm-5` | | -| `zai/glm-5-turbo` | | -| `zai/glm-5v-turbo` | | -| `zai/glm-4.7` | | -| `zai/glm-4.7-flash` | | -| `zai/glm-4.7-flashx` | | -| `zai/glm-4.6` | | -| `zai/glm-4.6v` | | -| `zai/glm-4.5` | | -| `zai/glm-4.5-air` | | -| `zai/glm-4.5-flash` | | -| `zai/glm-4.5v` | | +| `zai/glm-5` | | +| `zai/glm-5-turbo` | | +| `zai/glm-5v-turbo` | | +| `zai/glm-4.7` | | +| `zai/glm-4.7-flash` | | +| `zai/glm-4.7-flashx` | | +| `zai/glm-4.6` | | +| `zai/glm-4.6v` | | +| `zai/glm-4.5` | | +| `zai/glm-4.5-air` | | +| `zai/glm-4.5-flash` | | +| `zai/glm-4.5v` | | Моделі GLM доступні як `zai/` (приклад: `zai/glm-5`). Вбудоване посилання на модель за замовчуванням — `zai/glm-5.1`. @@ -116,14 +116,14 @@ OpenClaw наразі наповнює вбудованого провайдер ## Розширена конфігурація - - Невідомі ідентифікатори `glm-5*` усе ще напряму резолюються через шлях вбудованого провайдера - шляхом синтезу метаданих, що належать провайдеру, із шаблону `glm-4.7`, коли ідентифікатор + + Невідомі ідентифікатори `glm-5*` усе ще попередньо розв’язуються через шлях вбудованого провайдера + шляхом синтезу метаданих, що належать провайдеру, з шаблону `glm-4.7`, коли ідентифікатор відповідає поточній формі сімейства GLM-5. - - `tool_stream` увімкнено за замовчуванням для потокового передавання викликів інструментів Z.AI. Щоб вимкнути це: + + `tool_stream` увімкнено за замовчуванням для потокової передачі викликів інструментів Z.AI. Щоб вимкнути її: ```json5 { @@ -141,10 +141,22 @@ OpenClaw наразі наповнює вбудованого провайдер + + Вбудований Plugin Z.AI реєструє функцію розуміння зображень. + + | Властивість | Значення | + | ----------- | ----------- | + | Модель | `glm-4.6v` | + + Розуміння зображень автоматично розв’язується з налаштованої автентифікації Z.AI — + додаткова конфігурація не потрібна. + + + - - Z.AI використовує Bearer auth з вашим API-ключем. + - Z.AI використовує Bearer-автентифікацію з вашим API-ключем. - Варіант онбордингу `zai-api-key` автоматично визначає відповідний endpoint Z.AI за префіксом ключа. - - Використовуйте явні регіональні варіанти (`zai-coding-global`, `zai-coding-cn`, `zai-global`, `zai-cn`), якщо хочете примусово вибрати певну поверхню API. + - Використовуйте явні регіональні варіанти (`zai-coding-global`, `zai-coding-cn`, `zai-global`, `zai-cn`), якщо хочете примусово використовувати певний API-інтерфейс.