chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
1375874c60
commit
7bae0afae3
@ -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.
|
||||
|
||||
<Warning>
|
||||
**Користувачі віддаленого 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`).
|
||||
</Warning>
|
||||
|
||||
Конфігурація провайдера Ollama використовує `baseUrl` як канонічний ключ. OpenClaw також приймає `baseURL` для сумісності з прикладами у стилі OpenAI SDK, але в новій конфігурації слід віддавати перевагу `baseUrl`.
|
||||
|
||||
## Початок роботи
|
||||
|
||||
Виберіть бажаний спосіб налаштування та режим.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Onboarding (recommended)">
|
||||
**Найкраще для:** найшвидшого шляху до робочого налаштування Ollama cloud або local.
|
||||
<Tab title="Onboarding (рекомендовано)">
|
||||
**Найкраще для:** найшвидшого шляху до робочого хмарного або локального налаштування Ollama.
|
||||
|
||||
<Steps>
|
||||
<Step title="Run onboarding">
|
||||
<Step title="Запустіть онбординг">
|
||||
```bash
|
||||
openclaw onboard
|
||||
```
|
||||
|
||||
Виберіть **Ollama** зі списку провайдерів.
|
||||
</Step>
|
||||
<Step title="Choose your mode">
|
||||
- **Cloud + Local** — локальний хост Ollama плюс хмарні моделі, маршрутизовані через цей хост
|
||||
<Step title="Виберіть свій режим">
|
||||
- **Cloud + Local** — локальний хост Ollama плюс хмарні моделі, що маршрутизуються через цей хост
|
||||
- **Cloud only** — розміщені моделі Ollama через `https://ollama.com`
|
||||
- **Local only** — лише локальні моделі
|
||||
</Step>
|
||||
<Step title="Select a model">
|
||||
`Cloud only` запитує `OLLAMA_API_KEY` і пропонує типові хмарні значення за замовчуванням. `Cloud + Local` і `Local only` запитують базовий URL Ollama, виявляють доступні моделі та автоматично завантажують вибрану локальну модель, якщо вона ще недоступна. `Cloud + Local` також перевіряє, чи виконано вхід на цьому хості Ollama для доступу до хмари.
|
||||
<Step title="Виберіть модель">
|
||||
`Cloud only` запитує `OLLAMA_API_KEY` і пропонує стандартні розміщені хмарні значення. `Cloud + Local` і `Local only` запитують базовий URL Ollama, виявляють доступні моделі та автоматично завантажують вибрану локальну модель, якщо вона ще недоступна. `Cloud + Local` також перевіряє, чи виконано вхід на цьому хості Ollama для доступу до хмари.
|
||||
</Step>
|
||||
<Step title="Verify the model is available">
|
||||
<Step title="Перевірте, що модель доступна">
|
||||
```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`)
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Manual setup">
|
||||
<Tab title="Ручне налаштування">
|
||||
**Найкраще для:** повного контролю над хмарним або локальним налаштуванням.
|
||||
|
||||
<Steps>
|
||||
<Step title="Choose cloud or local">
|
||||
- **Cloud + Local**: встановіть Ollama, увійдіть через `ollama signin` і маршрутизуйте хмарні запити через цей хост
|
||||
<Step title="Виберіть хмарний або локальний режим">
|
||||
- **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="Pull a local model (local only)">
|
||||
<Step title="Завантажте локальну модель (лише локально)">
|
||||
```bash
|
||||
ollama pull gemma4
|
||||
# або
|
||||
@ -89,27 +91,27 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
|
||||
ollama pull llama3.3
|
||||
```
|
||||
</Step>
|
||||
<Step title="Enable Ollama for OpenClaw">
|
||||
Для `Cloud only` використовуйте свій справжній `OLLAMA_API_KEY`. Для конфігурацій із хостом підійде будь-яке значення-заглушка:
|
||||
<Step title="Увімкніть Ollama для OpenClaw">
|
||||
Для `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"
|
||||
```
|
||||
</Step>
|
||||
<Step title="Inspect and set your model">
|
||||
<Step title="Перегляньте та встановіть свою модель">
|
||||
```bash
|
||||
openclaw models list
|
||||
openclaw models set ollama/gemma4
|
||||
```
|
||||
|
||||
Або встановіть значення за замовчуванням у конфігурації:
|
||||
Або встановіть модель за замовчуванням у конфігурації:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -132,25 +134,25 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
|
||||
<Tab title="Cloud + Local">
|
||||
`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` працює через розміщений 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 повертається до попередніх жорстко заданих пропозицій, щоб онбординг усе одно завершився.
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Local only">
|
||||
У режимі лише локально OpenClaw виявляє моделі з налаштованого екземпляра Ollama. Цей шлях призначений для локальних або self-hosted серверів Ollama.
|
||||
У режимі лише локально OpenClaw виявляє моделі з налаштованого екземпляра Ollama. Цей шлях призначено для локальних або self-hosted серверів Ollama.
|
||||
|
||||
Наразі OpenClaw пропонує `gemma4` як локальне значення за замовчуванням.
|
||||
OpenClaw наразі пропонує `gemma4` як локальну модель за замовчуванням.
|
||||
|
||||
</Tab>
|
||||
</Tabs>
|
||||
@ -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
|
||||
```
|
||||
|
||||
Нову модель буде автоматично виявлено, і вона стане доступною для використання.
|
||||
Нова модель буде автоматично виявлена і стане доступною для використання.
|
||||
|
||||
<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"
|
||||
```
|
||||
|
||||
Потім перевірте через infer CLI:
|
||||
Потім перевірте за допомогою CLI infer:
|
||||
|
||||
```bash
|
||||
openclaw infer image describe \
|
||||
@ -208,7 +210,7 @@ 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`:
|
||||
|
||||
@ -241,21 +243,21 @@ OpenClaw відхиляє запити на опис зображень для
|
||||
## Конфігурація
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Basic (implicit discovery)">
|
||||
Найпростіший шлях увімкнення режиму лише локально — через змінну середовища:
|
||||
<Tab title="Базова (неявне виявлення)">
|
||||
Найпростішим шляхом увімкнення режиму лише локально є змінна середовища:
|
||||
|
||||
```bash
|
||||
export OLLAMA_API_KEY="ollama-local"
|
||||
```
|
||||
|
||||
<Tip>
|
||||
Якщо задано `OLLAMA_API_KEY`, ви можете не вказувати `apiKey` у записі провайдера, і OpenClaw підставить його для перевірок доступності.
|
||||
Якщо задано `OLLAMA_API_KEY`, ви можете не вказувати `apiKey` у записі провайдера, і OpenClaw сам підставить його для перевірок доступності.
|
||||
</Tip>
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Explicit (manual models)">
|
||||
Використовуйте явну конфігурацію, якщо вам потрібне налаштування hosted cloud, Ollama працює на іншому хості/порті, ви хочете примусово задати конкретні контекстні вікна або списки моделей, або вам потрібні повністю ручні визначення моделей.
|
||||
<Tab title="Явна (ручні моделі)">
|
||||
Використовуйте явну конфігурацію, якщо вам потрібне налаштування розміщеної хмари, Ollama працює на іншому хості/порту, ви хочете примусово задати конкретні контекстні вікна або списки моделей, або вам потрібні повністю ручні визначення моделей.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -284,8 +286,8 @@ OpenClaw відхиляє запити на опис зображень для
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Custom base URL">
|
||||
Якщо Ollama працює на іншому хості або порту (явна конфігурація вимикає автовиявлення, тому визначайте моделі вручну):
|
||||
<Tab title="Власний базовий URL">
|
||||
Якщо 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 відхиляє запити на опис зображень для
|
||||
```
|
||||
|
||||
<Warning>
|
||||
Не додавайте `/v1` до URL. Шлях `/v1` використовує OpenAI-сумісний режим, де виклик інструментів працює ненадійно. Використовуйте базовий URL Ollama без суфікса шляху.
|
||||
Не додавайте `/v1` до URL. Шлях `/v1` використовує OpenAI-сумісний режим, у якому виклик інструментів працює ненадійно. Використовуйте базовий URL Ollama без суфікса шляху.
|
||||
</Warning>
|
||||
|
||||
</Tab>
|
||||
@ -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** як вбудований пр
|
||||
```
|
||||
|
||||
<Note>
|
||||
Повні відомості про налаштування та поведінку див. в [Ollama Web Search](/uk/tools/ollama-search).
|
||||
Повні відомості про налаштування та поведінку дивіться в [Ollama Web Search](/uk/tools/ollama-search).
|
||||
</Note>
|
||||
|
||||
## Розширена конфігурація
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Legacy OpenAI-compatible mode">
|
||||
<Accordion title="Застарілий OpenAI-сумісний режим">
|
||||
<Warning>
|
||||
**Виклик інструментів у OpenAI-сумісному режимі працює ненадійно.** Використовуйте цей режим лише тоді, коли вам потрібен формат OpenAI для проксі і ви не залежите від нативної поведінки виклику інструментів.
|
||||
**Виклик інструментів у OpenAI-сумісному режимі працює ненадійно.** Використовуйте цей режим лише якщо вам потрібен формат OpenAI для проксі й ви не залежите від нативної поведінки виклику інструментів.
|
||||
</Warning>
|
||||
|
||||
Якщо вам потрібно натомість використовувати 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** як вбудований пр
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Context windows">
|
||||
Для автоматично виявлених моделей OpenClaw використовує контекстне вікно, яке повідомляє Ollama, якщо воно доступне, зокрема більші значення `PARAMETER num_ctx` із користувацьких Modelfile. В іншому разі використовується типове контекстне вікно Ollama, яке застосовує OpenClaw.
|
||||
<Accordion title="Контекстні вікна">
|
||||
Для автоматично виявлених моделей 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/<model>"].params.num_ctx` для окремої моделі. Якщо налаштовано обидва варіанти, явний запис моделі провайдера має пріоритет над значенням за замовчуванням для агента.
|
||||
`agents.defaults.models["ollama/<model>"].params.num_ctx` для окремої моделі теж працює. Якщо налаштовано обидва варіанти, явний запис моделі провайдера має пріоритет над значенням за замовчуванням агента.
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Reasoning models">
|
||||
<Accordion title="Моделі reasoning">
|
||||
OpenClaw за замовчуванням вважає моделі з назвами на кшталт `deepseek-r1`, `reasoning` або `think` такими, що підтримують reasoning.
|
||||
|
||||
```bash
|
||||
@ -449,20 +451,20 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Model costs">
|
||||
<Accordion title="Вартість моделей">
|
||||
Ollama є безкоштовним і працює локально, тому вартість усіх моделей встановлена на рівні $0. Це стосується як автоматично виявлених, так і вручну визначених моделей.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Memory embeddings">
|
||||
Вбудований 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** як вбудований пр
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Streaming configuration">
|
||||
Інтеграція Ollama в OpenClaw за замовчуванням використовує **нативний API Ollama** (`/api/chat`), який повністю підтримує одночасно потокову передачу та виклик інструментів. Жодна спеціальна конфігурація не потрібна.
|
||||
<Accordion title="Конфігурація потокової передачі">
|
||||
Інтеграція 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"`.
|
||||
|
||||
<Tip>
|
||||
Якщо вам потрібно використовувати OpenAI-сумісну кінцеву точку, див. розділ "Legacy OpenAI-compatible mode" вище. У цьому режимі потокова передача та виклик інструментів можуть не працювати одночасно.
|
||||
Якщо вам потрібно використовувати OpenAI-сумісний endpoint, дивіться розділ "Застарілий OpenAI-сумісний режим" вище. У цьому режимі потокова передача та виклик інструментів можуть не працювати одночасно.
|
||||
</Tip>
|
||||
|
||||
</Accordion>
|
||||
@ -493,8 +495,8 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
|
||||
## Усунення несправностей
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Ollama not detected">
|
||||
Переконайтеся, що Ollama запущено, що ви задали `OLLAMA_API_KEY` (або профіль автентифікації) і що ви **не** визначили явний запис `models.providers.ollama`:
|
||||
<Accordion title="Ollama не виявлено">
|
||||
Переконайтеся, що Ollama запущено, що ви задали `OLLAMA_API_KEY` (або профіль автентифікації), і що ви **не** визначили явний запис `models.providers.ollama`:
|
||||
|
||||
```bash
|
||||
ollama serve
|
||||
@ -508,8 +510,8 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="No models available">
|
||||
Якщо вашої моделі немає в списку, або завантажте модель локально, або явно визначте її в `models.providers.ollama`.
|
||||
<Accordion title="Немає доступних моделей">
|
||||
Якщо вашої моделі немає у списку, або завантажте її локально, або явно визначте її в `models.providers.ollama`.
|
||||
|
||||
```bash
|
||||
ollama list # Подивитися, що встановлено
|
||||
@ -520,8 +522,8 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Connection refused">
|
||||
Перевірте, що Ollama працює на правильному порту:
|
||||
<Accordion title="У підключенні відмовлено">
|
||||
Перевірте, що Ollama запущено на правильному порту:
|
||||
|
||||
```bash
|
||||
# Перевірити, чи запущено Ollama
|
||||
@ -535,22 +537,22 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
|
||||
</AccordionGroup>
|
||||
|
||||
<Note>
|
||||
Більше довідки: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq).
|
||||
Більше допомоги: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq).
|
||||
</Note>
|
||||
|
||||
## Пов’язане
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Model selection" href="/uk/concepts/model-providers" icon="layers">
|
||||
Огляд усіх провайдерів, посилань на моделі та поведінки перемикання при збої.
|
||||
<Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
|
||||
Огляд усіх провайдерів, посилань на моделі та поведінки перемикання при відмові.
|
||||
</Card>
|
||||
<Card title="Model selection" href="/uk/concepts/models" icon="brain">
|
||||
Як вибирати та налаштовувати моделі.
|
||||
<Card title="Вибір моделі" href="/uk/concepts/models" icon="brain">
|
||||
Як вибирати й налаштовувати моделі.
|
||||
</Card>
|
||||
<Card title="Ollama Web Search" href="/uk/tools/ollama-search" icon="magnifying-glass">
|
||||
Повні відомості про налаштування та поведінку вебпошуку на базі Ollama.
|
||||
Повні відомості про налаштування та поведінку вебпошуку на основі Ollama.
|
||||
</Card>
|
||||
<Card title="Configuration" href="/uk/gateway/configuration" icon="gear">
|
||||
<Card title="Конфігурація" href="/uk/gateway/configuration" icon="gear">
|
||||
Повний довідник із конфігурації.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
@ -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** як вбудовано
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
Якщо ви вже використовуєте 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 та хмарні/локальні режими
|
||||
|
||||
Loading…
Reference in New Issue
Block a user