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

chore(i18n): refresh uk translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-27 00:07:02 +00:00
parent 0e9ed1d05c
commit a6b0b31d9b
2 changed files with 111 additions and 114 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

177
docs/uk/providers/ollama.md
View File

@ -1,50 +1,50 @@
---
read_when:
- Ви хочете запускати OpenClaw з хмарними або локальними моделями через Ollama
- Вам потрібні інструкції з налаштування та конфігурації Ollama
- Ви хочете використовувати моделі Ollama з підтримкою зору для розуміння зображень
summary: Запускайте OpenClaw з Ollama (хмарні та локальні моделі)
- Ви хочете запустити OpenClaw із хмарними або локальними моделями через Ollama
- Вам потрібні вказівки щодо налаштування та конфігурації Ollama
- Ви хочете використовувати візійні моделі Ollama для розпізнавання зображень
summary: Запустіть OpenClaw з Ollama (хмарні та локальні моделі)
title: Ollama
x-i18n:
generated_at: "2026-04-26T21:53:32Z"
generated_at: "2026-04-27T00:05:56Z"
model: gpt-5.4
provider: openai
source_hash: 6fdec2ee2b642bbc57badbc434d41a210b421ac745cd0fceb7be595cbb0cb082
source_hash: d035b17148e4b049765db2b3b572fe61085d2d18df4e921b328b20f57acf5ce0
source_path: providers/ollama.md
workflow: 15
---
OpenClaw інтегрується з нативним API Ollama (`/api/chat`) для розміщених хмарних моделей і локальних/самостійно розміщених серверів Ollama. Ви можете використовувати Ollama у трьох режимах: `Cloud + Local` через доступний хост Ollama, `Cloud only` через `https://ollama.com` або `Local only` через доступний хост Ollama.
OpenClaw інтегрується з нативним API Ollama (`/api/chat`) для розміщених хмарних моделей і локальних/самостійно розміщених серверів Ollama. Ви можете використовувати Ollama у трьох режимах: `Cloud + Local` через доступний хост Ollama, `Cloud only` напряму до `https://ollama.com` або `Local only` через доступний хост Ollama.
<Warning>
**Користувачі віддаленого Ollama**: Не використовуйте URL OpenAI-сумісного `/v1` (`http://host:11434/v1`) з OpenClaw. Це ламає виклик інструментів, і моделі можуть виводити сирий JSON інструментів як звичайний текст. Натомість використовуйте URL нативного API Ollama: `baseUrl: "http://host:11434"` (без `/v1`).
**Користувачі віддаленого Ollama**: Не використовуйте URL `/v1`, сумісний з OpenAI (`http://host:11434/v1`), з OpenClaw. Це ламає виклик інструментів, і моделі можуть виводити необроблений JSON інструментів як звичайний текст. Замість цього використовуйте URL нативного API Ollama: `baseUrl: "http://host:11434"` (без `/v1`).
</Warning>
## Початок роботи
Виберіть бажаний спосіб налаштування та режим.
Оберіть бажаний спосіб і режим налаштування.
<Tabs>
<Tab title="Початкове налаштування (рекомендовано)">
**Найкраще для:** найшвидшого способу отримати робоче хмарне або локальне налаштування Ollama.
<Tab title="Onboarding (recommended)">
**Найкраще для:** найшвидшого способу отримати робоче налаштування Ollama cloud або local.
<Steps>
<Step title="Запустіть початкове налаштування">
<Step title="Запустіть onboarding">
```bash
openclaw onboard
```
Виберіть **Ollama** зі списку провайдерів.
</Step>
<Step title="Виберіть свій режим">
- **Cloud + Local** — локальний хост Ollama плюс хмарні моделі, спрямовані через цей хост
<Step title="Оберіть свій режим">
- **Cloud + Local** — локальний хост Ollama плюс хмарні моделі, маршрутизовані через цей хост
- **Cloud only** — розміщені моделі Ollama через `https://ollama.com`
- **Local only** — лише локальні моделі
</Step>
<Step title="Виберіть модель">
`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 для доступу до хмари.
</Step>
<Step title="Перевірте, що модель доступна">
<Step title="Переконайтеся, що модель доступна">
```bash
openclaw models list --provider ollama
```
@ -72,15 +72,15 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
</Tab>
<Tab title="Ручне налаштування">
**Найкраще для:** повного контролю над хмарним або локальним налаштуванням.
**Найкраще для:** повного контролю над налаштуванням cloud або local.
<Steps>
<Step title="Виберіть хмарний або локальний режим">
- **Cloud + Local**: встановіть Ollama, виконайте вхід через `ollama signin` і спрямовуйте хмарні запити через цей хост
<Step title="Оберіть cloud або local">
- **Cloud + Local**: встановіть Ollama, увійдіть через `ollama signin` і маршрутизуйте хмарні запити через цей хост
- **Cloud only**: використовуйте `https://ollama.com` з `OLLAMA_API_KEY`
- **Local only**: встановіть Ollama з [ollama.com/download](https://ollama.com/download)
</Step>
<Step title="Завантажте локальну модель (лише локальний режим)">
<Step title="Завантажте локальну модель (лише local)">
```bash
ollama pull gemma4
# або
@ -96,7 +96,7 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
# Хмара
export OLLAMA_API_KEY="your-ollama-api-key"
# Лише локально
# Лише local
export OLLAMA_API_KEY="ollama-local"
# Або налаштуйте у своєму файлі конфігурації
@ -109,7 +109,7 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
openclaw models set ollama/gemma4
```
Або встановіть модель за замовчуванням у конфігурації:
Або встановіть типову модель у конфігурації:
```json5
{
@ -130,48 +130,48 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
<Tabs>
<Tab title="Cloud + Local">
`Cloud + Local` використовує доступний хост Ollama як контрольну точку і для локальних, і для хмарних моделей. Це рекомендований гібридний підхід Ollama.
`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`.
</Tab>
<Tab title="Cloud only">
`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 повертається до попередніх жорстко закодованих рекомендацій, щоб початкове налаштування все одно завершилось.
Список хмарних моделей, показаний під час `openclaw onboard`, заповнюється в реальному часі з `https://ollama.com/api/tags` з обмеженням до 500 записів, тому засіб вибору відображає поточний розміщений каталог, а не статичний початковий набір. Якщо `ollama.com` недоступний або під час налаштування не повертає моделей, OpenClaw повертається до попередніх жорстко закодованих пропозицій, щоб onboarding усе одно завершився.
</Tab>
<Tab title="Local only">
У режимі лише локального використання OpenClaw виявляє моделі з налаштованого екземпляра Ollama. Цей шлях призначений для локальних або самостійно розміщених серверів Ollama.
OpenClaw наразі пропонує `gemma4` як локальну модель за замовчуванням.
Наразі OpenClaw пропонує `gemma4` як локальне типове значення.
</Tab>
</Tabs>
## Виявлення моделей (неявний провайдер)
Коли ви встановлюєте `OLLAMA_API_KEY` (або профіль автентифікації) і **не** визначаєте `models.providers.ollama`, OpenClaw виявляє моделі з локального екземпляра Ollama за адресою `http://127.0.0.1:11434`.
Коли ви задаєте `OLLAMA_API_KEY` (або профіль автентифікації) і **не** визначаєте `models.providers.ollama`, OpenClaw виявляє моделі з локального екземпляра Ollama за адресою `http://127.0.0.1:11434`.
| Поведінка | Докладно |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Запит каталогу | Виконує запити до `/api/tags` |
| Визначення можливостей | Використовує best-effort запити до `/api/show`, щоб зчитати `contextWindow` і визначити можливості (зокрема vision) |
| 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` і виявити можливості (зокрема vision) |
| Vision-моделі | Моделі з можливістю `vision`, про яку повідомляє `/api/show`, позначаються як здатні працювати із зображеннями (`input: ["text", "image"]`), тож OpenClaw автоматично додає зображення в запит |
| Виявлення reasoning | Позначає `reasoning` за допомогою евристики назви моделі (`r1`, `reasoning`, `think`) |
| Ліміти токенів | Встановлює `maxTokens` на типовий ліміт максимальних токенів Ollama, який використовує OpenClaw |
| Вартість | Встановлює всі значення вартості на `0` |
Це дає змогу уникнути ручного додавання моделей, водночас зберігаючи узгодженість каталогу з локальним екземпляром Ollama.
Це дає змогу уникнути ручного додавання моделей, водночас зберігаючи каталог узгодженим із локальним екземпляром Ollama.
```bash
# Подивитися, які моделі доступні
# Подивіться, які моделі доступні
ollama list
openclaw models list
```
@ -182,24 +182,24 @@ openclaw models list
ollama pull mistral
```
Нова модель буде автоматично виявлена й доступна для використання.
Нову модель буде автоматично виявлено, і вона стане доступною для використання.
<Note>
Якщо ви явно задаєте `models.providers.ollama`, автовиявлення пропускається, і вам потрібно визначати моделі вручну. Дивіться розділ явної конфігурації нижче.
Якщо ви явно задаєте `models.providers.ollama`, автоматичне виявлення пропускається, і вам потрібно визначати моделі вручну. Див. розділ явної конфігурації нижче.
</Note>
## 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"
```
Потім перевірте за допомогою CLI infer:
Потім перевірте через infer CLI:
```bash
openclaw infer image describe \
@ -208,9 +208,9 @@ openclaw infer image describe \
--json
```
`--model` має бути повним посиланням `<provider/model>`. Коли його встановлено, `openclaw infer image describe` запускає цю модель напряму замість пропуску опису, оскільки модель підтримує нативний vision.
`--model` має бути повним посиланням у форматі `<provider/model>`. Якщо його задано, `openclaw infer image describe` запускає цю модель безпосередньо замість пропуску опису через те, що модель підтримує нативний vision.
Щоб зробити Ollama моделлю розуміння зображень за замовчуванням для вхідних медіа, налаштуйте `agents.defaults.imageModel`:
Щоб зробити Ollama типовою моделлю розуміння зображень для вхідних медіа, налаштуйте `agents.defaults.imageModel`:
```json5
{
@ -224,7 +224,7 @@ openclaw infer image describe \
}
```
Якщо ви визначаєте `models.providers.ollama.models` вручну, позначте vision-моделі як такі, що підтримують вхідні зображення:
Якщо ви вручну визначаєте `models.providers.ollama.models`, позначайте vision-моделі підтримкою вхідних зображень:
```json5
{
@ -236,26 +236,26 @@ openclaw infer image describe \
}
```
OpenClaw відхиляє запити на опис зображень для моделей, які не позначені як такі, що підтримують зображення. За неявного виявлення OpenClaw зчитує це з Ollama, коли `/api/show` повідомляє про можливість vision.
OpenClaw відхиляє запити на опис зображень для моделей, які не позначені як здатні працювати із зображеннями. За неявного виявлення OpenClaw зчитує це з Ollama, коли `/api/show` повідомляє про можливість vision.
## Конфігурація
<Tabs>
<Tab title="Базова (неявне виявлення)">
Найпростіший спосіб увімкнути режим лише локального використання — через змінну середовища:
Найпростіший шлях увімкнення лише local — через змінну середовища:
```bash
export OLLAMA_API_KEY="ollama-local"
```
<Tip>
Якщо встановлено `OLLAMA_API_KEY`, ви можете не вказувати `apiKey` у записі провайдера, і OpenClaw підставить його для перевірок доступності.
Якщо задано `OLLAMA_API_KEY`, ви можете не вказувати `apiKey` у записі провайдера, і OpenClaw підставить його для перевірок доступності.
</Tip>
</Tab>
<Tab title="Явна (ручні моделі)">
Використовуйте явну конфігурацію, якщо вам потрібне розміщене хмарне налаштування, Ollama працює на іншому хості/порту, ви хочете примусово встановити конкретні вікна контексту або списки моделей, або вам потрібні повністю ручні визначення моделей.
Використовуйте явну конфігурацію, якщо вам потрібне розміщене хмарне налаштування, Ollama працює на іншому хості/порті, ви хочете примусово задати певні контекстні вікна або списки моделей, або вам потрібні повністю ручні визначення моделей.
```json5
{
@ -285,7 +285,7 @@ OpenClaw відхиляє запити на опис зображень для
</Tab>
<Tab title="Власний базовий URL">
Якщо Ollama працює на іншому хості або порту (явна конфігурація вимикає автовиявлення, тому визначайте моделі вручну):
Якщо Ollama працює на іншому хості або порту (явна конфігурація вимикає автоматичне виявлення, тому визначайте моделі вручну):
```json5
{
@ -293,8 +293,8 @@ OpenClaw відхиляє запити на опис зображень для
providers: {
ollama: {
apiKey: "ollama-local",
baseUrl: "http://ollama-host:11434", // Без /v1 - використовуйте URL нативного API Ollama
api: "ollama", // Установіть явно, щоб гарантувати нативну поведінку виклику інструментів
baseUrl: "http://ollama-host:11434", // Без /v1 — використовуйте URL нативного API Ollama
api: "ollama", // Задайте явно, щоб гарантувати нативну поведінку виклику інструментів
},
},
},
@ -302,7 +302,7 @@ OpenClaw відхиляє запити на опис зображень для
```
<Warning>
Не додавайте `/v1` до URL. Шлях `/v1` використовує OpenAI-сумісний режим, у якому виклик інструментів працює ненадійно. Використовуйте базовий URL Ollama без суфікса шляху.
Не додавайте `/v1` до URL. Шлях `/v1` використовує режим сумісності з OpenAI, у якому виклик інструментів працює ненадійно. Використовуйте базовий URL Ollama без суфікса шляху.
</Warning>
</Tab>
@ -325,17 +325,19 @@ OpenClaw відхиляє запити на опис зображень для
}
```
## Ollama Web Search
Також підтримуються власні ідентифікатори провайдера Ollama. Коли посилання на модель використовує префікс активного провайдера, наприклад `ollama-spark/qwen3:32b`, OpenClaw прибирає лише цей префікс перед викликом Ollama, щоб сервер отримав `qwen3:32b`.
## Веб-пошук Ollama
OpenClaw підтримує **Ollama Web Search** як вбудований провайдер `web_search`.
| Властивість | Докладно |
| ----------- | ------------------------------------------------------------------------------------------------------------------- |
| Властивість | Докладно |
| ----------- | ----------------------------------------------------------------------------------------------------------------------- |
| Хост | Використовує налаштований вами хост Ollama (`models.providers.ollama.baseUrl`, якщо задано, інакше `http://127.0.0.1:11434`) |
| Автентифікація | Без ключа |
| Вимога | Ollama має бути запущений, і вхід має бути виконаний через `ollama signin` |
| Автентифікація | Без ключа |
| Вимога | Ollama має бути запущений, і в ньому має бути виконано вхід через `ollama signin` |
Виберіть **Ollama Web Search** під час `openclaw onboard` або `openclaw configure --section web`, або встановіть:
Виберіть **Ollama Web Search** під час `openclaw onboard` або `openclaw configure --section web`, або задайте:
```json5
{
@ -350,18 +352,18 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
```
<Note>
Повні відомості про налаштування та поведінку дивіться в [Ollama Web Search](/uk/tools/ollama-search).
Повні відомості про налаштування та поведінку див. у [Ollama Web Search](/uk/tools/ollama-search).
</Note>
## Розширена конфігурація
<AccordionGroup>
<Accordion title="Застарілий OpenAI-сумісний режим">
<Accordion title="Застарілий режим сумісності з OpenAI">
<Warning>
**Виклик інструментів у OpenAI-сумісному режимі працює ненадійно.** Використовуйте цей режим лише тоді, коли вам потрібен формат OpenAI для проксі й ви не залежите від нативної поведінки виклику інструментів.
**Виклик інструментів у режимі сумісності з OpenAI працює ненадійно.** Використовуйте цей режим лише якщо вам потрібен формат OpenAI для проксі й ви не залежите від нативної поведінки виклику інструментів.
</Warning>
Якщо вам потрібно замість цього використовувати OpenAI-сумісну кінцеву точку (наприклад, за проксі, який підтримує лише формат OpenAI), явно встановіть `api: "openai-completions"`:
Якщо вам потрібно використовувати натомість endpoint, сумісний з OpenAI (наприклад, за проксі, який підтримує лише формат OpenAI), явно задайте `api: "openai-completions"`:
```json5
{
@ -370,7 +372,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
ollama: {
baseUrl: "http://ollama-host:11434/v1",
api: "openai-completions",
injectNumCtxForOpenAICompat: true, // за замовчуванням: true
injectNumCtxForOpenAICompat: true, // типово: true
apiKey: "ollama-local",
models: [...]
}
@ -379,9 +381,9 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
}
```
У цьому режимі може не підтримуватися одночасно потокова передача та виклик інструментів. Вам може знадобитися вимкнути потокову передачу за допомогою `params: { streaming: false }` у конфігурації моделі.
У цьому режимі потокова передача та виклик інструментів можуть не підтримуватися одночасно. Може знадобитися вимкнути потокову передачу через `params: { streaming: false }` у конфігурації моделі.
Коли `api: "openai-completions"` використовується з Ollama, OpenClaw за замовчуванням додає `options.num_ctx`, щоб Ollama не переходила мовчки до вікна контексту 4096. Якщо ваш проксі/апстрім відхиляє невідомі поля `options`, вимкніть цю поведінку:
Коли `api: "openai-completions"` використовується з Ollama, OpenClaw типово додає `options.num_ctx`, щоб Ollama не переходив мовчки на контекстне вікно 4096. Якщо ваш проксі/вищестоящий сервіс відхиляє невідомі поля `options`, вимкніть цю поведінку:
```json5
{
@ -401,8 +403,8 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
</Accordion>
<Accordion title="Вікна контексту">
Для автоматично виявлених моделей OpenClaw використовує вікно контексту, про яке повідомляє Ollama, якщо воно доступне; інакше використовується стандартне вікно контексту Ollama, яке застосовує OpenClaw.
<Accordion title="Контекстні вікна">
Для автоматично виявлених моделей OpenClaw використовує контекстне вікно, про яке повідомляє Ollama, коли воно доступне, інакше повертається до типового контекстного вікна Ollama, яке використовує OpenClaw.
Ви можете перевизначити `contextWindow` і `maxTokens` у явній конфігурації провайдера:
@ -427,7 +429,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
</Accordion>
<Accordion title="Моделі reasoning">
OpenClaw за замовчуванням вважає моделі з назвами на кшталт `deepseek-r1`, `reasoning` або `think` такими, що підтримують reasoning.
OpenClaw типово вважає моделі з назвами на кшталт `deepseek-r1`, `reasoning` або `think` здатними до reasoning.
```bash
ollama pull deepseek-r1:32b
@ -438,18 +440,19 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
</Accordion>
<Accordion title="Вартість моделей">
Ollama є безплатною та працює локально, тому вартість усіх моделей встановлена на рівні $0. Це стосується як автоматично виявлених, так і вручну визначених моделей.
Ollama є безкоштовним і працює локально, тому вартість усіх моделей установлено на $0. Це стосується як автоматично виявлених, так і вручну визначених моделей.
</Accordion>
<Accordion title="Вбудовування пам’яті">
Вбудований Plugin Ollama реєструє провайдера вбудовувань пам’яті для
[пошуку в пам’яті](/uk/concepts/memory). Він використовує налаштований базовий URL Ollama
та API-ключ.
[пошуку в пам’яті](/uk/concepts/memory). Він використовує налаштовані базовий URL
і API-ключ Ollama, викликає поточний endpoint Ollama `/api/embed` і за
можливості об’єднує кілька фрагментів пам’яті в один запит `input`.
| Властивість | Значення |
| ------------------ | ------------------- |
| Модель за замовчуванням | `nomic-embed-text` |
| Автозавантаження | Так — модель вбудовувань автоматично завантажується локально, якщо її ще немає |
| Властивість | Значення |
| -------------- | ------------------- |
| Типова модель | `nomic-embed-text` |
| Автозавантаження | Так — модель вбудовувань автоматично завантажується, якщо її немає локально |
Щоб вибрати Ollama як провайдера вбудовувань для пошуку в пам’яті:
@ -466,12 +469,12 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
</Accordion>
<Accordion title="Конфігурація потокової передачі">
Інтеграція Ollama в OpenClaw за замовчуванням використовує **нативний API Ollama** (`/api/chat`), який повністю підтримує одночасно потокову передачу та виклик інструментів. Жодної спеціальної конфігурації не потрібно.
Інтеграція OpenClaw з Ollama типово використовує **нативний API Ollama** (`/api/chat`), який повністю підтримує одночасно потокову передачу та виклик інструментів. Жодної спеціальної конфігурації не потрібно.
Для нативних запитів `/api/chat` OpenClaw також напряму передає керування thinking до Ollama: `/think off` і `openclaw agent --thinking off` надсилають верхньорівневе `think: false`, тоді як `/think low|medium|high` надсилають відповідний рядок рівня effort у верхньому рівні `think`. `/think max` відповідає найвищому нативному рівню effort в Ollama, `think: "high"`.
Для нативних запитів `/api/chat` OpenClaw також напряму передає керування thinking до Ollama: `/think off` і `openclaw agent --thinking off` надсилають верхньорівневе `think: false`, тоді як `/think low|medium|high` надсилають відповідний рядок рівня effort у верхньому рівні `think`. `/think max` зіставляється з найвищим нативним рівнем effort Ollama — `think: "high"`.
<Tip>
Якщо вам потрібно використовувати OpenAI-сумісну кінцеву точку, дивіться розділ "Застарілий OpenAI-сумісний режим" вище. У цьому режимі потокова передача та виклик інструментів можуть не працювати одночасно.
Якщо вам потрібно використовувати endpoint, сумісний з OpenAI, див. розділ «Застарілий режим сумісності з OpenAI» вище. У цьому режимі потокова передача та виклик інструментів можуть не працювати одночасно.
</Tip>
</Accordion>
@ -481,7 +484,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
<AccordionGroup>
<Accordion title="Ollama не виявлено">
Переконайтеся, що Ollama запущена, що ви встановили `OLLAMA_API_KEY` (або профіль автентифікації) і що ви **не** визначили явний запис `models.providers.ollama`:
Переконайтеся, що Ollama запущено, що ви задали `OLLAMA_API_KEY` (або профіль автентифікації) і що ви **не** визначили явний запис `models.providers.ollama`:
```bash
ollama serve
@ -508,10 +511,10 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
</Accordion>
<Accordion title="У з’єднанні відмовлено">
Перевірте, що Ollama запущена на правильному порту:
Переконайтеся, що Ollama запущено на правильному порту:
```bash
# Перевірити, чи запущена Ollama
# Перевірити, чи запущено Ollama
ps aux | grep ollama
# Або перезапустити Ollama
@ -522,7 +525,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
</AccordionGroup>
<Note>
Додаткова допомога: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq).
Більше довідки: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq).
</Note>
## Пов’язане
@ -535,9 +538,9 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
Як вибирати та налаштовувати моделі.
</Card>
<Card title="Ollama Web Search" href="/uk/tools/ollama-search" icon="magnifying-glass">
Повні відомості про налаштування та поведінку вебпошуку на основі Ollama.
Повні відомості про налаштування та поведінку веб-пошуку на базі Ollama.
</Card>
<Card title="Конфігурація" href="/uk/gateway/configuration" icon="gear">
Повна довідка з конфігурації.
Повний довідник із конфігурації.
</Card>
</CardGroup>

