diff --git a/docs/uk/providers/ollama.md b/docs/uk/providers/ollama.md index c9936409f..5a523d442 100644 --- a/docs/uk/providers/ollama.md +++ b/docs/uk/providers/ollama.md @@ -1,50 +1,52 @@ --- read_when: - - Ви хочете запустити OpenClaw із хмарними або локальними моделями через Ollama + - Ви хочете запустити OpenClaw з хмарними або локальними моделями через Ollama - Вам потрібні вказівки щодо налаштування та конфігурації Ollama - - Вам потрібні моделі бачення Ollama для розуміння зображень + - Ви хочете використовувати моделі бачення Ollama для розпізнавання зображень summary: Запустіть OpenClaw з Ollama (хмарні та локальні моделі) title: Ollama x-i18n: - generated_at: "2026-04-27T02:11:31Z" + generated_at: "2026-04-27T02:31:41Z" model: gpt-5.4 provider: openai - source_hash: dea13f69d9304cb4aa50b786dabf689fea19fba293846a2cf3d188d923b49a91 + source_hash: 81ff3f97012c3afbd652b9147f61a1ff3e66c2e44bb6c0eb62f061a2a80e262e source_path: providers/ollama.md workflow: 15 --- -OpenClaw інтегрується з нативним API Ollama (`/api/chat`) для розміщених хмарних моделей і локальних/self-hosted серверів Ollama. Ви можете використовувати Ollama у трьох режимах: `Cloud + Local` через доступний хост Ollama, `Cloud only` напряму до `https://ollama.com` або `Local only` через доступний хост Ollama. +OpenClaw інтегрується з нативним API Ollama (`/api/chat`) для розміщених хмарних моделей і локальних/self-hosted серверів Ollama. Ви можете використовувати Ollama у трьох режимах: `Cloud + Local` через доступний хост Ollama, `Cloud only` через `https://ollama.com` або `Local only` через доступний хост Ollama. -**Користувачі віддаленого Ollama**: Не використовуйте OpenAI-сумісний URL `/v1` (`http://host:11434/v1`) з OpenClaw. Це ламає виклик інструментів, і моделі можуть виводити сирий JSON інструментів як звичайний текст. Натомість використовуйте URL нативного API Ollama: `baseUrl: "http://host:11434"` (без `/v1`). +**Користувачі віддаленого Ollama**: Не використовуйте OpenAI-сумісний URL `/v1` (`http://host:11434/v1`) з OpenClaw. Це ламає виклики інструментів, і моделі можуть виводити сирий JSON інструментів як звичайний текст. Натомість використовуйте URL нативного API Ollama: `baseUrl: "http://host:11434"` (без `/v1`). +Конфігурація провайдера Ollama використовує `baseUrl` як канонічний ключ. OpenClaw також приймає `baseURL` для сумісності з прикладами у стилі OpenAI SDK, але в новій конфігурації слід віддавати перевагу `baseUrl`. + ## Початок роботи Виберіть бажаний спосіб налаштування та режим. - - **Найкраще для:** найшвидшого шляху до робочого налаштування Ollama cloud або local. + + **Найкраще для:** найшвидшого шляху до робочого хмарного або локального налаштування Ollama. - + ```bash openclaw onboard ``` Виберіть **Ollama** зі списку провайдерів. - - - **Cloud + Local** — локальний хост Ollama плюс хмарні моделі, маршрутизовані через цей хост + + - **Cloud + Local** — локальний хост Ollama плюс хмарні моделі, що маршрутизуються через цей хост - **Cloud only** — розміщені моделі Ollama через `https://ollama.com` - **Local only** — лише локальні моделі - - `Cloud only` запитує `OLLAMA_API_KEY` і пропонує типові хмарні значення за замовчуванням. `Cloud + Local` і `Local only` запитують базовий URL Ollama, виявляють доступні моделі та автоматично завантажують вибрану локальну модель, якщо вона ще недоступна. `Cloud + Local` також перевіряє, чи виконано вхід на цьому хості Ollama для доступу до хмари. + + `Cloud only` запитує `OLLAMA_API_KEY` і пропонує стандартні розміщені хмарні значення. `Cloud + Local` і `Local only` запитують базовий URL Ollama, виявляють доступні моделі та автоматично завантажують вибрану локальну модель, якщо вона ще недоступна. `Cloud + Local` також перевіряє, чи виконано вхід на цьому хості Ollama для доступу до хмари. - + ```bash openclaw models list --provider ollama ``` @@ -59,7 +61,7 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`) --accept-risk ``` - За потреби вкажіть власний базовий URL або модель: + За бажанням можна вказати власний базовий URL або модель: ```bash openclaw onboard --non-interactive \ @@ -71,16 +73,16 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`) - + **Найкраще для:** повного контролю над хмарним або локальним налаштуванням. - - - **Cloud + Local**: встановіть Ollama, увійдіть через `ollama signin` і маршрутизуйте хмарні запити через цей хост + + - **Cloud + Local**: встановіть Ollama, виконайте вхід за допомогою `ollama signin` і маршрутизуйте хмарні запити через цей хост - **Cloud only**: використовуйте `https://ollama.com` з `OLLAMA_API_KEY` - **Local only**: встановіть Ollama з [ollama.com/download](https://ollama.com/download) - + ```bash ollama pull gemma4 # або @@ -89,27 +91,27 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`) ollama pull llama3.3 ``` - - Для `Cloud only` використовуйте свій справжній `OLLAMA_API_KEY`. Для конфігурацій із хостом підійде будь-яке значення-заглушка: + + Для `Cloud only` використовуйте ваш справжній `OLLAMA_API_KEY`. Для конфігурацій на основі хоста підійде будь-яке заповнювальне значення: ```bash - # Cloud + # Хмара export OLLAMA_API_KEY="your-ollama-api-key" # Лише локально export OLLAMA_API_KEY="ollama-local" - # Або налаштуйте у своєму файлі конфігурації + # Або налаштуйте у своєму конфігураційному файлі openclaw config set models.providers.ollama.apiKey "OLLAMA_API_KEY" ``` - + ```bash openclaw models list openclaw models set ollama/gemma4 ``` - Або встановіть значення за замовчуванням у конфігурації: + Або встановіть модель за замовчуванням у конфігурації: ```json5 { @@ -132,25 +134,25 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`) `Cloud + Local` використовує доступний хост Ollama як точку керування і для локальних, і для хмарних моделей. Це рекомендований Ollama гібридний сценарій. - Під час налаштування використовуйте **Cloud + Local**. OpenClaw запитує базовий URL Ollama, виявляє локальні моделі з цього хоста та перевіряє, чи виконано вхід на хості для хмарного доступу через `ollama signin`. Якщо вхід на хості виконано, OpenClaw також пропонує типові розміщені хмарні значення за замовчуванням, як-от `kimi-k2.5:cloud`, `minimax-m2.7:cloud` і `glm-5.1:cloud`. + Використовуйте **Cloud + Local** під час налаштування. OpenClaw запитує базовий URL Ollama, виявляє локальні моделі з цього хоста та перевіряє, чи виконано вхід на хості для доступу до хмари за допомогою `ollama signin`. Коли вхід на хості виконано, OpenClaw також пропонує стандартні розміщені хмарні моделі, такі як `kimi-k2.5:cloud`, `minimax-m2.7:cloud` і `glm-5.1:cloud`. - Якщо вхід на хості ще не виконано, OpenClaw зберігає налаштування в режимі лише локально, доки ви не виконаєте `ollama signin`. + Якщо вхід на хості ще не виконано, OpenClaw зберігає конфігурацію лише локальною, доки ви не виконаєте `ollama signin`. - `Cloud only` працює з розміщеним API Ollama за адресою `https://ollama.com`. + `Cloud only` працює через розміщений API Ollama за адресою `https://ollama.com`. - Під час налаштування використовуйте **Cloud only**. OpenClaw запитує `OLLAMA_API_KEY`, встановлює `baseUrl: "https://ollama.com"` і заповнює список розміщених хмарних моделей. Цей шлях **не** потребує локального сервера Ollama або `ollama signin`. + Використовуйте **Cloud only** під час налаштування. OpenClaw запитує `OLLAMA_API_KEY`, встановлює `baseUrl: "https://ollama.com"` і заповнює список розміщених хмарних моделей. Цей шлях **не** потребує локального сервера Ollama або `ollama signin`. - Список хмарних моделей, показаний під час `openclaw onboard`, заповнюється в реальному часі з `https://ollama.com/api/tags` і обмежується 500 записами, тому засіб вибору відображає актуальний розміщений каталог, а не статичний набір. Якщо `ollama.com` недоступний або не повертає жодних моделей під час налаштування, OpenClaw повертається до попередніх жорстко заданих рекомендацій, щоб onboarding усе одно завершився. + Список хмарних моделей, показаний під час `openclaw onboard`, заповнюється в реальному часі з `https://ollama.com/api/tags`, з обмеженням до 500 записів, тому вибір відображає поточний розміщений каталог, а не статичний початковий список. Якщо `ollama.com` недосяжний або під час налаштування не повертає моделей, OpenClaw повертається до попередніх жорстко заданих пропозицій, щоб онбординг усе одно завершився. - У режимі лише локально OpenClaw виявляє моделі з налаштованого екземпляра Ollama. Цей шлях призначений для локальних або self-hosted серверів Ollama. + У режимі лише локально OpenClaw виявляє моделі з налаштованого екземпляра Ollama. Цей шлях призначено для локальних або self-hosted серверів Ollama. - Наразі OpenClaw пропонує `gemma4` як локальне значення за замовчуванням. + OpenClaw наразі пропонує `gemma4` як локальну модель за замовчуванням. @@ -161,14 +163,14 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`) | Поведінка | Деталі | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Запит каталогу | Виконує запит до `/api/tags` | -| Виявлення можливостей | Використовує найкращу доступну спробу запитів `/api/show`, щоб зчитати `contextWindow`, розгорнуті параметри Modelfile `num_ctx` і можливості, зокрема vision/tools | -| Моделі vision | Моделі з можливістю `vision`, про яку повідомляє `/api/show`, позначаються як здатні працювати із зображеннями (`input: ["text", "image"]`), тому OpenClaw автоматично додає зображення до prompt | -| Виявлення reasoning | Позначає `reasoning` за евристикою назви моделі (`r1`, `reasoning`, `think`) | -| Ліміти токенів | Встановлює `maxTokens` на типовий максимальний ліміт токенів Ollama, який використовує OpenClaw | -| Вартість | Встановлює всі значення вартості в `0` | +| Запит каталогу | Виконує запити до `/api/tags` | +| Визначення можливостей | Використовує best-effort пошуки `/api/show`, щоб зчитувати `contextWindow`, розгорнуті параметри Modelfile `num_ctx` і можливості, зокрема vision/tools | +| Моделі vision | Моделі з можливістю `vision`, про яку повідомляє `/api/show`, позначаються як здатні працювати із зображеннями (`input: ["text", "image"]`), тому OpenClaw автоматично додає зображення до запиту | +| Визначення reasoning | Позначає `reasoning` за евристикою імені моделі (`r1`, `reasoning`, `think`) | +| Ліміти токенів | Встановлює `maxTokens` на стандартне максимальне обмеження токенів Ollama, яке використовує OpenClaw | +| Вартість | Встановлює всі вартості в `0` | -Це дозволяє уникнути ручного додавання моделей, водночас зберігаючи каталог узгодженим із локальним екземпляром Ollama. +Це дозволяє уникнути ручного додавання моделей, зберігаючи каталог узгодженим із локальним екземпляром Ollama. ```bash # Подивитися, які моделі доступні @@ -182,24 +184,24 @@ openclaw models list ollama pull mistral ``` -Нову модель буде автоматично виявлено, і вона стане доступною для використання. +Нова модель буде автоматично виявлена і стане доступною для використання. -Якщо ви явно задаєте `models.providers.ollama`, автовиявлення пропускається, і вам потрібно визначити моделі вручну. Див. розділ про явну конфігурацію нижче. +Якщо ви явно задаєте `models.providers.ollama`, автоматичне виявлення пропускається, і вам потрібно визначати моделі вручну. Дивіться розділ явної конфігурації нижче. ## Vision і опис зображень -Вбудований Plugin Ollama реєструє Ollama як провайдера розуміння медіа, здатного працювати із зображеннями. Це дає змогу OpenClaw спрямовувати явні запити на опис зображень і налаштовані значення за замовчуванням для моделей зображень через локальні або розміщені vision-моделі Ollama. +Вбудований Plugin Ollama реєструє Ollama як провайдера розуміння медіа з підтримкою зображень. Це дозволяє OpenClaw маршрутизувати явні запити на опис зображень і налаштовані значення за замовчуванням для моделей зображень через локальні або розміщені vision-моделі Ollama. -Для локальної vision завантажте модель, яка підтримує зображення: +Для локального vision завантажте модель, яка підтримує зображення: ```bash ollama pull qwen2.5vl:7b export OLLAMA_API_KEY="ollama-local" ``` -Потім перевірте через infer CLI: +Потім перевірте за допомогою CLI infer: ```bash openclaw infer image describe \ @@ -208,7 +210,7 @@ openclaw infer image describe \ --json ``` -`--model` має бути повним посиланням ``. Якщо його задано, `openclaw infer image describe` запускає цю модель напряму замість пропуску опису, оскільки модель підтримує нативну vision. +`--model` має бути повним посиланням ``. Коли його задано, `openclaw infer image describe` запускає цю модель безпосередньо, а не пропускає опис через те, що модель підтримує нативне vision. Щоб зробити Ollama моделлю розуміння зображень за замовчуванням для вхідних медіа, налаштуйте `agents.defaults.imageModel`: @@ -241,21 +243,21 @@ OpenClaw відхиляє запити на опис зображень для ## Конфігурація - - Найпростіший шлях увімкнення режиму лише локально — через змінну середовища: + + Найпростішим шляхом увімкнення режиму лише локально є змінна середовища: ```bash export OLLAMA_API_KEY="ollama-local" ``` - Якщо задано `OLLAMA_API_KEY`, ви можете не вказувати `apiKey` у записі провайдера, і OpenClaw підставить його для перевірок доступності. + Якщо задано `OLLAMA_API_KEY`, ви можете не вказувати `apiKey` у записі провайдера, і OpenClaw сам підставить його для перевірок доступності. - - Використовуйте явну конфігурацію, якщо вам потрібне налаштування hosted cloud, Ollama працює на іншому хості/порті, ви хочете примусово задати конкретні контекстні вікна або списки моделей, або вам потрібні повністю ручні визначення моделей. + + Використовуйте явну конфігурацію, якщо вам потрібне налаштування розміщеної хмари, Ollama працює на іншому хості/порту, ви хочете примусово задати конкретні контекстні вікна або списки моделей, або вам потрібні повністю ручні визначення моделей. ```json5 { @@ -284,8 +286,8 @@ OpenClaw відхиляє запити на опис зображень для - - Якщо Ollama працює на іншому хості або порту (явна конфігурація вимикає автовиявлення, тому визначайте моделі вручну): + + Якщо Ollama працює на іншому хості або порту (явна конфігурація вимикає автоматичне виявлення, тому визначайте моделі вручну): ```json5 { @@ -294,7 +296,7 @@ OpenClaw відхиляє запити на опис зображень для ollama: { apiKey: "ollama-local", baseUrl: "http://ollama-host:11434", // Без /v1 - використовуйте URL нативного API Ollama - api: "ollama", // Явно задайте, щоб гарантувати нативну поведінку виклику інструментів + api: "ollama", // Задайте явно, щоб гарантувати нативну поведінку виклику інструментів }, }, }, @@ -302,7 +304,7 @@ OpenClaw відхиляє запити на опис зображень для ``` - Не додавайте `/v1` до URL. Шлях `/v1` використовує OpenAI-сумісний режим, де виклик інструментів працює ненадійно. Використовуйте базовий URL Ollama без суфікса шляху. + Не додавайте `/v1` до URL. Шлях `/v1` використовує OpenAI-сумісний режим, у якому виклик інструментів працює ненадійно. Використовуйте базовий URL Ollama без суфікса шляху. @@ -325,19 +327,19 @@ OpenClaw відхиляє запити на опис зображень для } ``` -Також підтримуються власні ідентифікатори провайдера Ollama. Коли посилання на модель використовує префікс активного провайдера, наприклад `ollama-spark/qwen3:32b`, OpenClaw відкидає лише цей префікс перед викликом Ollama, щоб сервер отримав `qwen3:32b`. +Також підтримуються власні ідентифікатори провайдера Ollama. Коли посилання на модель використовує префікс активного провайдера, наприклад `ollama-spark/qwen3:32b`, OpenClaw видаляє лише цей префікс перед викликом Ollama, щоб сервер отримав `qwen3:32b`. -## Вебпошук Ollama +## Web Search Ollama OpenClaw підтримує **Ollama Web Search** як вбудований провайдер `web_search`. -| Властивість | Деталі | -| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Хост | Використовує ваш налаштований хост Ollama (`models.providers.ollama.baseUrl`, якщо задано, інакше `http://127.0.0.1:11434`); `https://ollama.com` напряму використовує розміщений API | -| Автентифікація | Без ключа для локальних хостів Ollama, у яких виконано вхід; `OLLAMA_API_KEY` або налаштована автентифікація провайдера для прямого пошуку через `https://ollama.com` або хостів, захищених автентифікацією | -| Вимога | Локальні/self-hosted хости мають бути запущені, і на них має бути виконано вхід через `ollama signin`; прямий hosted-пошук потребує `baseUrl: "https://ollama.com"` плюс справжній ключ API Ollama | +| Властивість | Деталі | +| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Хост | Використовує налаштований вами хост Ollama (`models.providers.ollama.baseUrl`, якщо задано, інакше `http://127.0.0.1:11434`); `https://ollama.com` використовує розміщений API напряму | +| Автентифікація | Не потрібен ключ для локальних хостів Ollama, де виконано вхід; `OLLAMA_API_KEY` або налаштована автентифікація провайдера для прямого пошуку через `https://ollama.com` або хостів, захищених автентифікацією | +| Вимога | Локальні/self-hosted хости мають бути запущені, і в них має бути виконано вхід через `ollama signin`; прямий розміщений пошук потребує `baseUrl: "https://ollama.com"` плюс справжній ключ API Ollama | -Виберіть **Ollama Web Search** під час `openclaw onboard` або `openclaw configure --section web`, або задайте: +Виберіть **Ollama Web Search** під час `openclaw onboard` або `openclaw configure --section web`, або встановіть: ```json5 { @@ -352,18 +354,18 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр ``` -Повні відомості про налаштування та поведінку див. в [Ollama Web Search](/uk/tools/ollama-search). +Повні відомості про налаштування та поведінку дивіться в [Ollama Web Search](/uk/tools/ollama-search). ## Розширена конфігурація - + - **Виклик інструментів у OpenAI-сумісному режимі працює ненадійно.** Використовуйте цей режим лише тоді, коли вам потрібен формат OpenAI для проксі і ви не залежите від нативної поведінки виклику інструментів. + **Виклик інструментів у OpenAI-сумісному режимі працює ненадійно.** Використовуйте цей режим лише якщо вам потрібен формат OpenAI для проксі й ви не залежите від нативної поведінки виклику інструментів. - Якщо вам потрібно натомість використовувати OpenAI-сумісну кінцеву точку (наприклад, за проксі, який підтримує лише формат OpenAI), явно задайте `api: "openai-completions"`: + Якщо вам потрібно використовувати OpenAI-сумісний endpoint замість цього (наприклад, за проксі, який підтримує лише формат OpenAI), явно задайте `api: "openai-completions"`: ```json5 { @@ -372,7 +374,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр ollama: { baseUrl: "http://ollama-host:11434/v1", api: "openai-completions", - injectNumCtxForOpenAICompat: true, // typical: true + injectNumCtxForOpenAICompat: true, // за замовчуванням: true apiKey: "ollama-local", models: [...] } @@ -381,9 +383,9 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр } ``` - У цьому режимі потокова передача та виклик інструментів можуть не підтримуватися одночасно. Можливо, вам доведеться вимкнути потокову передачу через `params: { streaming: false }` у конфігурації моделі. + У цьому режимі потокова передача і виклик інструментів можуть не підтримуватися одночасно. Можливо, вам доведеться вимкнути потокову передачу через `params: { streaming: false }` у конфігурації моделі. - Коли `api: "openai-completions"` використовується з Ollama, OpenClaw за замовчуванням додає `options.num_ctx`, щоб Ollama не повертався мовчки до контекстного вікна 4096. Якщо ваш проксі/upstream відхиляє невідомі поля `options`, вимкніть цю поведінку: + Коли `api: "openai-completions"` використовується з Ollama, OpenClaw за замовчуванням додає `options.num_ctx`, щоб Ollama мовчки не повертався до контекстного вікна 4096. Якщо ваш проксі/upstream відхиляє невідомі поля `options`, вимкніть цю поведінку: ```json5 { @@ -403,12 +405,12 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр - - Для автоматично виявлених моделей OpenClaw використовує контекстне вікно, яке повідомляє Ollama, якщо воно доступне, зокрема більші значення `PARAMETER num_ctx` із користувацьких Modelfile. В іншому разі використовується типове контекстне вікно Ollama, яке застосовує OpenClaw. + + Для автоматично виявлених моделей OpenClaw використовує контекстне вікно, яке повідомляє Ollama, коли воно доступне, зокрема більші значення `PARAMETER num_ctx` із власних Modelfile. Інакше використовується стандартне контекстне вікно Ollama, яке застосовує OpenClaw. - Ви можете перевизначити `contextWindow` і `maxTokens` у явній конфігурації провайдера. Щоб обмежити контекст виконання Ollama для одного запиту без перебудови Modelfile, задайте `params.num_ctx`; OpenClaw надсилає його як `options.num_ctx` як для нативного Ollama, так і для OpenAI-сумісного адаптера Ollama. Некоректні, нульові, від’ємні та нескінченні значення ігноруються, і використовується `contextWindow`. + Ви можете перевизначити `contextWindow` і `maxTokens` у явній конфігурації провайдера. Щоб обмежити контекст Ollama під час виконання для кожного запиту без перебудови Modelfile, задайте `params.num_ctx`; OpenClaw надсилає це як `options.num_ctx` і для нативного Ollama, і для OpenAI-сумісного адаптера Ollama. Некоректні, нульові, від’ємні та нескінченні значення ігноруються, і використовується `contextWindow`. - Записи нативних моделей Ollama також приймають поширені параметри виконання Ollama в `params`, зокрема `temperature`, `top_p`, `top_k`, `min_p`, `num_predict`, `stop`, `repeat_penalty`, `num_batch`, `num_thread` і `use_mmap`. OpenClaw пересилає лише ключі запиту Ollama, тому параметри виконання OpenClaw, як-от `streaming`, не потрапляють до Ollama. Використовуйте `params.think` або `params.thinking`, щоб надсилати верхньорівневий параметр Ollama `think`; `false` вимикає мислення на рівні API для thinking-моделей у стилі Qwen. + Записи нативних моделей Ollama також приймають поширені параметри виконання Ollama в `params`, зокрема `temperature`, `top_p`, `top_k`, `min_p`, `num_predict`, `stop`, `repeat_penalty`, `num_batch`, `num_thread` і `use_mmap`. OpenClaw пересилає лише ключі запиту Ollama, тому параметри виконання OpenClaw, як-от `streaming`, не потрапляють до Ollama. Використовуйте `params.think` або `params.thinking`, щоб надіслати верхньорівневий параметр Ollama `think`; `false` вимикає API-рівневе thinking для thinking-моделей у стилі Qwen. ```json5 { @@ -434,11 +436,11 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр } ``` - Також працює `agents.defaults.models["ollama/"].params.num_ctx` для окремої моделі. Якщо налаштовано обидва варіанти, явний запис моделі провайдера має пріоритет над значенням за замовчуванням для агента. + `agents.defaults.models["ollama/"].params.num_ctx` для окремої моделі теж працює. Якщо налаштовано обидва варіанти, явний запис моделі провайдера має пріоритет над значенням за замовчуванням агента. - + OpenClaw за замовчуванням вважає моделі з назвами на кшталт `deepseek-r1`, `reasoning` або `think` такими, що підтримують reasoning. ```bash @@ -449,20 +451,20 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр - + Ollama є безкоштовним і працює локально, тому вартість усіх моделей встановлена на рівні $0. Це стосується як автоматично виявлених, так і вручну визначених моделей. Вбудований Plugin Ollama реєструє провайдера embedding для пам’яті для - [пошуку в пам’яті](/uk/concepts/memory). Він використовує налаштовані базовий URL - і ключ API Ollama, звертається до поточної кінцевої точки Ollama `/api/embed` і, коли можливо, - об’єднує кілька фрагментів пам’яті в один запит `input`. + [пошуку в пам’яті](/uk/concepts/memory). Він використовує налаштовані базовий URL Ollama + і ключ API, викликає поточний endpoint Ollama `/api/embed` та групує + кілька фрагментів пам’яті в один запит `input`, коли це можливо. - | Властивість | Значення | + | Властивість | Значення | | ------------- | ------------------- | - | Типова модель | `nomic-embed-text` | - | Автозавантаження | Так — модель embedding автоматично завантажується локально, якщо її ще немає | + | Модель за замовчуванням | `nomic-embed-text` | + | Автоматичне завантаження | Так — модель embedding автоматично завантажується, якщо локально її немає | Щоб вибрати Ollama як провайдера embedding для пошуку в пам’яті: @@ -478,13 +480,13 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр - - Інтеграція Ollama в OpenClaw за замовчуванням використовує **нативний API Ollama** (`/api/chat`), який повністю підтримує одночасно потокову передачу та виклик інструментів. Жодна спеціальна конфігурація не потрібна. + + Інтеграція Ollama в OpenClaw за замовчуванням використовує **нативний API Ollama** (`/api/chat`), який повністю підтримує одночасно і потокову передачу, і виклик інструментів. Жодної спеціальної конфігурації не потрібно. - Для нативних запитів `/api/chat` OpenClaw також напряму передає керування мисленням до Ollama: `/think off` і `openclaw agent --thinking off` надсилають верхньорівневе `think: false`, а `/think low|medium|high` надсилають відповідний рядок верхнього рівня `think` із рівнем зусилля. `/think max` відображається на найвищий нативний рівень зусилля Ollama, `think: "high"`. + Для нативних запитів `/api/chat` OpenClaw також напряму передає керування thinking до Ollama: `/think off` і `openclaw agent --thinking off` надсилають верхньорівневий `think: false`, а `/think low|medium|high` надсилають відповідний верхньорівневий рядок з рівнем `think`. `/think max` зіставляється з найвищим нативним рівнем зусилля Ollama, `think: "high"`. - Якщо вам потрібно використовувати OpenAI-сумісну кінцеву точку, див. розділ "Legacy OpenAI-compatible mode" вище. У цьому режимі потокова передача та виклик інструментів можуть не працювати одночасно. + Якщо вам потрібно використовувати OpenAI-сумісний endpoint, дивіться розділ "Застарілий OpenAI-сумісний режим" вище. У цьому режимі потокова передача та виклик інструментів можуть не працювати одночасно. @@ -493,8 +495,8 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр ## Усунення несправностей - - Переконайтеся, що Ollama запущено, що ви задали `OLLAMA_API_KEY` (або профіль автентифікації) і що ви **не** визначили явний запис `models.providers.ollama`: + + Переконайтеся, що Ollama запущено, що ви задали `OLLAMA_API_KEY` (або профіль автентифікації), і що ви **не** визначили явний запис `models.providers.ollama`: ```bash ollama serve @@ -508,8 +510,8 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр - - Якщо вашої моделі немає в списку, або завантажте модель локально, або явно визначте її в `models.providers.ollama`. + + Якщо вашої моделі немає у списку, або завантажте її локально, або явно визначте її в `models.providers.ollama`. ```bash ollama list # Подивитися, що встановлено @@ -520,8 +522,8 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр - - Перевірте, що Ollama працює на правильному порту: + + Перевірте, що Ollama запущено на правильному порту: ```bash # Перевірити, чи запущено Ollama @@ -535,22 +537,22 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр -Більше довідки: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). +Більше допомоги: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). ## Пов’язане - - Огляд усіх провайдерів, посилань на моделі та поведінки перемикання при збої. + + Огляд усіх провайдерів, посилань на моделі та поведінки перемикання при відмові. - - Як вибирати та налаштовувати моделі. + + Як вибирати й налаштовувати моделі. - Повні відомості про налаштування та поведінку вебпошуку на базі Ollama. + Повні відомості про налаштування та поведінку вебпошуку на основі Ollama. - + Повний довідник із конфігурації. diff --git a/docs/uk/tools/ollama-search.md b/docs/uk/tools/ollama-search.md index e21283258..604cbdb8a 100644 --- a/docs/uk/tools/ollama-search.md +++ b/docs/uk/tools/ollama-search.md @@ -1,32 +1,28 @@ --- read_when: - Ви хочете використовувати Ollama для `web_search` - - Вам потрібен постачальник `web_search` без ключа + - Ви хочете постачальника `web_search` без ключа - Ви хочете використовувати розміщений вебпошук Ollama з `OLLAMA_API_KEY` - Вам потрібні вказівки з налаштування вебпошуку Ollama summary: Вебпошук Ollama через локальний хост Ollama або розміщений API Ollama title: вебпошук Ollama x-i18n: - generated_at: "2026-04-27T01:11:28Z" + generated_at: "2026-04-27T02:31:50Z" model: gpt-5.4 provider: openai - source_hash: 2c20b2405dab06f091ed636a8cc1f5e85a2f9e7ac62489db28c8f9ec9fee8357 + source_hash: e626ee38b80fc66aa33589f030f9b420cf27848faed2183912ade17cb222771b source_path: tools/ollama-search.md workflow: 15 --- -OpenClaw підтримує **вебпошук Ollama** як вбудованого постачальника `web_search`. Він -використовує API вебпошуку Ollama і повертає структуровані результати із заголовками, URL-адресами -та фрагментами. +OpenClaw підтримує **вебпошук Ollama** як вбудований постачальник `web_search`. Він використовує API вебпошуку Ollama і повертає структуровані результати із заголовками, URL-адресами та фрагментами. -Для локального або самостійно розгорнутого Ollama це налаштування -типово не потребує API-ключа. Проте потрібні: +Для локального або самостійно розміщеного Ollama це налаштування типово не потребує API-ключа. Однак потрібні: -- хост Ollama, до якого OpenClaw має доступ +- хост Ollama, до якого OpenClaw може підключитися - `ollama signin` -Для прямого розміщеного пошуку встановіть базову URL-адресу постачальника Ollama на `https://ollama.com` -і вкажіть справжній `OLLAMA_API_KEY`. +Для прямого розміщеного пошуку встановіть базову URL-адресу постачальника Ollama як `https://ollama.com` і вкажіть справжній `OLLAMA_API_KEY`. ## Налаштування @@ -54,8 +50,7 @@ OpenClaw підтримує **вебпошук Ollama** як вбудовано -Якщо ви вже використовуєте Ollama для моделей, вебпошук Ollama повторно -використовує той самий налаштований хост. +Якщо ви вже використовуєте Ollama для моделей, вебпошук Ollama повторно використовує той самий налаштований хост. ## Конфігурація @@ -89,8 +84,7 @@ OpenClaw підтримує **вебпошук Ollama** як вбудовано } ``` -Якщо ви вже налаштували Ollama як постачальника моделей, постачальник вебпошуку -може повторно використовувати цей хост: +Якщо ви вже налаштовуєте Ollama як постачальника моделей, постачальник вебпошуку може повторно використовувати цей хост: ```json5 { @@ -104,10 +98,12 @@ OpenClaw підтримує **вебпошук Ollama** як вбудовано } ``` -Якщо явну базову URL-адресу Ollama не встановлено, OpenClaw використовує `http://127.0.0.1:11434`. +Постачальник моделей Ollama використовує `baseUrl` як канонічний ключ. Постачальник вебпошуку також підтримує `baseURL` у `models.providers.ollama` для сумісності з прикладами конфігурації в стилі OpenAI SDK. + +Якщо явну базову URL-адресу Ollama не задано, OpenClaw використовує `http://127.0.0.1:11434`. Якщо ваш хост Ollama очікує bearer-автентифікацію, OpenClaw повторно використовує -`models.providers.ollama.apiKey` (або відповідну автентифікацію постачальника, під’єднану через env) +`models.providers.ollama.apiKey` (або відповідну автентифікацію постачальника, підкріплену змінними середовища) для запитів до цього налаштованого хоста. Прямий розміщений вебпошук Ollama: @@ -135,24 +131,24 @@ OpenClaw підтримує **вебпошук Ollama** як вбудовано ## Примітки - Для цього постачальника не потрібне окреме поле API-ключа саме для вебпошуку. -- Якщо хост Ollama захищений автентифікацією, OpenClaw повторно використовує звичайний - API-ключ постачальника Ollama, якщо він наявний. -- Якщо `baseUrl` має значення `https://ollama.com`, OpenClaw викликає - `https://ollama.com/api/web_search` безпосередньо та надсилає налаштований API-ключ Ollama +- Якщо хост Ollama захищено автентифікацією, OpenClaw повторно використовує звичайний + API-ключ постачальника Ollama, якщо його задано. +- Якщо `baseUrl` дорівнює `https://ollama.com`, OpenClaw викликає + `https://ollama.com/api/web_search` напряму й надсилає налаштований API-ключ Ollama як bearer-автентифікацію. - Якщо налаштований хост не надає вебпошук і встановлено `OLLAMA_API_KEY`, OpenClaw може повернутися до `https://ollama.com/api/web_search`, не надсилаючи - цей env-ключ на локальний хост. -- OpenClaw попереджає під час налаштування, якщо Ollama недоступний або в нього не виконано вхід, + цей ключ змінної середовища на локальний хост. +- Під час налаштування OpenClaw попереджає, якщо Ollama недоступний або не виконано вхід, але це не блокує вибір. -- Автовиявлення під час виконання може переключитися на вебпошук Ollama, якщо не налаштовано +- Автовизначення під час виконання може повернутися до вебпошуку Ollama, якщо не налаштовано жодного постачальника з вищим пріоритетом і обліковими даними. - Локальні хости демона Ollama використовують локальну проксі-кінцеву точку - `/api/experimental/web_search`, яка підписує та пересилає запити до Ollama Cloud. + `/api/experimental/web_search`, яка підписує та пересилає запити в Ollama Cloud. - Хости `https://ollama.com` використовують публічну розміщену кінцеву точку - `/api/web_search` безпосередньо з bearer-автентифікацією через API-ключ. + `/api/web_search` напряму з bearer-автентифікацією API-ключем. ## Пов’язане -- [Огляд вебпошуку](/uk/tools/web) -- усі постачальники та автовиявлення -- [Ollama](/uk/providers/ollama) -- налаштування моделей Ollama та хмарний/локальний режими +- [Огляд вебпошуку](/uk/tools/web) -- усі постачальники та автовизначення +- [Ollama](/uk/providers/ollama) -- налаштування моделі Ollama та хмарні/локальні режими