From 7571582bfcc91d75321a9fa56f56e7a44cf20d8e Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sat, 25 Apr 2026 00:32:46 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/concepts/model-providers.md | 314 ++++++++++++++-------------- docs/uk/gateway/config-tools.md | 268 ++++++++++++------------ docs/uk/providers/minimax.md | 221 ++++++++++---------- 3 files changed, 400 insertions(+), 403 deletions(-) diff --git a/docs/uk/concepts/model-providers.md b/docs/uk/concepts/model-providers.md index 2da05c03e..0fb8df09a 100644 --- a/docs/uk/concepts/model-providers.md +++ b/docs/uk/concepts/model-providers.md @@ -1,84 +1,82 @@ --- read_when: - - Вам потрібен довідник із налаштування моделей для кожного постачальника окремо - - Ви хочете приклади конфігурацій або команд онбордингу CLI для постачальників моделей -summary: Огляд постачальників моделей із прикладами конфігурацій + потоками CLI + - Вам потрібен довідник з налаштування моделей для кожного постачальника окремо + - Вам потрібні приклади конфігурацій або команди онбордингу CLI для постачальників моделей +summary: Огляд постачальника моделей з прикладами конфігурацій + потоками CLI title: Постачальники моделей x-i18n: - generated_at: "2026-04-25T00:01:08Z" + generated_at: "2026-04-25T00:30:49Z" model: gpt-5.4 provider: openai - source_hash: 1c02aff44b00748bdcb5e4dc02c1725ae4c5d4b9fe3a9da523053a7e95a03f16 + source_hash: 009d57c8e26971357592f6fd57ad03f98f0325c410011649f002531ecb99aa06 source_path: concepts/model-providers.md workflow: 15 --- -Ця сторінка охоплює **постачальників LLM/моделей** (а не канали чату, як-от WhatsApp/Telegram). -Правила вибору моделей див. у [/concepts/models](/uk/concepts/models). +Ця сторінка охоплює **постачальників LLM/моделей** (а не канали чату на кшталт WhatsApp/Telegram). +Щоб дізнатися про правила вибору моделей, дивіться [/concepts/models](/uk/concepts/models). ## Швидкі правила - Посилання на моделі використовують `provider/model` (приклад: `opencode/claude-opus-4-6`). - `agents.defaults.models` працює як список дозволених значень, якщо його задано. -- Допоміжні CLI-команди: `openclaw onboard`, `openclaw models list`, `openclaw models set `. -- `models.providers.*.models[].contextWindow` — це вбудовані метадані моделі; `contextTokens` — це фактичне обмеження під час виконання. -- Правила резервного перемикання, cooldown-перевірки та збереження перевизначень сеансу див. у [Model failover](/uk/concepts/model-failover). -- Маршрути сімейства OpenAI залежать від префікса: `openai/` використовує прямого постачальника API-ключа OpenAI у PI, `openai-codex/` використовує Codex OAuth у PI, а `openai/` разом із `agents.defaults.embeddedHarness.runtime: "codex"` використовує нативний harness сервера застосунку Codex. Див. [OpenAI](/uk/providers/openai) і [Codex harness](/uk/plugins/codex-harness). -- Автоматичне ввімкнення Plugin дотримується тієї ж межі: `openai-codex/` належить Plugin OpenAI, тоді як Plugin Codex вмикається через `embeddedHarness.runtime: "codex"` або застарілі посилання `codex/`. -- CLI-середовища виконання використовують той самий поділ: вибирайте канонічні посилання на моделі, як-от `anthropic/claude-*`, `google/gemini-*` або `openai/gpt-*`, а потім задавайте `agents.defaults.embeddedHarness.runtime` як `claude-cli`, `google-gemini-cli` або `codex-cli`, якщо хочете локальний бекенд CLI. - Застарілі посилання `claude-cli/*`, `google-gemini-cli/*` і `codex-cli/*` мігрують назад до канонічних посилань постачальників, а середовище виконання записується окремо. -- GPT-5.5 наразі доступна через маршрути підписки/OAuth: - `openai-codex/gpt-5.5` у PI або `openai/gpt-5.5` із harness сервера застосунку Codex. Прямий маршрут API-ключа для `openai/gpt-5.5` підтримуватиметься, щойно OpenAI увімкне GPT-5.5 у публічному API; до того часу використовуйте моделі з доступом через API, наприклад `openai/gpt-5.4`, для налаштувань `OPENAI_API_KEY`. +- Допоміжні команди CLI: `openclaw onboard`, `openclaw models list`, `openclaw models set `. +- `models.providers.*.models[].contextWindow` — це власні метадані моделі; `contextTokens` — це фактичне обмеження під час виконання. +- Правила резервного перемикання, перевірки в період охолодження та збереження перевизначень сесії: [Перемикання моделей при збої](/uk/concepts/model-failover). +- Маршрути сімейства OpenAI залежать від префікса: `openai/` використовує постачальника з прямим API-ключем OpenAI у PI, `openai-codex/` використовує OAuth Codex у PI, а `openai/` разом із `agents.defaults.embeddedHarness.runtime: "codex"` використовує нативний app-server harness Codex. Дивіться [OpenAI](/uk/providers/openai) і [Codex harness](/uk/plugins/codex-harness). +- Автоматичне ввімкнення Plugin дотримується цієї ж межі: `openai-codex/` належить Plugin OpenAI, тоді як Plugin Codex вмикається через `embeddedHarness.runtime: "codex"` або застарілі посилання `codex/`. +- Середовища виконання CLI використовують той самий поділ: вибирайте канонічні посилання на моделі, такі як `anthropic/claude-*`, `google/gemini-*` або `openai/gpt-*`, а потім задавайте `agents.defaults.embeddedHarness.runtime` як `claude-cli`, `google-gemini-cli` або `codex-cli`, якщо потрібен локальний бекенд CLI. Застарілі посилання `claude-cli/*`, `google-gemini-cli/*` і `codex-cli/*` мігрують назад до канонічних посилань постачальника, а середовище виконання записується окремо. +- GPT-5.5 наразі доступна через маршрути підписки/OAuth: `openai-codex/gpt-5.5` у PI або `openai/gpt-5.5` з harness app-server Codex. Прямий маршрут з API-ключем для `openai/gpt-5.5` підтримуватиметься, щойно OpenAI увімкне GPT-5.5 у публічному API; до того часу для налаштувань `OPENAI_API_KEY` використовуйте моделі, доступні через API, наприклад `openai/gpt-5.4`. -## Поведінка постачальника, що належить Plugin +## Поведінка постачальника, якою володіє Plugin -Більшість специфічної для постачальника логіки живе в Plugin постачальників (`registerProvider(...)`), тоді як OpenClaw зберігає загальний цикл inference. Plugins відповідають за онбординг, каталоги моделей, зіставлення auth env-var, нормалізацію транспорту/конфігурації, очищення схем інструментів, класифікацію failover, оновлення OAuth, звітування про використання, профілі thinking/reasoning тощо. +Більшість логіки, специфічної для постачальника, живе в Plugin постачальників (`registerProvider(...)`), тоді як OpenClaw зберігає загальний цикл інференсу. Plugins відповідають за онбординг, каталоги моделей, зіставлення env vars для автентифікації, нормалізацію транспорту/конфігурації, очищення схем інструментів, класифікацію резервного перемикання при збої, оновлення OAuth, звітність про використання, профілі thinking/reasoning тощо. -Повний список хуків SDK постачальників і прикладів вбудованих Plugin наведено в [Provider plugins](/uk/plugins/sdk-provider-plugins). Постачальник, якому потрібен повністю кастомний виконавець запитів, — це окрема, глибша поверхня розширення. +Повний список хуків SDK постачальників і прикладів вбудованих Plugins наведено в [Provider plugins](/uk/plugins/sdk-provider-plugins). Постачальник, якому потрібен повністю кастомний виконавець запитів, — це окрема, глибша поверхня розширення. -`capabilities` середовища виконання постачальника — це спільні метадані раннера (сімейство постачальника, особливості transcript/tooling, підказки щодо transport/cache). Це не те саме, що [public capability model](/uk/plugins/architecture#public-capability-model), яка описує, що реєструє Plugin (текстовий inference, мовлення тощо). +`capabilities` середовища виконання постачальника — це спільні метадані раннера (сімейство постачальника, особливості транскриптів/інструментів, підказки щодо транспорту/кешу). Це не те саме, що [публічна модель можливостей](/uk/plugins/architecture#public-capability-model), яка описує, що реєструє Plugin (текстовий інференс, мовлення тощо). ## Ротація API-ключів -- Підтримує загальну ротацію постачальників для вибраних постачальників. +- Підтримується загальна ротація ключів постачальника для вибраних постачальників. - Налаштуйте кілька ключів через: - `OPENCLAW_LIVE__KEY` (одне live-перевизначення, найвищий пріоритет) - `_API_KEYS` (список через кому або крапку з комою) - `_API_KEY` (основний ключ) - `_API_KEY_*` (нумерований список, наприклад `_API_KEY_1`) -- Для постачальників Google `GOOGLE_API_KEY` також включається як резервний варіант. +- Для постачальників Google як резервний варіант також використовується `GOOGLE_API_KEY`. - Порядок вибору ключів зберігає пріоритет і прибирає дублікати значень. -- Запити повторюються з наступним ключем лише у відповідь на повідомлення про обмеження швидкості (наприклад `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many +- Запити повторюються з наступним ключем лише у відповідь на обмеження швидкості (наприклад, `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many concurrent requests`, `ThrottlingException`, `concurrency limit reached`, - `workers_ai ... quota limit exceeded` або періодичні повідомлення про ліміт використання). -- Помилки, не пов’язані з обмеженням швидкості, одразу завершуються з помилкою; ротація ключів не виконується. -- Якщо всі можливі ключі завершуються помилкою, повертається фінальна помилка з останньої спроби. + `workers_ai ... quota limit exceeded` або періодичні повідомлення про ліміти використання). +- Помилки, не пов’язані з обмеженням швидкості, одразу завершуються збоєм; ротація ключів не виконується. +- Якщо всі доступні ключі завершуються збоєм, повертається фінальна помилка з останньої спроби. ## Вбудовані постачальники (каталог pi-ai) -OpenClaw постачається з каталогом pi‑ai. Ці постачальники **не** -потребують конфігурації `models.providers`; достатньо налаштувати auth і вибрати модель. +OpenClaw постачається з каталогом pi‑ai. Для цих постачальників **не потрібна** +конфігурація `models.providers`; просто задайте автентифікацію та виберіть модель. ### OpenAI - Постачальник: `openai` -- Auth: `OPENAI_API_KEY` +- Автентифікація: `OPENAI_API_KEY` - Необов’язкова ротація: `OPENAI_API_KEYS`, `OPENAI_API_KEY_1`, `OPENAI_API_KEY_2`, а також `OPENCLAW_LIVE_OPENAI_KEY` (одне перевизначення) - Приклади моделей: `openai/gpt-5.4`, `openai/gpt-5.4-mini` -- Пряма підтримка API для GPT-5.5 тут підготовлена на майбутнє, щойно OpenAI відкриє GPT-5.5 в API +- Пряма підтримка API для GPT-5.5 тут готова на майбутнє, щойно OpenAI відкриє GPT-5.5 у API - CLI: `openclaw onboard --auth-choice openai-api-key` -- Типовий transport — `auto` (спочатку WebSocket, резервно SSE) +- Транспорт за замовчуванням — `auto` (спочатку WebSocket, резервно SSE) - Перевизначення для окремої моделі через `agents.defaults.models["openai/"].params.transport` (`"sse"`, `"websocket"` або `"auto"`) -- Розігрів OpenAI Responses WebSocket типово ввімкнений через `params.openaiWsWarmup` (`true`/`false`) +- Прогрівання WebSocket OpenAI Responses за замовчуванням увімкнене через `params.openaiWsWarmup` (`true`/`false`) - Пріоритетну обробку OpenAI можна ввімкнути через `agents.defaults.models["openai/"].params.serviceTier` -- `/fast` і `params.fastMode` напряму зіставляють запити `openai/*` Responses із `service_tier=priority` на `api.openai.com` +- `/fast` і `params.fastMode` напряму зіставляють запити Responses `openai/*` з `service_tier=priority` на `api.openai.com` - Використовуйте `params.serviceTier`, якщо вам потрібен явний рівень замість спільного перемикача `/fast` - Приховані заголовки атрибуції OpenClaw (`originator`, `version`, - `User-Agent`) застосовуються лише до нативного трафіку OpenAI на `api.openai.com`, а не до загальних OpenAI-сумісних проксі -- Нативні маршрути OpenAI також зберігають Responses `store`, підказки кешу prompt і формування payload для сумісності reasoning OpenAI; проксі-маршрути цього не роблять -- `openai/gpt-5.3-codex-spark` навмисно приглушено в OpenClaw, оскільки live-запити OpenAI API його відхиляють, а поточний каталог Codex його не надає + `User-Agent`) застосовуються лише до нативного трафіку OpenAI на `api.openai.com`, а не до загальних проксі, сумісних з OpenAI +- Нативні маршрути OpenAI також зберігають `store` Responses, підказки кешу prompt і формування payload для сумісності reasoning OpenAI; проксі-маршрути цього не роблять +- `openai/gpt-5.3-codex-spark` навмисно приховано в OpenClaw, оскільки live-запити до OpenAI API його відхиляють, а поточний каталог Codex його не показує ```json5 { @@ -89,13 +87,13 @@ OpenClaw постачається з каталогом pi‑ai. Ці поста ### Anthropic - Постачальник: `anthropic` -- Auth: `ANTHROPIC_API_KEY` +- Автентифікація: `ANTHROPIC_API_KEY` - Необов’язкова ротація: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2`, а також `OPENCLAW_LIVE_ANTHROPIC_KEY` (одне перевизначення) - Приклад моделі: `anthropic/claude-opus-4-6` - CLI: `openclaw onboard --auth-choice apiKey` -- Прямі публічні запити Anthropic підтримують спільний перемикач `/fast` і `params.fastMode`, включно з трафіком з API-ключем і OAuth-автентифікацією, надісланим на `api.anthropic.com`; OpenClaw зіставляє це з Anthropic `service_tier` (`auto` проти `standard_only`) +- Прямі публічні запити Anthropic також підтримують спільний перемикач `/fast` і `params.fastMode`, включно з трафіком, автентифікованим через API-ключ і OAuth, що надсилається на `api.anthropic.com`; OpenClaw зіставляє це з Anthropic `service_tier` (`auto` або `standard_only`) - Примітка щодо Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw знову дозволене, тому OpenClaw вважає повторне використання Claude CLI і використання `claude -p` санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику. -- Setup-token Anthropic залишається доступним як підтримуваний шлях токена OpenClaw, але тепер OpenClaw надає перевагу повторному використанню Claude CLI та `claude -p`, коли вони доступні. +- Токен налаштування Anthropic як і раніше доступний як підтримуваний шлях токена OpenClaw, але тепер OpenClaw надає перевагу повторному використанню Claude CLI та `claude -p`, якщо це можливо. ```json5 { @@ -103,24 +101,24 @@ OpenClaw постачається з каталогом pi‑ai. Ці поста } ``` -### OpenAI Codex OAuth +### OAuth OpenAI Codex - Постачальник: `openai-codex` -- Auth: OAuth (ChatGPT) +- Автентифікація: OAuth (ChatGPT) - Посилання на модель PI: `openai-codex/gpt-5.5` -- Посилання на нативний harness сервера застосунку Codex: `openai/gpt-5.5` з `agents.defaults.embeddedHarness.runtime: "codex"` +- Посилання нативного harness app-server Codex: `openai/gpt-5.5` з `agents.defaults.embeddedHarness.runtime: "codex"` - Застарілі посилання на моделі: `codex/gpt-*` -- Межа Plugin: `openai-codex/*` завантажує Plugin OpenAI; нативний Plugin сервера застосунку Codex вибирається лише через середовище виконання harness Codex або застарілі посилання `codex/*`. +- Межа Plugin: `openai-codex/*` завантажує Plugin OpenAI; нативний Plugin app-server Codex вибирається лише через середовище виконання harness Codex або застарілі посилання `codex/*`. - CLI: `openclaw onboard --auth-choice openai-codex` або `openclaw models auth login --provider openai-codex` -- Типовий transport — `auto` (спочатку WebSocket, резервно SSE) +- Транспорт за замовчуванням — `auto` (спочатку WebSocket, резервно SSE) - Перевизначення для окремої моделі PI через `agents.defaults.models["openai-codex/"].params.transport` (`"sse"`, `"websocket"` або `"auto"`) -- `params.serviceTier` також пересилається в нативних запитах Codex Responses (`chatgpt.com/backend-api`) +- `params.serviceTier` також передається в нативних запитах Codex Responses (`chatgpt.com/backend-api`) - Приховані заголовки атрибуції OpenClaw (`originator`, `version`, `User-Agent`) додаються лише до нативного трафіку Codex на - `chatgpt.com/backend-api`, а не до загальних OpenAI-сумісних проксі -- Використовує той самий перемикач `/fast` і конфігурацію `params.fastMode`, що й прямий `openai/*`; OpenClaw зіставляє це з `service_tier=priority` -- `openai-codex/gpt-5.5` зберігає нативні `contextWindow = 1000000` і типове runtime-значення `contextTokens = 272000`; перевизначте runtime-обмеження через `models.providers.openai-codex.models[].contextTokens` -- Примітка щодо політики: OpenAI Codex OAuth явно підтримується для зовнішніх інструментів/робочих процесів, таких як OpenClaw. + `chatgpt.com/backend-api`, а не до загальних проксі, сумісних з OpenAI +- Має той самий перемикач `/fast` і конфігурацію `params.fastMode`, що й прямий `openai/*`; OpenClaw зіставляє це з `service_tier=priority` +- `openai-codex/gpt-5.5` зберігає нативне `contextWindow = 1000000` і стандартне робоче `contextTokens = 272000`; перевизначте робоче обмеження через `models.providers.openai-codex.models[].contextTokens` +- Примітка щодо політики: OAuth OpenAI Codex явно підтримується для зовнішніх інструментів/процесів на кшталт OpenClaw. - Поточний доступ до GPT-5.5 використовує цей маршрут OAuth/підписки, доки OpenAI не ввімкне GPT-5.5 у публічному API. ```json5 @@ -141,15 +139,15 @@ OpenClaw постачається з каталогом pi‑ai. Ці поста } ``` -### Інші хостовані варіанти у стилі підписки +### Інші розміщені варіанти у стилі підписки - [Qwen Cloud](/uk/providers/qwen): поверхня постачальника Qwen Cloud, а також зіставлення кінцевих точок Alibaba DashScope і Coding Plan -- [MiniMax](/uk/providers/minimax): доступ до MiniMax Coding Plan через OAuth або API-ключ +- [MiniMax](/uk/providers/minimax): доступ через OAuth або API-ключ MiniMax Coding Plan - [GLM Models](/uk/providers/glm): кінцеві точки Z.AI Coding Plan або загального API ### OpenCode -- Auth: `OPENCODE_API_KEY` (або `OPENCODE_ZEN_API_KEY`) +- Автентифікація: `OPENCODE_API_KEY` (або `OPENCODE_ZEN_API_KEY`) - Постачальник середовища виконання Zen: `opencode` - Постачальник середовища виконання Go: `opencode-go` - Приклади моделей: `opencode/claude-opus-4-6`, `opencode-go/kimi-k2.5` @@ -164,44 +162,46 @@ OpenClaw постачається з каталогом pi‑ai. Ці поста ### Google Gemini (API-ключ) - Постачальник: `google` -- Auth: `GEMINI_API_KEY` -- Необов’язкова ротація: `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, резервний `GOOGLE_API_KEY` і `OPENCLAW_LIVE_GEMINI_KEY` (одне live-перевизначення) +- Автентифікація: `GEMINI_API_KEY` +- Необов’язкова ротація: `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, резервний варіант `GOOGLE_API_KEY` і `OPENCLAW_LIVE_GEMINI_KEY` (одне перевизначення) - Приклади моделей: `google/gemini-3.1-pro-preview`, `google/gemini-3-flash-preview` -- Сумісність: застаріла конфігурація OpenClaw із `google/gemini-3.1-flash-preview` нормалізується до `google/gemini-3-flash-preview` +- Сумісність: застаріла конфігурація OpenClaw з `google/gemini-3.1-flash-preview` нормалізується до `google/gemini-3-flash-preview` - CLI: `openclaw onboard --auth-choice gemini-api-key` - Прямі запуски Gemini також приймають `agents.defaults.models["google/"].params.cachedContent` - (або застаріле `cached_content`) для пересилання нативного - дескриптора постачальника `cachedContents/...`; попадання в кеш Gemini відображаються як OpenClaw `cacheRead` + (або застаріле `cached_content`) для передачі нативного дескриптора постачальника + `cachedContents/...`; влучання в кеш Gemini відображаються в OpenClaw як `cacheRead` ### Google Vertex і Gemini CLI - Постачальники: `google-vertex`, `google-gemini-cli` -- Auth: Vertex використовує gcloud ADC; Gemini CLI — свій потік OAuth -- Застереження: OAuth Gemini CLI в OpenClaw є неофіційною інтеграцією. Деякі користувачі повідомляли про обмеження облікового запису Google після використання сторонніх клієнтів. Ознайомтеся з умовами Google і використовуйте некритичний обліковий запис, якщо вирішите продовжити. +- Автентифікація: Vertex використовує gcloud ADC; Gemini CLI використовує власний потік OAuth +- Застереження: OAuth Gemini CLI в OpenClaw — це неофіційна інтеграція. Деякі користувачі повідомляли про обмеження облікового запису Google після використання сторонніх клієнтів. Ознайомтеся з умовами Google і використовуйте неважливий обліковий запис, якщо вирішите продовжити. - OAuth Gemini CLI постачається як частина вбудованого Plugin `google`. - Спочатку встановіть Gemini CLI: - `brew install gemini-cli` - або `npm install -g @google/gemini-cli` - - Увімкнення: `openclaw plugins enable google` - - Вхід: `openclaw models auth login --provider google-gemini-cli --set-default` - - Типова модель: `google-gemini-cli/gemini-3-flash-preview` - - Примітка: вам **не потрібно** вставляти client id або secret в `openclaw.json`. Потік входу CLI зберігає токени в auth-профілях на хості gateway. - - Якщо після входу запити завершуються помилкою, задайте `GOOGLE_CLOUD_PROJECT` або `GOOGLE_CLOUD_PROJECT_ID` на хості gateway. - - JSON-відповіді Gemini CLI розбираються з `response`; використання резервно береться зі `stats`, а `stats.cached` нормалізується до OpenClaw `cacheRead`. + - Увімкніть: `openclaw plugins enable google` + - Увійдіть: `openclaw models auth login --provider google-gemini-cli --set-default` + - Модель за замовчуванням: `google-gemini-cli/gemini-3-flash-preview` + - Примітка: ви **не** вставляєте client id або secret в `openclaw.json`. Потік входу CLI зберігає + токени в профілях автентифікації на хості Gateway. + - Якщо після входу запити завершуються збоєм, задайте `GOOGLE_CLOUD_PROJECT` або `GOOGLE_CLOUD_PROJECT_ID` на хості Gateway. + - JSON-відповіді Gemini CLI розбираються з `response`; використання резервно береться з + `stats`, а `stats.cached` нормалізується в OpenClaw як `cacheRead`. ### Z.AI (GLM) - Постачальник: `zai` -- Auth: `ZAI_API_KEY` +- Автентифікація: `ZAI_API_KEY` - Приклад моделі: `zai/glm-5.1` - CLI: `openclaw onboard --auth-choice zai-api-key` - - Аліаси: `z.ai/*` і `z-ai/*` нормалізуються до `zai/*` - - `zai-api-key` автоматично визначає відповідну кінцеву точку Z.AI; `zai-coding-global`, `zai-coding-cn`, `zai-global` і `zai-cn` примусово вибирають конкретну поверхню + - Псевдоніми: `z.ai/*` і `z-ai/*` нормалізуються до `zai/*` + - `zai-api-key` автоматично визначає відповідну кінцеву точку Z.AI; `zai-coding-global`, `zai-coding-cn`, `zai-global` і `zai-cn` примусово задають конкретну поверхню ### Vercel AI Gateway - Постачальник: `vercel-ai-gateway` -- Auth: `AI_GATEWAY_API_KEY` +- Автентифікація: `AI_GATEWAY_API_KEY` - Приклади моделей: `vercel-ai-gateway/anthropic/claude-opus-4.6`, `vercel-ai-gateway/moonshotai/kimi-k2.6` - CLI: `openclaw onboard --auth-choice ai-gateway-api-key` @@ -209,19 +209,19 @@ OpenClaw постачається з каталогом pi‑ai. Ці поста ### Kilo Gateway - Постачальник: `kilocode` -- Auth: `KILOCODE_API_KEY` +- Автентифікація: `KILOCODE_API_KEY` - Приклад моделі: `kilocode/kilo/auto` - CLI: `openclaw onboard --auth-choice kilocode-api-key` - Базовий URL: `https://api.kilo.ai/api/gateway/` - Статичний резервний каталог постачається з `kilocode/kilo/auto`; live-виявлення через `https://api.kilo.ai/api/gateway/models` може додатково розширити каталог середовища виконання. -- Точна маршрутизація вгору за потоком для `kilocode/kilo/auto` належить Kilo Gateway, +- Точна висхідна маршрутизація за `kilocode/kilo/auto` визначається Kilo Gateway, а не жорстко закодована в OpenClaw. -Деталі налаштування див. у [/providers/kilocode](/uk/providers/kilocode). +Дивіться [/providers/kilocode](/uk/providers/kilocode) для деталей налаштування. -### Інші вбудовані Plugin постачальників +### Інші вбудовані Plugins постачальників | Постачальник | Id | Auth env | Приклад моделі | | ----------------------- | -------------------------------- | ------------------------------------------------------------ | ---------------------------------------------- | @@ -249,35 +249,35 @@ OpenClaw постачається з каталогом pi‑ai. Ці поста | xAI | `xai` | `XAI_API_KEY` | `xai/grok-4` | | Xiaomi | `xiaomi` | `XIAOMI_API_KEY` | `xiaomi/mimo-v2-flash` | -Варто знати такі особливості: +Корисні особливості, які варто знати: -- **OpenRouter** застосовує свої заголовки атрибуції застосунку та маркери Anthropic `cache_control` лише на перевірених маршрутах `openrouter.ai`. Як проксі-подібний OpenAI-сумісний шлях, він пропускає формування, доступне лише для нативного OpenAI (`serviceTier`, Responses `store`, підказки кешу prompt, сумісність reasoning OpenAI). Посилання з бекендом Gemini зберігають лише санітизацію thought-signature для проксі-Gemini. -- **Kilo Gateway** для посилань із бекендом Gemini дотримується того самого шляху санітизації проксі-Gemini; `kilocode/kilo/auto` та інші посилання, що не підтримують proxy reasoning, пропускають ін’єкцію proxy reasoning. -- **MiniMax** онбординг через API-ключ записує явні визначення моделей M2.7 з `input: ["text", "image"]`; вбудований каталог зберігає chat-посилання лише текстовими, доки ця конфігурація не буде матеріалізована. -- **xAI** використовує шлях xAI Responses. `/fast` або `params.fastMode: true` переписує `grok-3`, `grok-3-mini`, `grok-4` і `grok-4-0709` на їхні варіанти `*-fast`. `tool_stream` типово ввімкнено; вимкнення через `agents.defaults.models["xai/"].params.tool_stream=false`. -- **Cerebras** моделі GLM використовують `zai-glm-4.7` / `zai-glm-4.6`; OpenAI-сумісний базовий URL — `https://api.cerebras.ai/v1`. +- **OpenRouter** застосовує свої заголовки атрибуції застосунку та маркери Anthropic `cache_control` лише на перевірених маршрутах `openrouter.ai`. Як проксі-шлях у стилі OpenAI, сумісний з OpenAI, він пропускає формування, притаманне лише нативному OpenAI (`serviceTier`, Responses `store`, підказки кешу prompt, сумісність reasoning OpenAI). Посилання, що працюють через Gemini, зберігають лише очищення thought-signature для проксі-Gemini. +- **Kilo Gateway** для посилань, що працюють через Gemini, дотримується того самого шляху очищення проксі-Gemini; `kilocode/kilo/auto` та інші посилання, де проксі-reasoning не підтримується, пропускають інʼєкцію proxy reasoning. +- **MiniMax** під час онбордингу через API-ключ записує явні визначення чат-моделей лише для тексту M2.7; розуміння зображень залишається на медіа-постачальнику `MiniMax-VL-01`, яким володіє Plugin. +- **xAI** використовує шлях xAI Responses. `/fast` або `params.fastMode: true` переписує `grok-3`, `grok-3-mini`, `grok-4` і `grok-4-0709` на їхні варіанти `*-fast`. `tool_stream` увімкнено за замовчуванням; вимкніть через `agents.defaults.models["xai/"].params.tool_stream=false`. +- **Cerebras** моделі GLM використовують `zai-glm-4.7` / `zai-glm-4.6`; базовий URL, сумісний з OpenAI, — `https://api.cerebras.ai/v1`. -## Постачальники через `models.providers` (власний/base URL) +## Постачальники через `models.providers` (custom/base URL) -Використовуйте `models.providers` (або `models.json`), щоб додати **власних** постачальників або -OpenAI/Anthropic‑сумісні проксі. +Використовуйте `models.providers` (або `models.json`), щоб додавати **custom** постачальників або +проксі, сумісні з OpenAI/Anthropic. -Багато з наведених нижче вбудованих Plugin постачальників уже публікують типовий каталог. -Використовуйте явні записи `models.providers.` лише тоді, коли хочете перевизначити -типовий base URL, заголовки або список моделей. +Багато з наведених нижче вбудованих Plugins постачальників уже публікують каталог за замовчуванням. +Використовуйте явні записи `models.providers.` лише тоді, коли потрібно перевизначити +базовий URL, заголовки або список моделей за замовчуванням. ### Moonshot AI (Kimi) -Moonshot постачається як вбудований Plugin постачальника. Типово використовуйте -вбудованого постачальника, а явний запис `models.providers.moonshot` додавайте лише тоді, коли -потрібно перевизначити base URL або метадані моделі: +Moonshot постачається як вбудований Plugin постачальника. Використовуйте вбудованого постачальника +за замовчуванням і додавайте явний запис `models.providers.moonshot` лише тоді, коли +потрібно перевизначити базовий URL або метадані моделі: - Постачальник: `moonshot` -- Auth: `MOONSHOT_API_KEY` +- Автентифікація: `MOONSHOT_API_KEY` - Приклад моделі: `moonshot/kimi-k2.6` - CLI: `openclaw onboard --auth-choice moonshot-api-key` або `openclaw onboard --auth-choice moonshot-api-key-cn` -Id моделей Kimi K2: +Ідентифікатори моделей Kimi K2: [//]: # "moonshot-kimi-k2-model-refs:start" @@ -313,7 +313,7 @@ Id моделей Kimi K2: Kimi Coding використовує Anthropic-сумісну кінцеву точку Moonshot AI: - Постачальник: `kimi` -- Auth: `KIMI_API_KEY` +- Автентифікація: `KIMI_API_KEY` - Приклад моделі: `kimi/kimi-code` ```json5 @@ -325,14 +325,14 @@ Kimi Coding використовує Anthropic-сумісну кінцеву т } ``` -Застарілий `kimi/k2p5` як і раніше приймається як id моделі для сумісності. +Застарілий `kimi/k2p5` і далі приймається як сумісний ідентифікатор моделі. ### Volcano Engine (Doubao) Volcano Engine (火山引擎) надає доступ до Doubao та інших моделей у Китаї. - Постачальник: `volcengine` (coding: `volcengine-plan`) -- Auth: `VOLCANO_ENGINE_API_KEY` +- Автентифікація: `VOLCANO_ENGINE_API_KEY` - Приклад моделі: `volcengine-plan/ark-code-latest` - CLI: `openclaw onboard --auth-choice volcengine-api-key` @@ -344,13 +344,13 @@ Volcano Engine (火山引擎) надає доступ до Doubao та інши } ``` -Онбординг типово використовує поверхню coding, але загальний каталог `volcengine/*` +Під час онбордингу за замовчуванням використовується поверхня coding, але загальний каталог `volcengine/*` реєструється одночасно. -У засобах вибору моделей onboarding/configure варіант auth для Volcengine надає перевагу рядкам -`volcengine/*` і `volcengine-plan/*`. Якщо ці моделі ще не завантажені, -OpenClaw повертається до нефільтрованого каталогу, а не показує порожній -засіб вибору в межах постачальника. +У пікерах вибору моделі для онбордингу/налаштування варіант автентифікації Volcengine надає перевагу рядкам +`volcengine/*` і `volcengine-plan/*`. Якщо ці моделі ще не завантажено, +OpenClaw повертається до нефільтрованого каталогу замість показу порожнього +пікера в межах постачальника. Доступні моделі: @@ -360,7 +360,7 @@ OpenClaw повертається до нефільтрованого катал - `volcengine/glm-4-7-251222` (GLM 4.7) - `volcengine/deepseek-v3-2-251201` (DeepSeek V3.2 128K) -Моделі coding (`volcengine-plan`): +Моделі для кодування (`volcengine-plan`): - `volcengine-plan/ark-code-latest` - `volcengine-plan/doubao-seed-code` @@ -373,7 +373,7 @@ OpenClaw повертається до нефільтрованого катал BytePlus ARK надає міжнародним користувачам доступ до тих самих моделей, що й Volcano Engine. - Постачальник: `byteplus` (coding: `byteplus-plan`) -- Auth: `BYTEPLUS_API_KEY` +- Автентифікація: `BYTEPLUS_API_KEY` - Приклад моделі: `byteplus-plan/ark-code-latest` - CLI: `openclaw onboard --auth-choice byteplus-api-key` @@ -385,13 +385,13 @@ BytePlus ARK надає міжнародним користувачам дост } ``` -Онбординг типово використовує поверхню coding, але загальний каталог `byteplus/*` +Під час онбордингу за замовчуванням використовується поверхня coding, але загальний каталог `byteplus/*` реєструється одночасно. -У засобах вибору моделей onboarding/configure варіант auth для BytePlus надає перевагу рядкам -`byteplus/*` і `byteplus-plan/*`. Якщо ці моделі ще не завантажені, -OpenClaw повертається до нефільтрованого каталогу, а не показує порожній -засіб вибору в межах постачальника. +У пікерах вибору моделі для онбордингу/налаштування варіант автентифікації BytePlus надає перевагу рядкам +`byteplus/*` і `byteplus-plan/*`. Якщо ці моделі ще не завантажено, +OpenClaw повертається до нефільтрованого каталогу замість показу порожнього +пікера в межах постачальника. Доступні моделі: @@ -399,7 +399,7 @@ OpenClaw повертається до нефільтрованого катал - `byteplus/kimi-k2-5-260127` (Kimi K2.5) - `byteplus/glm-4-7-251222` (GLM 4.7) -Моделі coding (`byteplus-plan`): +Моделі для кодування (`byteplus-plan`): - `byteplus-plan/ark-code-latest` - `byteplus-plan/doubao-seed-code` @@ -412,7 +412,7 @@ OpenClaw повертається до нефільтрованого катал Synthetic надає Anthropic-сумісні моделі через постачальника `synthetic`: - Постачальник: `synthetic` -- Auth: `SYNTHETIC_API_KEY` +- Автентифікація: `SYNTHETIC_API_KEY` - Приклад моделі: `synthetic/hf:MiniMaxAI/MiniMax-M2.5` - CLI: `openclaw onboard --auth-choice synthetic-api-key` @@ -437,26 +437,26 @@ Synthetic надає Anthropic-сумісні моделі через поста ### MiniMax -MiniMax налаштовується через `models.providers`, оскільки використовує власні кінцеві точки: +MiniMax налаштовується через `models.providers`, оскільки використовує custom кінцеві точки: -- MiniMax OAuth (Global): `--auth-choice minimax-global-oauth` -- MiniMax OAuth (CN): `--auth-choice minimax-cn-oauth` -- MiniMax API key (Global): `--auth-choice minimax-global-api` -- MiniMax API key (CN): `--auth-choice minimax-cn-api` -- Auth: `MINIMAX_API_KEY` для `minimax`; `MINIMAX_OAUTH_TOKEN` або +- OAuth MiniMax (Global): `--auth-choice minimax-global-oauth` +- OAuth MiniMax (CN): `--auth-choice minimax-cn-oauth` +- API-ключ MiniMax (Global): `--auth-choice minimax-global-api` +- API-ключ MiniMax (CN): `--auth-choice minimax-cn-api` +- Автентифікація: `MINIMAX_API_KEY` для `minimax`; `MINIMAX_OAUTH_TOKEN` або `MINIMAX_API_KEY` для `minimax-portal` -Деталі налаштування, варіанти моделей і фрагменти конфігурації див. у [/providers/minimax](/uk/providers/minimax). +Дивіться [/providers/minimax](/uk/providers/minimax) для деталей налаштування, варіантів моделей і фрагментів конфігурації. -У Anthropic-сумісному потоковому шляху MiniMax OpenClaw типово вимикає thinking, -якщо ви явно його не задасте, а `/fast on` переписує +На Anthropic-сумісному шляху потокової передачі MiniMax OpenClaw вимикає thinking +за замовчуванням, якщо ви явно його не задасте, а `/fast on` переписує `MiniMax-M2.7` на `MiniMax-M2.7-highspeed`. -Розділення можливостей, що належить Plugin: +Поділ можливостей, якими володіє Plugin: -- Типові значення text/chat залишаються на `minimax/MiniMax-M2.7` +- Текст/чат за замовчуванням залишаються на `minimax/MiniMax-M2.7` - Генерація зображень — це `minimax/image-01` або `minimax-portal/image-01` -- Розуміння зображень — це `MiniMax-VL-01`, що належить Plugin, на обох шляхах auth MiniMax +- Розуміння зображень — це `MiniMax-VL-01`, яким володіє Plugin, на обох шляхах автентифікації MiniMax - Вебпошук залишається на id постачальника `minimax` ### LM Studio @@ -464,10 +464,10 @@ MiniMax налаштовується через `models.providers`, оскіль LM Studio постачається як вбудований Plugin постачальника, який використовує нативний API: - Постачальник: `lmstudio` -- Auth: `LM_API_TOKEN` -- Типовий базовий URL inference: `http://localhost:1234/v1` +- Автентифікація: `LM_API_TOKEN` +- Базовий URL інференсу за замовчуванням: `http://localhost:1234/v1` -Потім задайте модель (замініть на один з id, повернутих `http://localhost:1234/api/v1/models`): +Потім задайте модель (замініть на один з ідентифікаторів, які повертає `http://localhost:1234/api/v1/models`): ```json5 { @@ -477,16 +477,16 @@ LM Studio постачається як вбудований Plugin постач } ``` -OpenClaw використовує нативні для LM Studio `/api/v1/models` і `/api/v1/models/load` -для виявлення й автозавантаження, а `/v1/chat/completions` типово — для inference. -Деталі налаштування та усунення несправностей див. у [/providers/lmstudio](/uk/providers/lmstudio). +OpenClaw використовує нативні `LM Studio` `/api/v1/models` і `/api/v1/models/load` +для виявлення й автозавантаження, а `/v1/chat/completions` — для інференсу за замовчуванням. +Дивіться [/providers/lmstudio](/uk/providers/lmstudio) для налаштування та усунення проблем. ### Ollama -Ollama постачається як вбудований Plugin постачальника й використовує нативний API Ollama: +Ollama постачається як вбудований Plugin постачальника та використовує нативний API Ollama: - Постачальник: `ollama` -- Auth: не потрібен (локальний сервер) +- Автентифікація: не потрібна (локальний сервер) - Приклад моделі: `ollama/llama3.3` - Встановлення: [https://ollama.com/download](https://ollama.com/download) @@ -503,27 +503,27 @@ ollama pull llama3.3 } ``` -Ollama виявляється локально за адресою `http://127.0.0.1:11434`, коли ви вмикаєте її через -`OLLAMA_API_KEY`, а вбудований Plugin постачальника додає Ollama безпосередньо до -`openclaw onboard` і засобу вибору моделі. Див. [/providers/ollama](/uk/providers/ollama) -щодо онбордингу, хмарного/локального режиму та власної конфігурації. +Ollama виявляється локально за адресою `http://127.0.0.1:11434`, якщо ви вмикаєте це через +`OLLAMA_API_KEY`, а вбудований Plugin постачальника додає Ollama безпосередньо в +`openclaw onboard` і пікер моделей. Дивіться [/providers/ollama](/uk/providers/ollama) +для онбордингу, хмарного/локального режиму та custom-конфігурації. ### vLLM -vLLM постачається як вбудований Plugin постачальника для локальних/self-hosted OpenAI-сумісних -серверів: +vLLM постачається як вбудований Plugin постачальника для локальних/самостійно розміщених +серверів, сумісних з OpenAI: - Постачальник: `vllm` -- Auth: необов’язковий (залежить від вашого сервера) -- Типовий базовий URL: `http://127.0.0.1:8000/v1` +- Автентифікація: необов’язкова (залежить від вашого сервера) +- Базовий URL за замовчуванням: `http://127.0.0.1:8000/v1` -Щоб увімкнути автовиявлення локально (підійде будь-яке значення, якщо ваш сервер не вимагає auth): +Щоб увімкнути автовиявлення локально (підійде будь-яке значення, якщо ваш сервер не вимагає автентифікації): ```bash export VLLM_API_KEY="vllm-local" ``` -Потім задайте модель (замініть на один з id, повернутих `/v1/models`): +Потім задайте модель (замініть на один з ідентифікаторів, які повертає `/v1/models`): ```json5 { @@ -533,25 +533,25 @@ export VLLM_API_KEY="vllm-local" } ``` -Деталі див. у [/providers/vllm](/uk/providers/vllm). +Дивіться [/providers/vllm](/uk/providers/vllm) для деталей. ### SGLang -SGLang постачається як вбудований Plugin постачальника для швидких self-hosted -OpenAI-сумісних серверів: +SGLang постачається як вбудований Plugin постачальника для швидких самостійно розміщених +серверів, сумісних з OpenAI: - Постачальник: `sglang` -- Auth: необов’язковий (залежить від вашого сервера) -- Типовий базовий URL: `http://127.0.0.1:30000/v1` +- Автентифікація: необов’язкова (залежить від вашого сервера) +- Базовий URL за замовчуванням: `http://127.0.0.1:30000/v1` Щоб увімкнути автовиявлення локально (підійде будь-яке значення, якщо ваш сервер не -вимагає auth): +вимагає автентифікації): ```bash export SGLANG_API_KEY="sglang-local" ``` -Потім задайте модель (замініть на один з id, повернутих `/v1/models`): +Потім задайте модель (замініть на один з ідентифікаторів, які повертає `/v1/models`): ```json5 { @@ -561,11 +561,11 @@ export SGLANG_API_KEY="sglang-local" } ``` -Деталі див. у [/providers/sglang](/uk/providers/sglang). +Дивіться [/providers/sglang](/uk/providers/sglang) для деталей. ### Локальні проксі (LM Studio, vLLM, LiteLLM тощо) -Приклад (OpenAI‑сумісний): +Приклад (сумісний з OpenAI): ```json5 { @@ -600,18 +600,18 @@ export SGLANG_API_KEY="sglang-local" Примітки: -- Для власних постачальників `reasoning`, `input`, `cost`, `contextWindow` і `maxTokens` необов’язкові. - Якщо їх не задано, OpenClaw типово використовує: +- Для custom-постачальників `reasoning`, `input`, `cost`, `contextWindow` і `maxTokens` є необов’язковими. + Якщо їх пропущено, OpenClaw використовує такі значення за замовчуванням: - `reasoning: false` - `input: ["text"]` - `cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }` - `contextWindow: 200000` - `maxTokens: 8192` - Рекомендовано: задавайте явні значення, що відповідають обмеженням вашого проксі/моделі. -- Для `api: "openai-completions"` на ненативних кінцевих точках (будь-який непорожній `baseUrl`, чий host не є `api.openai.com`) OpenClaw примусово встановлює `compat.supportsDeveloperRole: false`, щоб уникати помилок постачальника 400 для непідтримуваних ролей `developer`. -- Проксі-подібні OpenAI-сумісні маршрути також пропускають формування запитів, доступне лише для нативного OpenAI: без `service_tier`, без Responses `store`, без підказок кешу prompt, без формування payload для сумісності reasoning OpenAI та без прихованих заголовків атрибуції OpenClaw. -- Якщо `baseUrl` порожній/не заданий, OpenClaw зберігає типову поведінку OpenAI (яка веде до `api.openai.com`). -- Для безпеки явне `compat.supportsDeveloperRole: true` все одно перевизначається на ненативних кінцевих точках `openai-completions`. +- Для `api: "openai-completions"` на ненативних кінцевих точках (будь-який непорожній `baseUrl`, де хост не є `api.openai.com`) OpenClaw примусово встановлює `compat.supportsDeveloperRole: false`, щоб уникнути помилок 400 від постачальника для непідтримуваних ролей `developer`. +- Маршрути в стилі проксі, сумісні з OpenAI, також пропускають формування запитів, притаманне лише нативному OpenAI: без `service_tier`, без Responses `store`, без підказок кешу prompt, без формування payload для сумісності reasoning OpenAI і без прихованих заголовків атрибуції OpenClaw. +- Якщо `baseUrl` порожній/не заданий, OpenClaw зберігає стандартну поведінку OpenAI (яка розв’язується в `api.openai.com`). +- З міркувань безпеки явне `compat.supportsDeveloperRole: true` все одно перевизначається на ненативних кінцевих точках `openai-completions`. ## Приклади CLI @@ -621,11 +621,11 @@ openclaw models set opencode/claude-opus-4-6 openclaw models list ``` -Див. також: [/gateway/configuration](/uk/gateway/configuration) для повних прикладів конфігурації. +Дивіться також: [/gateway/configuration](/uk/gateway/configuration) для повних прикладів конфігурації. -## Пов’язане +## Пов’язані сторінки -- [Models](/uk/concepts/models) — конфігурація моделей і аліаси +- [Models](/uk/concepts/models) — конфігурація моделей і псевдоніми - [Model Failover](/uk/concepts/model-failover) — ланцюжки резервного перемикання та поведінка повторних спроб -- [Configuration Reference](/uk/gateway/config-agents#agent-defaults) — ключі конфігурації моделей -- [Providers](/uk/providers) — інструкції з налаштування для кожного постачальника +- [Configuration Reference](/uk/gateway/config-agents#agent-defaults) — ключі конфігурації моделі +- [Providers](/uk/providers) — посібники з налаштування для кожного постачальника diff --git a/docs/uk/gateway/config-tools.md b/docs/uk/gateway/config-tools.md index 4c69ef56e..8eb6df9e0 100644 --- a/docs/uk/gateway/config-tools.md +++ b/docs/uk/gateway/config-tools.md @@ -1,58 +1,58 @@ --- read_when: - - Налаштування policy, allowlist або експериментальних можливостей `tools.*` - - Реєстрація власних providers або перевизначення base URL - - Налаштування самостійно розміщених endpoint, сумісних з OpenAI -summary: Конфігурація Tools (policy, experimental toggles, provider-backed tools) і власне налаштування provider/base-URL -title: Конфігурація — Tools і власні providers + - Налаштування політики, списків дозволеного або експериментальних можливостей для `tools.*` + - Реєстрація користувацьких провайдерів або перевизначення базових URL-адрес + - Налаштування самостійно розміщених кінцевих точок, сумісних з OpenAI +summary: Конфігурація інструментів (політика, експериментальні перемикачі, інструменти на основі провайдерів) і налаштування користувацького провайдера/base-URL +title: Конфігурація — інструменти та користувацькі провайдери x-i18n: - generated_at: "2026-04-24T03:44:25Z" + generated_at: "2026-04-25T00:30:50Z" model: gpt-5.4 provider: openai - source_hash: 92535fb937f688c7cd39dcf5fc55f4663c8d234388a46611527efad4b7ee85eb + source_hash: a3a9ab07a5536196f3ba6c64111eb97206c3b4ff12e497564fe09684193e5c8a source_path: gateway/config-tools.md workflow: 15 --- -Ключі конфігурації `tools.*` і налаштування власних provider / base URL. Для агентів, -каналів та інших конфігурацій верхнього рівня див. -[Довідник конфігурації](/uk/gateway/configuration-reference). +Ключі конфігурації `tools.*` і налаштування користувацького провайдера / base-URL. Для агентів, +каналів та інших ключів конфігурації верхнього рівня див. +[Довідник із конфігурації](/uk/gateway/configuration-reference). -## Tools +## Інструменти ### Профілі інструментів -`tools.profile` задає базовий allowlist перед `tools.allow`/`tools.deny`: +`tools.profile` задає базовий список дозволеного перед `tools.allow`/`tools.deny`: -Локальний онбординг типово встановлює для нових локальних конфігурацій `tools.profile: "coding"`, якщо значення не задано (наявні явно вказані профілі зберігаються). +Локальне онбординг-налаштування за замовчуванням встановлює для нових локальних конфігурацій `tools.profile: "coding"`, якщо значення не задано (наявні явно вказані профілі зберігаються). -| Профіль | Містить | -| ----------- | -------------------------------------------------------------------------------------------------------------------------------- | -| `minimal` | лише `session_status` | +| Профіль | Містить | +| ----------- | ------------------------------------------------------------------------------------------------------------------------------ | +| `minimal` | лише `session_status` | | `coding` | `group:fs`, `group:runtime`, `group:web`, `group:sessions`, `group:memory`, `cron`, `image`, `image_generate`, `video_generate` | -| `messaging` | `group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status` | -| `full` | Без обмежень (так само, як і без значення) | +| `messaging` | `group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status` | +| `full` | Без обмежень (так само, як якщо не задано) | ### Групи інструментів -| Група | Інструменти | -| ------------------ | ----------------------------------------------------------------------------------------------------------------------- | -| `group:runtime` | `exec`, `process`, `code_execution` (`bash` приймається як псевдонім для `exec`) | -| `group:fs` | `read`, `write`, `edit`, `apply_patch` | +| Група | Інструменти | +| ------------------ | --------------------------------------------------------------------------------------------------------------------- | +| `group:runtime` | `exec`, `process`, `code_execution` (`bash` приймається як псевдонім для `exec`) | +| `group:fs` | `read`, `write`, `edit`, `apply_patch` | | `group:sessions` | `sessions_list`, `sessions_history`, `sessions_send`, `sessions_spawn`, `sessions_yield`, `subagents`, `session_status` | -| `group:memory` | `memory_search`, `memory_get` | -| `group:web` | `web_search`, `x_search`, `web_fetch` | -| `group:ui` | `browser`, `canvas` | -| `group:automation` | `cron`, `gateway` | -| `group:messaging` | `message` | -| `group:nodes` | `nodes` | -| `group:agents` | `agents_list` | -| `group:media` | `image`, `image_generate`, `video_generate`, `tts` | -| `group:openclaw` | Усі вбудовані інструменти (без provider Plugin) | +| `group:memory` | `memory_search`, `memory_get` | +| `group:web` | `web_search`, `x_search`, `web_fetch` | +| `group:ui` | `browser`, `canvas` | +| `group:automation` | `cron`, `gateway` | +| `group:messaging` | `message` | +| `group:nodes` | `nodes` | +| `group:agents` | `agents_list` | +| `group:media` | `image`, `image_generate`, `video_generate`, `tts` | +| `group:openclaw` | Усі вбудовані інструменти (не включає плагіни провайдерів) | ### `tools.allow` / `tools.deny` -Глобальна політика дозволу/заборони інструментів (заборона має пріоритет). Нечутлива до регістру, підтримує wildcard `*`. Застосовується навіть коли sandbox Docker вимкнено. +Глобальна політика дозволу/заборони інструментів (заборона має пріоритет). Без урахування регістру, підтримує шаблони `*`. Застосовується навіть коли пісочницю Docker вимкнено. ```json5 { @@ -62,7 +62,7 @@ x-i18n: ### `tools.byProvider` -Додатково обмежує інструменти для конкретних provider або моделей. Порядок: базовий профіль → профіль provider → allow/deny. +Додатково обмежує інструменти для конкретних провайдерів або моделей. Порядок: базовий профіль → профіль провайдера → allow/deny. ```json5 { @@ -78,7 +78,7 @@ x-i18n: ### `tools.elevated` -Керує elevated-доступом `exec` поза sandbox: +Керує розширеним доступом `exec` поза пісочницею: ```json5 { @@ -94,9 +94,9 @@ x-i18n: } ``` -- Перевизначення для окремого агента (`agents.list[].tools.elevated`) може лише додатково обмежувати. -- `/elevated on|off|ask|full` зберігає стан для кожної сесії; inline-директиви застосовуються лише до одного повідомлення. -- Elevated `exec` обходить sandbox і використовує налаштований шлях виходу (`gateway` типово, або `node`, коли ціллю exec є `node`). +- Перевизначення на рівні агента (`agents.list[].tools.elevated`) може лише додатково обмежувати. +- `/elevated on|off|ask|full` зберігає стан для кожної сесії; вбудовані директиви застосовуються до одного повідомлення. +- Розширений `exec` обходить пісочницю та використовує налаштований шлях виходу (`gateway` за замовчуванням або `node`, коли ціль `exec` — `node`). ### `tools.exec` @@ -120,8 +120,8 @@ x-i18n: ### `tools.loopDetection` -Перевірки безпеки від циклів інструментів **типово вимкнені**. Установіть `enabled: true`, щоб увімкнути виявлення. -Налаштування можна задати глобально в `tools.loopDetection` і перевизначити для окремого агента в `agents.list[].tools.loopDetection`. +Перевірки безпеки на цикли інструментів **вимкнені за замовчуванням**. Установіть `enabled: true`, щоб увімкнути виявлення. +Параметри можна задати глобально в `tools.loopDetection` і перевизначити для окремого агента в `agents.list[].tools.loopDetection`. ```json5 { @@ -145,9 +145,9 @@ x-i18n: - `historySize`: максимальна історія викликів інструментів, що зберігається для аналізу циклів. - `warningThreshold`: поріг повторюваного шаблону без прогресу для попереджень. - `criticalThreshold`: вищий поріг повторення для блокування критичних циклів. -- `globalCircuitBreakerThreshold`: жорсткий поріг зупинки для будь-якого запуску без прогресу. +- `globalCircuitBreakerThreshold`: жорсткий поріг зупинки для будь-якого виконання без прогресу. - `detectors.genericRepeat`: попереджати про повторні виклики того самого інструмента з тими самими аргументами. -- `detectors.knownPollNoProgress`: попереджати/блокувати відомі poll-інструменти (`process.poll`, `command_status` тощо). +- `detectors.knownPollNoProgress`: попереджати/блокувати відомі інструменти опитування (`process.poll`, `command_status` тощо) без прогресу. - `detectors.pingPong`: попереджати/блокувати шаблони чергування пар без прогресу. - Якщо `warningThreshold >= criticalThreshold` або `criticalThreshold >= globalCircuitBreakerThreshold`, перевірка не проходить. @@ -159,14 +159,14 @@ x-i18n: web: { search: { enabled: true, - apiKey: "brave_api_key", // or BRAVE_API_KEY env + apiKey: "brave_api_key", // або змінна середовища BRAVE_API_KEY maxResults: 5, timeoutSeconds: 30, cacheTtlMinutes: 15, }, fetch: { enabled: true, - provider: "firecrawl", // optional; omit for auto-detect + provider: "firecrawl", // необов’язково; пропустіть для автовизначення maxChars: 50000, maxCharsCap: 50000, maxResponseBytes: 2000000, @@ -183,7 +183,7 @@ x-i18n: ### `tools.media` -Налаштовує розуміння вхідних медіа (зображення/аудіо/відео): +Налаштовує розпізнавання вхідних медіа (зображення/аудіо/відео): ```json5 { @@ -191,7 +191,7 @@ x-i18n: media: { concurrency: 2, asyncCompletion: { - directSend: false, // opt-in: send finished async music/video directly to the channel + directSend: false, // опціонально: надсилати завершені асинхронні музичні/відео результати безпосередньо в канал }, audio: { enabled: true, @@ -217,30 +217,30 @@ x-i18n: -**Запис provider** (`type: "provider"` або без вказання): +**Запис провайдера** (`type: "provider"` або пропущено): -- `provider`: id API provider (`openai`, `anthropic`, `google`/`gemini`, `groq` тощо) -- `model`: перевизначення id моделі +- `provider`: ідентифікатор API-провайдера (`openai`, `anthropic`, `google`/`gemini`, `groq` тощо) +- `model`: перевизначення ідентифікатора моделі - `profile` / `preferredProfile`: вибір профілю з `auth-profiles.json` -**Запис CLI** (`type: "cli"`): +**CLI-запис** (`type: "cli"`): - `command`: виконуваний файл для запуску -- `args`: шаблонізовані аргументи (підтримуються `{{MediaPath}}`, `{{Prompt}}`, `{{MaxChars}}` тощо) +- `args`: шаблонізовані аргументи (підтримує `{{MediaPath}}`, `{{Prompt}}`, `{{MaxChars}}` тощо) **Спільні поля:** -- `capabilities`: необов’язковий список (`image`, `audio`, `video`). Типові значення: `openai`/`anthropic`/`minimax` → image, `google` → image+audio+video, `groq` → audio. +- `capabilities`: необов’язковий список (`image`, `audio`, `video`). Значення за замовчуванням: `openai`/`anthropic`/`minimax` → image, `google` → image+audio+video, `groq` → audio. - `prompt`, `maxChars`, `maxBytes`, `timeoutSeconds`, `language`: перевизначення для окремого запису. - У разі помилки використовується наступний запис. -Автентифікація provider дотримується стандартного порядку: `auth-profiles.json` → змінні середовища → `models.providers.*.apiKey`. +Автентифікація провайдера виконується у стандартному порядку: `auth-profiles.json` → змінні середовища → `models.providers.*.apiKey`. **Поля асинхронного завершення:** - `asyncCompletion.directSend`: коли `true`, завершені асинхронні завдання `music_generate` - і `video_generate` спочатку намагаються доставлятися безпосередньо в канал. Типове значення: `false` - (застарілий шлях requester-session wake/model-delivery). + і `video_generate` спочатку намагаються доставити результат безпосередньо в канал. За замовчуванням: `false` + (застарілий шлях пробудження сесії запитувача/доставки моделлю). @@ -259,9 +259,9 @@ x-i18n: ### `tools.sessions` -Керує тим, на які сесії можуть бути націлені session tools (`sessions_list`, `sessions_history`, `sessions_send`). +Керує тим, які сесії можуть бути ціллю для інструментів сесій (`sessions_list`, `sessions_history`, `sessions_send`). -Типове значення: `tree` (поточна сесія + сесії, створені нею, наприклад субагенти). +За замовчуванням: `tree` (поточна сесія + сесії, породжені нею, наприклад субагенти). ```json5 { @@ -277,25 +277,25 @@ x-i18n: Примітки: - `self`: лише ключ поточної сесії. -- `tree`: поточна сесія + сесії, створені поточною сесією (субагенти). -- `agent`: будь-яка сесія, що належить поточному id агента (може включати інших користувачів, якщо ви запускаєте окремі сесії для відправників під тим самим id агента). -- `all`: будь-яка сесія. Націлення між агентами все одно потребує `tools.agentToAgent`. -- Обмеження sandbox: коли поточна сесія працює в sandbox і `agents.defaults.sandbox.sessionToolsVisibility="spawned"`, видимість примусово встановлюється на `tree`, навіть якщо `tools.sessions.visibility="all"`. +- `tree`: поточна сесія + сесії, породжені поточною сесією (субагенти). +- `agent`: будь-яка сесія, що належить поточному ідентифікатору агента (може включати інших користувачів, якщо ви запускаєте сесії для кожного відправника під тим самим ідентифікатором агента). +- `all`: будь-яка сесія. Націлювання між агентами все одно вимагає `tools.agentToAgent`. +- Обмеження пісочниці: коли поточна сесія працює в пісочниці і `agents.defaults.sandbox.sessionToolsVisibility="spawned"`, видимість примусово встановлюється в `tree`, навіть якщо `tools.sessions.visibility="all"`. ### `tools.sessions_spawn` -Керує підтримкою inline-вкладень для `sessions_spawn`. +Керує підтримкою вбудованих вкладень для `sessions_spawn`. ```json5 { tools: { sessions_spawn: { attachments: { - enabled: false, // opt-in: set true to allow inline file attachments - maxTotalBytes: 5242880, // 5 MB total across all files + enabled: false, // опціонально: установіть true, щоб дозволити вбудовані файлові вкладення + maxTotalBytes: 5242880, // загалом 5 МБ для всіх файлів maxFiles: 50, - maxFileBytes: 1048576, // 1 MB per file - retainOnSessionKeep: false, // keep attachments when cleanup="keep" + maxFileBytes: 1048576, // 1 МБ на файл + retainOnSessionKeep: false, // зберігати вкладення, коли cleanup="keep" }, }, }, @@ -304,10 +304,10 @@ x-i18n: Примітки: -- Вкладення підтримуються лише для `runtime: "subagent"`. Runtime ACP їх відхиляє. -- Файли матеріалізуються в дочірньому робочому просторі в `.openclaw/attachments//` разом із `.manifest.json`. +- Вкладення підтримуються лише для `runtime: "subagent"`. Середовище ACP їх відхиляє. +- Файли матеріалізуються в робочому просторі дочірньої сесії в `.openclaw/attachments//` разом із `.manifest.json`. - Вміст вкладень автоматично редагується під час збереження транскрипту. -- Входи Base64 перевіряються за допомогою суворої перевірки алфавіту/вирівнювання та захисту розміру до декодування. +- Входи base64 перевіряються суворою перевіркою алфавіту/доповнення та захистом розміру до декодування. - Права доступу до файлів: `0700` для каталогів і `0600` для файлів. - Очищення виконується згідно з політикою `cleanup`: `delete` завжди видаляє вкладення; `keep` зберігає їх лише коли `retainOnSessionKeep: true`. @@ -315,13 +315,13 @@ x-i18n: ### `tools.experimental` -Експериментальні прапорці вбудованих інструментів. Типово вимкнено, якщо не застосовується правило автоувімкнення strict-agentic GPT-5. +Прапорці експериментальних вбудованих інструментів. За замовчуванням вимкнено, якщо не застосовується правило автоувімкнення strict-agentic GPT-5. ```json5 { tools: { experimental: { - planTool: true, // enable experimental update_plan + planTool: true, // увімкнути експериментальний update_plan }, }, } @@ -330,8 +330,8 @@ x-i18n: Примітки: - `planTool`: вмикає структурований інструмент `update_plan` для відстеження нетривіальної багатокрокової роботи. -- Типове значення: `false`, якщо тільки `agents.defaults.embeddedPi.executionContract` (або перевизначення для окремого агента) не встановлено в `"strict-agentic"` для запуску OpenAI або OpenAI Codex сімейства GPT-5. Установіть `true`, щоб примусово ввімкнути інструмент поза цією областю, або `false`, щоб залишити його вимкненим навіть для запусків strict-agentic GPT-5. -- Коли інструмент увімкнено, system prompt також додає вказівки щодо використання, щоб модель застосовувала його лише для суттєвої роботи й підтримувала не більше одного кроку `in_progress`. +- За замовчуванням: `false`, якщо тільки `agents.defaults.embeddedPi.executionContract` (або перевизначення для окремого агента) не встановлено в `"strict-agentic"` для запуску OpenAI або OpenAI Codex сімейства GPT-5. Установіть `true`, щоб примусово ввімкнути інструмент поза цією областю, або `false`, щоб залишити його вимкненим навіть для запусків strict-agentic GPT-5. +- Коли інструмент увімкнено, системний промпт також додає вказівки з використання, щоб модель застосовувала його лише для суттєвої роботи та підтримувала не більше одного кроку `in_progress`. ### `agents.defaults.subagents` @@ -351,21 +351,21 @@ x-i18n: } ``` -- `model`: типова модель для створених субагентів. Якщо не вказано, субагенти успадковують модель викликувача. -- `allowAgents`: типовий allowlist цільових id агентів для `sessions_spawn`, коли агент-запитувач не задає власний `subagents.allowAgents` (`["*"]` = будь-який; типово: лише той самий агент). -- `runTimeoutSeconds`: типовий тайм-аут (у секундах) для `sessions_spawn`, коли виклик інструмента не вказує `runTimeoutSeconds`. `0` означає відсутність тайм-ауту. -- Політика інструментів для субагентів: `tools.subagents.tools.allow` / `tools.subagents.tools.deny`. +- `model`: модель за замовчуванням для породжених субагентів. Якщо не вказано, субагенти успадковують модель викликача. +- `allowAgents`: список дозволених ідентифікаторів цільових агентів за замовчуванням для `sessions_spawn`, коли агент-запитувач не задає власний `subagents.allowAgents` (`["*"]` = будь-який; за замовчуванням: лише той самий агент). +- `runTimeoutSeconds`: тайм-аут за замовчуванням (у секундах) для `sessions_spawn`, коли виклик інструмента не містить `runTimeoutSeconds`. `0` означає відсутність тайм-ауту. +- Політика інструментів для кожного субагента: `tools.subagents.tools.allow` / `tools.subagents.tools.deny`. --- -## Власні providers і base URL +## Користувацькі провайдери та base URL -OpenClaw використовує вбудований каталог моделей. Додавайте власні providers через `models.providers` у конфігурації або `~/.openclaw/agents//agent/models.json`. +OpenClaw використовує вбудований каталог моделей. Додавайте користувацьких провайдерів через `models.providers` у конфігурації або `~/.openclaw/agents//agent/models.json`. ```json5 { models: { - mode: "merge", // merge (default) | replace + mode: "merge", // merge (за замовчуванням) | replace providers: { "custom-proxy": { baseUrl: "http://localhost:4000/v1", @@ -389,51 +389,51 @@ OpenClaw використовує вбудований каталог модел } ``` -- Використовуйте `authHeader: true` + `headers` для власних потреб автентифікації. -- Перевизначайте корінь конфігурації агента через `OPENCLAW_AGENT_DIR` (або `PI_CODING_AGENT_DIR`, застарілий псевдонім змінної середовища). -- Пріоритет злиття для provider ID, що збігаються: +- Використовуйте `authHeader: true` + `headers` для нестандартних потреб автентифікації. +- Перевизначайте кореневий каталог конфігурації агента через `OPENCLAW_AGENT_DIR` (або `PI_CODING_AGENT_DIR`, застарілий псевдонім змінної середовища). +- Пріоритет злиття для однакових ідентифікаторів провайдерів: - Непорожні значення `baseUrl` з агентського `models.json` мають пріоритет. - - Непорожні значення `apiKey` з агента мають пріоритет лише тоді, коли цей provider не керується через SecretRef у поточному контексті config/auth-profile. - - Значення `apiKey` для provider, керованих через SecretRef, оновлюються з маркерів джерела (`ENV_VAR_NAME` для env-посилань, `secretref-managed` для file/exec-посилань) замість збереження розв’язаних секретів. - - Значення заголовків для provider, керованих через SecretRef, оновлюються з маркерів джерела (`secretref-env:ENV_VAR_NAME` для env-посилань, `secretref-managed` для file/exec-посилань). - - Порожні або відсутні агентські `apiKey`/`baseUrl` беруться з `models.providers` у конфігурації. - - Для моделей, що збігаються, `contextWindow`/`maxTokens` використовують більше значення між явною конфігурацією та неявними значеннями каталогу. - - Для моделей, що збігаються, `contextTokens` зберігає явне обмеження runtime, якщо воно задане; використовуйте це, щоб обмежити ефективний контекст без зміни рідних метаданих моделі. - - Використовуйте `models.mode: "replace"`, коли хочете, щоб конфігурація повністю переписала `models.json`. - - Збереження маркерів є джерельно-авторитетним: маркери записуються з активного знімка конфігурації джерела (до розв’язання), а не з розв’язаних значень секретів runtime. + - Непорожні значення `apiKey` з агента мають пріоритет лише тоді, коли цей провайдер не керується через SecretRef у поточному контексті конфігурації/профілю автентифікації. + - Значення `apiKey` для провайдерів, керованих SecretRef, оновлюються з маркерів джерела (`ENV_VAR_NAME` для посилань на змінні середовища, `secretref-managed` для посилань file/exec) замість збереження розкритих секретів. + - Значення заголовків провайдера, керованих SecretRef, оновлюються з маркерів джерела (`secretref-env:ENV_VAR_NAME` для посилань на змінні середовища, `secretref-managed` для посилань file/exec). + - Порожні або відсутні `apiKey`/`baseUrl` в агенті беруться з `models.providers` у конфігурації. + - Для однакових моделей `contextWindow`/`maxTokens` використовують вище значення між явною конфігурацією та неявними значеннями каталогу. + - Для однакових моделей `contextTokens` зберігає явне обмеження середовища виконання, якщо воно задане; використовуйте це, щоб обмежити ефективний контекст без зміни власних метаданих моделі. + - Використовуйте `models.mode: "replace"`, якщо хочете, щоб конфігурація повністю переписала `models.json`. + - Збереження маркерів є авторитетним щодо джерела: маркери записуються з активного знімка вихідної конфігурації (до розкриття), а не з розкритих значень секретів середовища виконання. -### Докладніше про поля provider +### Докладно про поля провайдера -- `models.mode`: поведінка каталогу provider (`merge` або `replace`). -- `models.providers`: мапа власних providers із ключем за id provider. - - Безпечні редагування: використовуйте `openclaw config set models.providers. '' --strict-json --merge` або `openclaw config set models.providers..models '' --strict-json --merge` для додаткових оновлень. `config set` відмовляється від руйнівних замін, якщо ви не передасте `--replace`. +- `models.mode`: поведінка каталогу провайдерів (`merge` або `replace`). +- `models.providers`: мапа користувацьких провайдерів, ключована ідентифікатором провайдера. + - Безпечне редагування: використовуйте `openclaw config set models.providers. '' --strict-json --merge` або `openclaw config set models.providers..models '' --strict-json --merge` для додаткових оновлень. `config set` відмовляється від руйнівних замін, якщо не передати `--replace`. - `models.providers.*.api`: адаптер запитів (`openai-completions`, `openai-responses`, `anthropic-messages`, `google-generative-ai` тощо). -- `models.providers.*.apiKey`: облікові дані provider (краще через SecretRef/env-підстановку). +- `models.providers.*.apiKey`: облікові дані провайдера (бажано SecretRef/підстановка змінних середовища). - `models.providers.*.auth`: стратегія автентифікації (`api-key`, `token`, `oauth`, `aws-sdk`). -- `models.providers.*.injectNumCtxForOpenAICompat`: для Ollama + `openai-completions` вставляє `options.num_ctx` у запити (типово: `true`). -- `models.providers.*.authHeader`: примусово передає облікові дані в заголовку `Authorization`, коли це потрібно. -- `models.providers.*.baseUrl`: базовий URL висхідного API. -- `models.providers.*.headers`: додаткові статичні заголовки для маршрутизації через proxy/tenant. -- `models.providers.*.request`: перевизначення транспорту для HTTP-запитів model-provider. - - `request.headers`: додаткові заголовки (зливаються з типовими для provider). Значення приймають SecretRef. - - `request.auth`: перевизначення стратегії автентифікації. Режими: `"provider-default"` (використовувати вбудовану автентифікацію provider), `"authorization-bearer"` (з `token`), `"header"` (з `headerName`, `value`, необов’язковим `prefix`). - - `request.proxy`: перевизначення HTTP proxy. Режими: `"env-proxy"` (використовувати змінні середовища `HTTP_PROXY`/`HTTPS_PROXY`), `"explicit-proxy"` (з `url`). Обидва режими приймають необов’язковий підоб’єкт `tls`. - - `request.tls`: перевизначення TLS для прямих з’єднань. Поля: `ca`, `cert`, `key`, `passphrase` (усі приймають SecretRef), `serverName`, `insecureSkipVerify`. - - `request.allowPrivateNetwork`: коли `true`, дозволяє HTTPS до `baseUrl`, якщо DNS розв’язується в private, CGNAT або подібні діапазони, через захист HTTP fetch provider від SSRF (явне ввімкнення оператором для довірених самостійно розміщених endpoint, сумісних з OpenAI). WebSocket використовує той самий `request` для заголовків/TLS, але не цей SSRF-захист fetch. Типове значення `false`. -- `models.providers.*.models`: явні записи каталогу моделей provider. -- `models.providers.*.models.*.contextWindow`: метадані рідного вікна контексту моделі. -- `models.providers.*.models.*.contextTokens`: необов’язкове обмеження контексту runtime. Використовуйте це, якщо хочете менший ефективний бюджет контексту, ніж рідний `contextWindow` моделі. -- `models.providers.*.models.*.compat.supportsDeveloperRole`: необов’язкова підказка сумісності. Для `api: "openai-completions"` з непорожнім нерідним `baseUrl` (хост не `api.openai.com`) OpenClaw примусово встановлює це в `false` під час runtime. Порожній/відсутній `baseUrl` зберігає типову поведінку OpenAI. -- `models.providers.*.models.*.compat.requiresStringContent`: необов’язкова підказка сумісності для OpenAI-сумісних chat endpoint, які приймають лише рядки. Коли `true`, OpenClaw перетворює масиви `messages[].content`, що містять лише текст, у звичайні рядки перед надсиланням запиту. +- `models.providers.*.injectNumCtxForOpenAICompat`: для Ollama + `openai-completions` додавати `options.num_ctx` у запити (за замовчуванням: `true`). +- `models.providers.*.authHeader`: примусово передавати облікові дані в заголовку `Authorization`, коли це потрібно. +- `models.providers.*.baseUrl`: базова URL-адреса висхідного API. +- `models.providers.*.headers`: додаткові статичні заголовки для маршрутизації через проксі/орендаря. +- `models.providers.*.request`: перевизначення транспорту для HTTP-запитів до провайдера моделі. + - `request.headers`: додаткові заголовки (об’єднуються зі значеннями провайдера за замовчуванням). Значення підтримують SecretRef. + - `request.auth`: перевизначення стратегії автентифікації. Режими: `"provider-default"` (використовувати вбудовану автентифікацію провайдера), `"authorization-bearer"` (з `token`), `"header"` (з `headerName`, `value`, необов’язковим `prefix`). + - `request.proxy`: перевизначення HTTP-проксі. Режими: `"env-proxy"` (використовувати змінні середовища `HTTP_PROXY`/`HTTPS_PROXY`), `"explicit-proxy"` (з `url`). Обидва режими підтримують необов’язковий підоб’єкт `tls`. + - `request.tls`: перевизначення TLS для прямих з’єднань. Поля: `ca`, `cert`, `key`, `passphrase` (усі підтримують SecretRef), `serverName`, `insecureSkipVerify`. + - `request.allowPrivateNetwork`: коли `true`, дозволяє HTTPS до `baseUrl`, якщо DNS розв’язується у приватні, CGNAT або подібні діапазони, через захист HTTP fetch провайдера (явне ввімкнення оператором для довірених самостійно розміщених OpenAI-сумісних кінцевих точок). WebSocket використовує той самий `request` для заголовків/TLS, але не цей SSRF-запобіжник fetch. За замовчуванням `false`. +- `models.providers.*.models`: явні записи каталогу моделей провайдера. +- `models.providers.*.models.*.contextWindow`: метадані власного вікна контексту моделі. +- `models.providers.*.models.*.contextTokens`: необов’язкове обмеження контексту середовища виконання. Використовуйте це, коли хочете менший ефективний бюджет контексту, ніж власний `contextWindow` моделі. +- `models.providers.*.models.*.compat.supportsDeveloperRole`: необов’язкова підказка сумісності. Для `api: "openai-completions"` із непорожнім не-власним `baseUrl` (хост не `api.openai.com`) OpenClaw примусово встановлює це значення в `false` під час виконання. Порожній/відсутній `baseUrl` зберігає стандартну поведінку OpenAI. +- `models.providers.*.models.*.compat.requiresStringContent`: необов’язкова підказка сумісності для OpenAI-сумісних chat-кінцевих точок, що приймають лише рядки. Коли `true`, OpenClaw сплющує масиви `messages[].content`, які містять лише текст, у звичайні рядки перед надсиланням запиту. - `plugins.entries.amazon-bedrock.config.discovery`: корінь налаштувань авто-виявлення Bedrock. - `plugins.entries.amazon-bedrock.config.discovery.enabled`: увімкнути/вимкнути неявне виявлення. - `plugins.entries.amazon-bedrock.config.discovery.region`: регіон AWS для виявлення. -- `plugins.entries.amazon-bedrock.config.discovery.providerFilter`: необов’язковий фільтр id provider для цільового виявлення. +- `plugins.entries.amazon-bedrock.config.discovery.providerFilter`: необов’язковий фільтр ідентифікатора провайдера для цільового виявлення. - `plugins.entries.amazon-bedrock.config.discovery.refreshInterval`: інтервал опитування для оновлення виявлення. - `plugins.entries.amazon-bedrock.config.discovery.defaultContextWindow`: резервне вікно контексту для виявлених моделей. -- `plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens`: резервна максимальна кількість вихідних токенів для виявлених моделей. +- `plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens`: резервна максимальна кількість токенів виводу для виявлених моделей. -### Приклади provider +### Приклади провайдерів @@ -486,7 +486,7 @@ OpenClaw використовує вбудований каталог модел } ``` -Установіть `OPENCODE_API_KEY` (або `OPENCODE_ZEN_API_KEY`). Використовуйте посилання `opencode/...` для каталогу Zen або `opencode-go/...` для каталогу Go. Скорочення: `openclaw onboard --auth-choice opencode-zen` або `openclaw onboard --auth-choice opencode-go`. +Установіть `OPENCODE_API_KEY` (або `OPENCODE_ZEN_API_KEY`). Використовуйте посилання `opencode/...` для каталогу Zen або посилання `opencode-go/...` для каталогу Go. Скорочений варіант: `openclaw onboard --auth-choice opencode-zen` або `openclaw onboard --auth-choice opencode-go`. @@ -503,11 +503,11 @@ OpenClaw використовує вбудований каталог модел } ``` -Установіть `ZAI_API_KEY`. `z.ai/*` і `z-ai/*` — допустимі псевдоніми. Скорочення: `openclaw onboard --auth-choice zai-api-key`. +Установіть `ZAI_API_KEY`. `z.ai/*` і `z-ai/*` — допустимі псевдоніми. Скорочений варіант: `openclaw onboard --auth-choice zai-api-key`. -- Загальний endpoint: `https://api.z.ai/api/paas/v4` -- Endpoint для кодування (типовий): `https://api.z.ai/api/coding/paas/v4` -- Для загального endpoint визначте власний provider із перевизначенням base URL. +- Загальна кінцева точка: `https://api.z.ai/api/paas/v4` +- Кінцева точка для кодування (за замовчуванням): `https://api.z.ai/api/coding/paas/v4` +- Для загальної кінцевої точки визначте користувацького провайдера з перевизначенням base URL. @@ -546,11 +546,11 @@ OpenClaw використовує вбудований каталог модел } ``` -Для endpoint у Китаї: `baseUrl: "https://api.moonshot.cn/v1"` або `openclaw onboard --auth-choice moonshot-api-key-cn`. +Для кінцевої точки в Китаї: `baseUrl: "https://api.moonshot.cn/v1"` або `openclaw onboard --auth-choice moonshot-api-key-cn`. -Рідні endpoint Moonshot рекламують сумісність streaming usage на спільному -транспорті `openai-completions`, і OpenClaw визначає це за можливостями endpoint, -а не лише за id вбудованого provider. +Власні кінцеві точки Moonshot оголошують сумісність потокового використання на спільному +транспорті `openai-completions`, і OpenClaw визначає це за можливостями кінцевої точки, +а не лише за ідентифікатором вбудованого провайдера. @@ -568,7 +568,7 @@ OpenClaw використовує вбудований каталог модел } ``` -Сумісний з Anthropic, вбудований provider. Скорочення: `openclaw onboard --auth-choice kimi-code-api-key`. +Сумісний з Anthropic, вбудований провайдер. Скорочений варіант: `openclaw onboard --auth-choice kimi-code-api-key`. @@ -607,11 +607,11 @@ OpenClaw використовує вбудований каталог модел } ``` -Base URL має не містити `/v1` (клієнт Anthropic додає його сам). Скорочення: `openclaw onboard --auth-choice synthetic-api-key`. +Base URL має не містити `/v1` (клієнт Anthropic додає його сам). Скорочений варіант: `openclaw onboard --auth-choice synthetic-api-key`. - + ```json5 { @@ -635,7 +635,7 @@ Base URL має не містити `/v1` (клієнт Anthropic додає й id: "MiniMax-M2.7", name: "MiniMax M2.7", reasoning: true, - input: ["text", "image"], + input: ["text"], cost: { input: 0.3, output: 1.2, cacheRead: 0.06, cacheWrite: 0.375 }, contextWindow: 204800, maxTokens: 131072, @@ -647,20 +647,20 @@ Base URL має не містити `/v1` (клієнт Anthropic додає й } ``` -Установіть `MINIMAX_API_KEY`. Скорочення: +Установіть `MINIMAX_API_KEY`. Скорочені варіанти: `openclaw onboard --auth-choice minimax-global-api` або `openclaw onboard --auth-choice minimax-cn-api`. -Каталог моделей типово містить лише M2.7. -На Anthropic-сумісному streaming path OpenClaw типово вимикає thinking MiniMax, -якщо ви явно не задасте `thinking` самостійно. `/fast on` або +Каталог моделей за замовчуванням містить лише M2.7. +На Anthropic-сумісному шляху потокової передачі OpenClaw вимикає thinking +за замовчуванням, якщо ви явно не задасте `thinking` самостійно. `/fast on` або `params.fastMode: true` переписує `MiniMax-M2.7` на `MiniMax-M2.7-highspeed`. - + -Див. [Локальні моделі](/uk/gateway/local-models). Коротко: запускайте велику локальну модель через LM Studio Responses API на достатньо потужному обладнанні; зберігайте злиття з розміщеними моделями як резервний варіант. +Див. [Локальні моделі](/uk/gateway/local-models). Коротко: запускайте велику локальну модель через LM Studio Responses API на достатньо потужному обладнанні; залишайте розміщені моделі об’єднаними для резервного використання. @@ -668,7 +668,7 @@ Base URL має не містити `/v1` (клієнт Anthropic додає й ## Пов’язане -- [Довідник конфігурації](/uk/gateway/configuration-reference) — інші ключі верхнього рівня +- [Довідник із конфігурації](/uk/gateway/configuration-reference) — інші ключі верхнього рівня - [Конфігурація — агенти](/uk/gateway/config-agents) - [Конфігурація — канали](/uk/gateway/config-channels) -- [Tools і plugins](/uk/tools) +- [Інструменти та плагіни](/uk/tools) diff --git a/docs/uk/providers/minimax.md b/docs/uk/providers/minimax.md index 0b8045554..b431d9742 100644 --- a/docs/uk/providers/minimax.md +++ b/docs/uk/providers/minimax.md @@ -1,57 +1,57 @@ --- read_when: - - Ви хочете використовувати моделі MiniMax в OpenClaw - - Вам потрібен посібник із налаштування MiniMax + - Ви хочете моделі MiniMax в OpenClaw + - Вам потрібні вказівки з налаштування MiniMax summary: Використання моделей MiniMax в OpenClaw title: MiniMax x-i18n: - generated_at: "2026-04-23T23:05:02Z" + generated_at: "2026-04-25T00:30:49Z" model: gpt-5.4 provider: openai - source_hash: f2729e9e9f866e66a6587d6c58f6116abae2fc09a1f50e5038e1c25bed0a82f2 + source_hash: 108e0e8de748d0ed68342e1391c7a661136e21e0b255b4afbccf913b6825c6ec source_path: providers/minimax.md workflow: 15 --- -Провайдер MiniMax в OpenClaw типово використовує **MiniMax M2.7**. +Провайдер MiniMax в OpenClaw за замовчуванням використовує **MiniMax M2.7**. MiniMax також надає: - Вбудований синтез мовлення через T2A v2 -- Вбудоване розуміння зображень через `MiniMax-VL-01` +- Вбудоване розпізнавання зображень через `MiniMax-VL-01` - Вбудовану генерацію музики через `music-2.5+` - Вбудований `web_search` через API пошуку MiniMax Coding Plan Розподіл провайдерів: -| ID провайдера | Auth | Можливості | -| ---------------- | ------- | --------------------------------------------------------------- | -| `minimax` | API key | Текст, генерація зображень, розуміння зображень, мовлення, вебпошук | -| `minimax-portal` | OAuth | Текст, генерація зображень, розуміння зображень | +| ID провайдера | Автентифікація | Можливості | +| ---------------- | -------------- | -------------------------------------------------------------- | +| `minimax` | API key | Текст, генерація зображень, розпізнавання зображень, мовлення, вебпошук | +| `minimax-portal` | OAuth | Текст, генерація зображень, розпізнавання зображень | ## Вбудований каталог | Модель | Тип | Опис | | ------------------------ | ---------------- | ---------------------------------------- | -| `MiniMax-M2.7` | Chat (reasoning) | Типова hosted reasoning-модель | -| `MiniMax-M2.7-highspeed` | Chat (reasoning) | Швидший reasoning-рівень M2.7 | -| `MiniMax-VL-01` | Vision | Модель розуміння зображень | -| `image-01` | Генерація зображень | Генерація зображення з тексту та редагування зображення до зображення | -| `music-2.5+` | Генерація музики | Типова модель музики | +| `MiniMax-M2.7` | Чат (міркування) | Типова хостингова модель для міркування | +| `MiniMax-M2.7-highspeed` | Чат (міркування) | Швидший рівень міркування M2.7 | +| `MiniMax-VL-01` | Vision | Модель для розпізнавання зображень | +| `image-01` | Генерація зображень | Перетворення тексту на зображення та редагування зображення за зображенням | +| `music-2.5+` | Генерація музики | Типова музична модель | | `music-2.5` | Генерація музики | Попередній рівень генерації музики | -| `music-2.0` | Генерація музики | Legacy-рівень генерації музики | -| `MiniMax-Hailuo-2.3` | Генерація відео | Потоки text-to-video та image reference | +| `music-2.0` | Генерація музики | Застарілий рівень генерації музики | +| `MiniMax-Hailuo-2.3` | Генерація відео | Потоки перетворення тексту на відео та використання зображення як референсу | ## Початок роботи -Виберіть бажаний спосіб auth і виконайте кроки налаштування. +Виберіть бажаний спосіб автентифікації та виконайте кроки налаштування. - **Найкраще для:** швидкого налаштування через MiniMax Coding Plan з OAuth, без потреби в API key. + **Найкраще підходить для:** швидкого налаштування MiniMax Coding Plan через OAuth, ключ API не потрібен. - + ```bash @@ -67,7 +67,7 @@ MiniMax також надає: - + ```bash @@ -86,7 +86,7 @@ MiniMax також надає: - Конфігурації OAuth використовують id провайдера `minimax-portal`. Посилання на моделі мають форму `minimax-portal/MiniMax-M2.7`. + Налаштування OAuth використовують ID провайдера `minimax-portal`. Посилання на моделі мають формат `minimax-portal/MiniMax-M2.7`. @@ -96,17 +96,17 @@ MiniMax також надає: - **Найкраще для:** hosted MiniMax із API, сумісним з Anthropic. + **Найкраще підходить для:** хостингового MiniMax з API, сумісним з Anthropic. - + ```bash openclaw onboard --auth-choice minimax-global-api ``` - Це налаштовує `api.minimax.io` як base URL. + Це налаштовує `api.minimax.io` як базову URL-адресу. ```bash @@ -115,14 +115,14 @@ MiniMax також надає: - + ```bash openclaw onboard --auth-choice minimax-cn-api ``` - Це налаштовує `api.minimaxi.com` як base URL. + Це налаштовує `api.minimaxi.com` як базову URL-адресу. ```bash @@ -133,7 +133,7 @@ MiniMax також надає: - ### Приклад config + ### Приклад конфігурації ```json5 { @@ -151,7 +151,7 @@ MiniMax також надає: id: "MiniMax-M2.7", name: "MiniMax M2.7", reasoning: true, - input: ["text", "image"], + input: ["text"], cost: { input: 0.3, output: 1.2, cacheRead: 0.06, cacheWrite: 0.375 }, contextWindow: 204800, maxTokens: 131072, @@ -160,7 +160,7 @@ MiniMax також надає: id: "MiniMax-M2.7-highspeed", name: "MiniMax M2.7 Highspeed", reasoning: true, - input: ["text", "image"], + input: ["text"], cost: { input: 0.6, output: 2.4, cacheRead: 0.06, cacheWrite: 0.375 }, contextWindow: 204800, maxTokens: 131072, @@ -173,11 +173,11 @@ MiniMax також надає: ``` - На шляху потокової передачі, сумісному з Anthropic, OpenClaw типово вимикає thinking MiniMax, якщо ви явно не задасте `thinking` самі. Streaming-endpoint MiniMax виводить `reasoning_content` у delta-чанках у стилі OpenAI замість native-блоків thinking Anthropic, що може призвести до витоку внутрішнього reasoning у видимий вивід, якщо залишити це неявно увімкненим. + У сумісному з Anthropic потоковому режимі OpenClaw за замовчуванням вимикає thinking для MiniMax, якщо ви явно не встановите `thinking` самостійно. Потоковий ендпоінт MiniMax повертає `reasoning_content` у дельта-чанках у стилі OpenAI замість нативних блоків thinking Anthropic, що може призвести до витоку внутрішніх міркувань у видимий вивід, якщо залишити цю можливість неявно ввімкненою. - Конфігурації з API key використовують id провайдера `minimax`. Посилання на моделі мають форму `minimax/MiniMax-M2.7`. + Налаштування з API key використовують ID провайдера `minimax`. Посилання на моделі мають формат `minimax/MiniMax-M2.7`. @@ -185,7 +185,7 @@ MiniMax також надає: ## Налаштування через `openclaw configure` -Використовуйте інтерактивний майстер config, щоб налаштувати MiniMax без редагування JSON: +Скористайтеся інтерактивним майстром конфігурації, щоб налаштувати MiniMax без редагування JSON: @@ -194,21 +194,21 @@ MiniMax також надає: ``` - У меню виберіть **Model/auth**. + Виберіть у меню **Model/auth**. - + Виберіть один із доступних варіантів MiniMax: - | Варіант auth | Опис | + | Варіант автентифікації | Опис | | --- | --- | - | `minimax-global-oauth` | Міжнародний OAuth (Coding Plan) | - | `minimax-cn-oauth` | OAuth для Китаю (Coding Plan) | + | `minimax-global-oauth` | International OAuth (Coding Plan) | + | `minimax-cn-oauth` | China OAuth (Coding Plan) | | `minimax-global-api` | Міжнародний API key | | `minimax-cn-api` | API key для Китаю | - Коли з’явиться запит, виберіть вашу типову модель. + Коли з’явиться запит, виберіть типову модель. @@ -216,15 +216,15 @@ MiniMax також надає: ### Генерація зображень -Plugin MiniMax реєструє модель `image-01` для інструмента `image_generate`. Вона підтримує: +Плагін MiniMax реєструє модель `image-01` для інструмента `image_generate`. Вона підтримує: -- **Генерація зображень із тексту** з керуванням aspect ratio -- **Редагування зображення за зображенням** (reference об’єкта) з керуванням aspect ratio +- **Генерація зображень із тексту** з керуванням співвідношенням сторін +- **Редагування зображення за зображенням** (референс об’єкта) з керуванням співвідношенням сторін - До **9 вихідних зображень** на запит -- До **1 reference-зображення** на запит редагування -- Підтримувані aspect ratio: `1:1`, `16:9`, `4:3`, `3:2`, `2:3`, `3:4`, `9:16`, `21:9` +- До **1 референсного зображення** на запит редагування +- Підтримувані співвідношення сторін: `1:1`, `16:9`, `4:3`, `3:2`, `2:3`, `3:4`, `9:16`, `21:9` -Щоб використовувати MiniMax для генерації зображень, задайте його як провайдера генерації зображень: +Щоб використовувати MiniMax для генерації зображень, встановіть його як провайдера генерації зображень: ```json5 { @@ -236,36 +236,33 @@ Plugin MiniMax реєструє модель `image-01` для інструме } ``` -Plugin використовує той самий `MINIMAX_API_KEY` або OAuth auth, що й текстові моделі. Додаткова конфігурація не потрібна, якщо MiniMax уже налаштовано. +Плагін використовує той самий `MINIMAX_API_KEY` або OAuth-автентифікацію, що й текстові моделі. Додаткова конфігурація не потрібна, якщо MiniMax уже налаштовано. І `minimax`, і `minimax-portal` реєструють `image_generate` з тією самою -моделлю `image-01`. Конфігурації з API key використовують `MINIMAX_API_KEY`; конфігурації з OAuth можуть -замість цього використовувати вбудований шлях auth `minimax-portal`. +моделлю `image-01`. Налаштування з API key використовують `MINIMAX_API_KEY`; налаштування OAuth можуть натомість використовувати +вбудований шлях автентифікації `minimax-portal`. -Коли онбординг або налаштування з API key записує явні записи `models.providers.minimax`, +Коли онбординг або налаштування API key записує явні записи `models.providers.minimax`, OpenClaw матеріалізує `MiniMax-M2.7` і -`MiniMax-M2.7-highspeed` з `input: ["text", "image"]`. - -Сам вбудований bundled-каталог текстових моделей MiniMax залишається метаданими лише для тексту, доки -не з’явиться явна конфігурація провайдера. Розуміння зображень відкривається окремо -через медіапровайдер `MiniMax-VL-01`, що належить Plugin-у. +`MiniMax-M2.7-highspeed` як текстові чат-моделі. Розпізнавання зображень +експонується окремо через медіапровайдера `MiniMax-VL-01`, що належить плагіну. -Див. [Генерація зображень](/uk/tools/image-generation) щодо спільних параметрів інструмента, вибору провайдера та поведінки failover. +Див. [Генерація зображень](/uk/tools/image-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover. ### Генерація музики -Вбудований Plugin `minimax` також реєструє генерацію музики через спільний +Вбудований плагін `minimax` також реєструє генерацію музики через спільний інструмент `music_generate`. - Типова музична модель: `minimax/music-2.5+` -- Також підтримує `minimax/music-2.5` і `minimax/music-2.0` -- Керування prompt: `lyrics`, `instrumental`, `durationSeconds` +- Також підтримуються `minimax/music-2.5` і `minimax/music-2.0` +- Керування підказкою: `lyrics`, `instrumental`, `durationSeconds` - Формат виводу: `mp3` -- Запуски на основі сесій від’єднуються через спільний потік task/status, включно з `action: "status"` +- Запуски з підтримкою сесій від’єднуються через спільний потік завдань/статусу, зокрема `action: "status"` -Щоб використовувати MiniMax як типового провайдера музики: +Щоб використовувати MiniMax як типовий музичний провайдер: ```json5 { @@ -280,19 +277,19 @@ OpenClaw матеріалізує `MiniMax-M2.7` і ``` -Див. [Генерація музики](/uk/tools/music-generation) щодо спільних параметрів інструмента, вибору провайдера та поведінки failover. +Див. [Генерація музики](/uk/tools/music-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover. ### Генерація відео -Вбудований Plugin `minimax` також реєструє генерацію відео через спільний +Вбудований плагін `minimax` також реєструє генерацію відео через спільний інструмент `video_generate`. - Типова відеомодель: `minimax/MiniMax-Hailuo-2.3` -- Режими: text-to-video і потоки з одним reference-зображенням +- Режими: перетворення тексту на відео та потоки з одним референсним зображенням - Підтримує `aspectRatio` і `resolution` -Щоб використовувати MiniMax як типового провайдера відео: +Щоб використовувати MiniMax як типовий відеопровайдер: ```json5 { @@ -307,12 +304,12 @@ OpenClaw матеріалізує `MiniMax-M2.7` і ``` -Див. [Генерація відео](/uk/tools/video-generation) щодо спільних параметрів інструмента, вибору провайдера та поведінки failover. +Див. [Генерація відео](/uk/tools/video-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover. -### Розуміння зображень +### Розпізнавання зображень -Plugin MiniMax реєструє розуміння зображень окремо від текстового +Плагін MiniMax реєструє розпізнавання зображень окремо від текстового каталогу: | ID провайдера | Типова модель зображень | @@ -320,25 +317,25 @@ Plugin MiniMax реєструє розуміння зображень окрем | `minimax` | `MiniMax-VL-01` | | `minimax-portal` | `MiniMax-VL-01` | -Саме тому автоматична маршрутизація медіа може використовувати розуміння зображень MiniMax навіть -тоді, коли bundled-каталог текстового провайдера все ще показує лише текстові посилання на чат M2.7. +Саме тому автоматична маршрутизація медіа може використовувати розпізнавання зображень MiniMax навіть +коли вбудований каталог текстових провайдерів усе ще показує лише текстові чат-посилання M2.7. ### Вебпошук -Plugin MiniMax також реєструє `web_search` через API пошуку MiniMax Coding Plan. +Плагін MiniMax також реєструє `web_search` через API пошуку MiniMax Coding Plan. - ID провайдера: `minimax` -- Структуровані результати: заголовки, URL, фрагменти, пов’язані запити -- Бажана змінна середовища: `MINIMAX_CODE_PLAN_KEY` -- Прийнятий псевдонім env: `MINIMAX_CODING_API_KEY` -- Fallback для сумісності: `MINIMAX_API_KEY`, коли він уже вказує на токен coding-plan -- Повторне використання регіону: `plugins.entries.minimax.config.webSearch.region`, потім `MINIMAX_API_HOST`, потім base URL провайдерів MiniMax -- Пошук залишається на ID провайдера `minimax`; конфігурація OAuth CN/global усе ще може непрямо спрямовувати регіон через `models.providers.minimax-portal.baseUrl` +- Структуровані результати: заголовки, URL-адреси, фрагменти, пов’язані запити +- Пріоритетна змінна середовища: `MINIMAX_CODE_PLAN_KEY` +- Псевдонім змінної середовища, що також приймається: `MINIMAX_CODING_API_KEY` +- Резервна сумісність: `MINIMAX_API_KEY`, якщо він уже вказує на токен coding-plan +- Повторне використання регіону: `plugins.entries.minimax.config.webSearch.region`, потім `MINIMAX_API_HOST`, потім базові URL-адреси провайдера MiniMax +- Пошук залишається на ID провайдера `minimax`; налаштування OAuth CN/global однаково можуть опосередковано спрямовувати регіон через `models.providers.minimax-portal.baseUrl` -Конфігурація міститься в `plugins.entries.minimax.config.webSearch.*`. +Конфігурація розміщується в `plugins.entries.minimax.config.webSearch.*`. -Повну конфігурацію та використання вебпошуку див. у [MiniMax Search](/uk/tools/minimax-search). +Див. [Пошук MiniMax](/uk/tools/minimax-search) для повної конфігурації та використання вебпошуку. ## Розширена конфігурація @@ -347,27 +344,27 @@ Plugin MiniMax також реєструє `web_search` через API пошу | Параметр | Опис | | --- | --- | - | `models.providers.minimax.baseUrl` | Надавайте перевагу `https://api.minimax.io/anthropic` (сумісний з Anthropic); `https://api.minimax.io/v1` необов’язковий для payload, сумісних з OpenAI | - | `models.providers.minimax.api` | Надавайте перевагу `anthropic-messages`; `openai-completions` необов’язковий для payload, сумісних з OpenAI | + | `models.providers.minimax.baseUrl` | Рекомендовано `https://api.minimax.io/anthropic` (сумісний з Anthropic); `https://api.minimax.io/v1` є додатковим варіантом для payload, сумісних з OpenAI | + | `models.providers.minimax.api` | Рекомендовано `anthropic-messages`; `openai-completions` є додатковим варіантом для payload, сумісних з OpenAI | | `models.providers.minimax.apiKey` | API key MiniMax (`MINIMAX_API_KEY`) | - | `models.providers.minimax.models` | Визначайте `id`, `name`, `reasoning`, `contextWindow`, `maxTokens`, `cost` | - | `agents.defaults.models` | Моделі-псевдоніми, які ви хочете додати до allowlist | - | `models.mode` | Залишайте `merge`, якщо хочете додати MiniMax поряд із вбудованими | + | `models.providers.minimax.models` | Визначає `id`, `name`, `reasoning`, `contextWindow`, `maxTokens`, `cost` | + | `agents.defaults.models` | Псевдоніми моделей, які ви хочете додати до allowlist | + | `models.mode` | Залиште `merge`, якщо хочете додати MiniMax поряд із вбудованими | - Для `api: "anthropic-messages"` OpenClaw інжектує `thinking: { type: "disabled" }`, якщо thinking уже не задано явно в params/config. + Для `api: "anthropic-messages"` OpenClaw додає `thinking: { type: "disabled" }`, якщо thinking вже не задано явно в params/config. - Це не дає streaming-endpoint-у MiniMax виводити `reasoning_content` у delta-чанках у стилі OpenAI, що призвело б до витоку внутрішнього reasoning у видимий вивід. + Це запобігає тому, щоб потоковий ендпоінт MiniMax надсилав `reasoning_content` у дельта-чанках у стилі OpenAI, що призводило б до витоку внутрішніх міркувань у видимий вивід. - `/fast on` або `params.fastMode: true` переписує `MiniMax-M2.7` на `MiniMax-M2.7-highspeed` на шляху потоку, сумісного з Anthropic. + `/fast on` або `params.fastMode: true` переписує `MiniMax-M2.7` на `MiniMax-M2.7-highspeed` у сумісному з Anthropic потоковому шляху. - - **Найкраще для:** зберігати вашу найсильнішу модель останнього покоління як primary і переходити на MiniMax M2.7 у разі збою. У прикладі нижче як конкретний primary використано Opus; замініть його на бажану primary-модель останнього покоління. + + **Найкраще підходить для:** використання вашої найсильнішої актуальної моделі нового покоління як основної з переходом на MiniMax M2.7 у разі збою. У прикладі нижче Opus використано як конкретну основну модель; замініть її на бажану вами актуальну основну модель нового покоління. ```json5 { @@ -389,46 +386,46 @@ Plugin MiniMax також реєструє `web_search` через API пошу - - - API використання Coding Plan: `https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains` (потребує ключа coding plan). - - OpenClaw нормалізує використання MiniMax coding-plan до того самого відображення `% left`, що й в інших провайдерів. Сирі поля MiniMax `usage_percent` / `usagePercent` означають залишкову квоту, а не використану, тому OpenClaw інвертує їх. Якщо присутні поля з підрахунками, вони мають пріоритет. - - Коли API повертає `model_remains`, OpenClaw надає перевагу запису chat-моделі, за потреби виводить мітку вікна з `start_time` / `end_time` і включає вибрану назву моделі до мітки plan, щоб вікна coding-plan було легше розрізняти. - - Знімки використання трактують `minimax`, `minimax-cn` і `minimax-portal` як ту саму поверхню квоти MiniMax і надають перевагу збереженому OAuth MiniMax, перш ніж переходити до env vars ключа Coding Plan. + + - API використання Coding Plan: `https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains` (потрібен ключ coding plan). + - OpenClaw нормалізує використання coding plan MiniMax до того самого відображення `% left`, що й в інших провайдерів. Сирі поля `usage_percent` / `usagePercent` у MiniMax означають залишкову квоту, а не використану квоту, тому OpenClaw інвертує їх. Поля на основі підрахунку мають пріоритет, якщо вони доступні. + - Коли API повертає `model_remains`, OpenClaw надає перевагу запису chat-моделі, за потреби виводить мітку вікна з `start_time` / `end_time` і включає вибрану назву моделі до мітки плану, щоб вікна coding plan було легше розрізняти. + - Знімки використання розглядають `minimax`, `minimax-cn` і `minimax-portal` як одну й ту саму поверхню квоти MiniMax та надають перевагу збереженому OAuth MiniMax перед переходом до змінних середовища з ключем Coding Plan. ## Примітки -- Посилання на моделі відповідають шляху auth: +- Посилання на моделі відповідають шляху автентифікації: - Налаштування з API key: `minimax/` - Налаштування з OAuth: `minimax-portal/` -- Типова chat-модель: `MiniMax-M2.7` -- Альтернативна chat-модель: `MiniMax-M2.7-highspeed` -- Онбординг і пряме налаштування з API key записують явні визначення моделей з `input: ["text", "image"]` для обох варіантів M2.7 -- Bundled-каталог провайдерів наразі відкриває посилання на chat як метадані лише для тексту, доки не з’явиться явна конфігурація провайдера MiniMax +- Типова чат-модель: `MiniMax-M2.7` +- Альтернативна чат-модель: `MiniMax-M2.7-highspeed` +- Онбординг і пряме налаштування API key записують визначення лише текстових моделей для обох варіантів M2.7 +- Для розпізнавання зображень використовується медіапровайдер `MiniMax-VL-01`, що належить плагіну - Оновіть значення цін у `models.json`, якщо вам потрібне точне відстеження вартості -- Використовуйте `openclaw models list`, щоб підтвердити поточний id провайдера, а потім перемкніть його через `openclaw models set minimax/MiniMax-M2.7` або `openclaw models set minimax-portal/MiniMax-M2.7` +- Використовуйте `openclaw models list`, щоб підтвердити поточний ID провайдера, а потім перемкніться за допомогою `openclaw models set minimax/MiniMax-M2.7` або `openclaw models set minimax-portal/MiniMax-M2.7` Реферальне посилання для MiniMax Coding Plan (знижка 10%): [MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link) -Правила провайдерів див. у [Провайдери моделей](/uk/concepts/model-providers). +Див. [Провайдери моделей](/uk/concepts/model-providers) для правил провайдерів. ## Усунення несправностей - - Зазвичай це означає, що **провайдер MiniMax не налаштовано** (немає відповідного запису провайдера і не знайдено профілю auth/env key MiniMax). Виправлення для цього виявлення є у **2026.1.12**. Виправити можна так: + + Зазвичай це означає, що **провайдер MiniMax не налаштований** (немає відповідного запису провайдера і не знайдено профілю автентифікації/env key MiniMax). Виправлення для цього виявлення є у **2026.1.12**. Виправити можна так: - - Оновіться до **2026.1.12** (або запускайте з вихідного `main`), а потім перезапустіть gateway. - - Запустіть `openclaw configure` і виберіть варіант auth **MiniMax**, або - - Додайте вручну відповідний блок `models.providers.minimax` або `models.providers.minimax-portal`, або - - Задайте `MINIMAX_API_KEY`, `MINIMAX_OAUTH_TOKEN` або профіль auth MiniMax, щоб можна було інжектувати відповідний провайдер. + - Оновіться до **2026.1.12** (або запустіть із вихідного коду `main`), а потім перезапустіть Gateway. + - Запустіть `openclaw configure` і виберіть параметр автентифікації **MiniMax**, або + - Додайте відповідний блок `models.providers.minimax` або `models.providers.minimax-portal` вручну, або + - Задайте `MINIMAX_API_KEY`, `MINIMAX_OAUTH_TOKEN` або профіль автентифікації MiniMax, щоб можна було інжектувати відповідний провайдер. - Переконайтеся, що id моделі **чутливий до регістру**: + Переконайтеся, що ID моделі **чутливий до регістру**: - Шлях API key: `minimax/MiniMax-M2.7` або `minimax/MiniMax-M2.7-highspeed` - Шлях OAuth: `minimax-portal/MiniMax-M2.7` або `minimax-portal/MiniMax-M2.7-highspeed` @@ -443,7 +440,7 @@ Plugin MiniMax також реєструє `web_search` через API пошу -Додаткова допомога: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). +Більше допомоги: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). ## Пов’язане @@ -453,15 +450,15 @@ Plugin MiniMax також реєструє `web_search` через API пошу Вибір провайдерів, посилань на моделі та поведінки failover. - Спільні параметри інструмента зображень і вибір провайдера. + Спільні параметри інструмента для зображень і вибір провайдера. - Спільні параметри інструмента музики і вибір провайдера. + Спільні параметри музичного інструмента та вибір провайдера. - Спільні параметри інструмента відео і вибір провайдера. + Спільні параметри відеоінструмента та вибір провайдера. - + Конфігурація вебпошуку через MiniMax Coding Plan.