48
docs/uk/tools/ollama-search.md
View File

@ -1,27 +1,24 @@
---
read_when:
- Ви хочете використовувати Ollama для `web_search`
- Ви хочете провайдера `web_search` без ключа
- Вам потрібен постачальник `web_search` без ключа
- Вам потрібні вказівки з налаштування вебпошуку Ollama
summary: Вебпошук Ollama через ваш налаштований хост Ollama
summary: Вебпошук Ollama через налаштований вами хост Ollama
title: вебпошук Ollama
x-i18n:
generated_at: "2026-04-25T21:40:09Z"
generated_at: "2026-04-27T00:05:44Z"
model: gpt-5.4
provider: openai
source_hash: dadee473d4e0674d9261b93adb1ddf77221e949d385fb522ccb630ed0e73d340
source_hash: 568c2792926c2d31b87bc07fd7825b950f2434c0b838c77279e0850754f0131d
source_path: tools/ollama-search.md
workflow: 15
---
OpenClaw підтримує **Ollama Web Search** як вбудований провайдер `web_search`. Він
використовує API вебпошуку Ollama і повертає структуровані результати із заголовками, URL-адресами
та фрагментами.
OpenClaw підтримує **вебпошук Ollama** як вбудованого постачальника `web_search`. Він використовує API вебпошуку Ollama і повертає структуровані результати із заголовками, URL-адресами та фрагментами.
На відміну від провайдера моделей Ollama, це налаштування типово не потребує API-ключа.
Однак воно потребує:
На відміну від постачальника моделей Ollama, це налаштування типово не потребує API-ключа. Однак потрібні:
- хоста Ollama, доступного з OpenClaw
- хост Ollama, до якого OpenClaw може підключитися
- `ollama signin`
## Налаштування
@ -38,20 +35,19 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
```
</Step>
<Step title="Виберіть Ollama Web Search">
<Step title="Виберіть вебпошук Ollama">
Виконайте:
```bash
openclaw configure --section web
```
Потім виберіть **Ollama Web Search** як провайдера.
Потім виберіть **вебпошук Ollama** як постачальника.
</Step>
</Steps>
Якщо ви вже використовуєте Ollama для моделей, Ollama Web Search повторно використовує той самий
налаштований хост.
Якщо ви вже використовуєте Ollama для моделей, вебпошук Ollama повторно використовує той самий налаштований хост.
## Конфігурація
@ -81,24 +77,22 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
}
```
Якщо явний базовий URL Ollama не задано, OpenClaw використовує `http://127.0.0.1:11434`.
Якщо явну базову URL-адресу Ollama не задано, OpenClaw використовує `http://127.0.0.1:11434`.
Якщо ваш хост Ollama очікує bearer-автентифікацію, OpenClaw повторно використовує
`models.providers.ollama.apiKey` (або відповідну автентифікацію провайдера з env)
також і для запитів вебпошуку.
`models.providers.ollama.apiKey` (або відповідну автентифікацію постачальника, що надходить з env)
для запитів до цього налаштованого хоста.
## Примітки
- Для цього провайдера не потрібне окреме поле API-ключа для вебпошуку.
- Якщо хост Ollama захищено автентифікацією, OpenClaw повторно використовує звичайний
API-ключ провайдера Ollama, якщо він наявний.
- Під час налаштування OpenClaw попереджає, якщо Ollama недоступний або вхід не виконано, але
це не блокує вибір.
- Автовизначення під час виконання може перейти до Ollama Web Search, якщо не налаштовано
жодного провайдера з вищим пріоритетом і обліковими даними.
- Провайдер використовує ендпоінт Ollama `/api/web_search`.
- Для цього постачальника не потрібне окреме поле API-ключа для вебпошуку.
- Якщо хост Ollama захищений автентифікацією, OpenClaw повторно використовує звичайний API-ключ постачальника Ollama, якщо він заданий.
- Якщо налаштований хост не надає вебпошук і встановлено `OLLAMA_API_KEY`, OpenClaw може переключитися на `https://ollama.com/api/web_search`, не надсилаючи цей ключ env на локальний хост.
- Під час налаштування OpenClaw попереджає, якщо Ollama недоступний або вхід не виконано, але не блокує вибір.
- Автовиявлення під час виконання може переключитися на вебпошук Ollama, якщо не налаштовано жодного постачальника з вищим пріоритетом і обліковими даними.
- Постачальник спочатку намагається використати endpoint Ollama `/api/web_search`, а потім застарілий endpoint `/api/experimental/web_search` для старіших хостів.
## Пов’язане
- [Огляд Web Search](/uk/tools/web) -- усі провайдери та автовизначення
- [Ollama](/uk/providers/ollama) -- налаштування моделі Ollama та хмарний/локальний режими
- [Огляд вебпошуку](/uk/tools/web) -- усі постачальники та автовиявлення
- [Ollama](/uk/providers/ollama) -- налаштування моделей Ollama та хмарний/локальний режими