chore(i18n): refresh uk translations
This commit is contained in:
parent
4686c8e07f
commit
aced6e08fc
@ -1,23 +1,23 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете запустити OpenClaw із хмарними або локальними моделями через Ollama
|
||||
- Вам потрібні вказівки з налаштування та конфігурації Ollama
|
||||
- Ви хочете використовувати візуальні моделі Ollama для розуміння зображень
|
||||
- Вам потрібні інструкції з налаштування та конфігурації Ollama
|
||||
- Ви хочете використовувати моделі бачення Ollama для розуміння зображень
|
||||
summary: Запустіть OpenClaw з Ollama (хмарні та локальні моделі)
|
||||
title: Ollama
|
||||
x-i18n:
|
||||
generated_at: "2026-04-27T01:11:27Z"
|
||||
generated_at: "2026-04-27T01:36:39Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 5bb8f968bd936c107e21b9286257573a2f2b88cfa1a4da232e87a0f86654c4d0
|
||||
source_hash: d1ff7af392874a6c6fafefd73b13dd8454c6589991c817eead7e8ffae6d3ac31
|
||||
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 `/v1`, сумісний з OpenAI (`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>
|
||||
|
||||
## Початок роботи
|
||||
@ -25,11 +25,11 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
|
||||
Виберіть бажаний спосіб налаштування та режим.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Початкове налаштування (рекомендовано)">
|
||||
**Найкраще для:** найшвидшого способу отримати робоче хмарне або локальне налаштування Ollama.
|
||||
<Tab title="Onboarding (рекомендовано)">
|
||||
**Найкраще для:** найшвидшого шляху до робочого хмарного або локального налаштування Ollama.
|
||||
|
||||
<Steps>
|
||||
<Step title="Запустіть початкове налаштування">
|
||||
<Step title="Запустіть onboarding">
|
||||
```bash
|
||||
openclaw onboard
|
||||
```
|
||||
@ -37,14 +37,14 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
|
||||
Виберіть **Ollama** зі списку провайдерів.
|
||||
</Step>
|
||||
<Step title="Виберіть свій режим">
|
||||
- **Cloud + Local** — локальний хост Ollama плюс хмарні моделі, що маршрутизуються через цей хост
|
||||
- **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
|
||||
```
|
||||
@ -59,7 +59,7 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
|
||||
--accept-risk
|
||||
```
|
||||
|
||||
За бажанням можна вказати власний базовий URL або модель:
|
||||
За бажанням укажіть власну базову URL-адресу або модель:
|
||||
|
||||
```bash
|
||||
openclaw onboard --non-interactive \
|
||||
@ -75,12 +75,12 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
|
||||
**Найкраще для:** повного контролю над хмарним або локальним налаштуванням.
|
||||
|
||||
<Steps>
|
||||
<Step title="Виберіть хмарний чи локальний режим">
|
||||
- **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="Завантажте локальну модель (лише локальний режим)">
|
||||
<Step title="Завантажте локальну модель (лише локально)">
|
||||
```bash
|
||||
ollama pull gemma4
|
||||
# або
|
||||
@ -99,17 +99,17 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
|
||||
# Лише локально
|
||||
export OLLAMA_API_KEY="ollama-local"
|
||||
|
||||
# Або налаштуйте у своєму конфігураційному файлі
|
||||
# Або налаштуйте у своєму файлі конфігурації
|
||||
openclaw config set models.providers.ollama.apiKey "OLLAMA_API_KEY"
|
||||
```
|
||||
</Step>
|
||||
<Step title="Перегляньте та встановіть свою модель">
|
||||
<Step title="Перегляньте й установіть свою модель">
|
||||
```bash
|
||||
openclaw models list
|
||||
openclaw models set ollama/gemma4
|
||||
```
|
||||
|
||||
Або встановіть значення за замовчуванням у конфігурації:
|
||||
Або встановіть типову модель у конфігурації:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -130,27 +130,27 @@ 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` працює з розміщеним 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 виявляє моделі з налаштованого екземпляра Ollama. Цей шлях призначений для локальних або власнорозміщених серверів Ollama.
|
||||
|
||||
Зараз OpenClaw пропонує `gemma4` як локальне значення за замовчуванням.
|
||||
Наразі OpenClaw пропонує `gemma4` як локальну модель за замовчуванням.
|
||||
|
||||
</Tab>
|
||||
</Tabs>
|
||||
@ -159,19 +159,19 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
|
||||
|
||||
Коли ви встановлюєте `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 автоматично додає зображення до запиту |
|
||||
| Визначення reasoning | Позначає `reasoning` за допомогою евристики на основі назви моделі (`r1`, `reasoning`, `think`) |
|
||||
| Ліміти токенів | Установлює `maxTokens` на типове максимальне обмеження токенів Ollama, яке використовує OpenClaw |
|
||||
| Вартість | Установлює всі вартості в `0` |
|
||||
| Поведінка | Докладно |
|
||||
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Запит до каталогу | Виконує запит до `/api/tags` |
|
||||
| Виявлення можливостей | Використовує найкраще можливе визначення через пошуки `/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
|
||||
# Подивіться, які моделі доступні
|
||||
# Подивитися, які моделі доступні
|
||||
ollama list
|
||||
openclaw models list
|
||||
```
|
||||
@ -182,15 +182,15 @@ 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 завантажте модель, яка підтримує зображення:
|
||||
|
||||
@ -199,7 +199,7 @@ ollama pull qwen2.5vl:7b
|
||||
export OLLAMA_API_KEY="ollama-local"
|
||||
```
|
||||
|
||||
Потім перевірте за допомогою infer CLI:
|
||||
Потім перевірте через 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
|
||||
{
|
||||
@ -242,20 +242,20 @@ OpenClaw відхиляє запити на опис зображень для
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Базова (неявне виявлення)">
|
||||
Найпростіший спосіб увімкнути режим лише локального використання — через змінну середовища:
|
||||
Найпростіший шлях увімкнення лише локального режиму — через змінну середовища:
|
||||
|
||||
```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
|
||||
{
|
||||
@ -284,7 +284,7 @@ OpenClaw відхиляє запити на опис зображень для
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Власний базовий URL">
|
||||
<Tab title="Власна базова URL-адреса">
|
||||
Якщо Ollama працює на іншому хості або порту (явна конфігурація вимикає автоматичне виявлення, тому визначайте моделі вручну):
|
||||
|
||||
```json5
|
||||
@ -294,7 +294,7 @@ OpenClaw відхиляє запити на опис зображень для
|
||||
ollama: {
|
||||
apiKey: "ollama-local",
|
||||
baseUrl: "http://ollama-host:11434", // Без /v1 — використовуйте URL нативного API Ollama
|
||||
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,17 @@ OpenClaw відхиляє запити на опис зображень для
|
||||
}
|
||||
```
|
||||
|
||||
Також підтримуються власні ідентифікатори провайдера Ollama. Коли посилання на модель використовує префікс активного провайдера, наприклад `ollama-spark/qwen3:32b`, OpenClaw видаляє лише цей префікс перед викликом Ollama, щоб сервер отримав `qwen3:32b`.
|
||||
Також підтримуються власні ідентифікатори провайдера Ollama. Коли посилання на модель використовує префікс активного провайдера, наприклад `ollama-spark/qwen3:32b`, OpenClaw видаляє лише цей префікс перед викликом Ollama, тому сервер отримує `qwen3:32b`.
|
||||
|
||||
## Вебпошук Ollama
|
||||
|
||||
OpenClaw підтримує **Ollama Web Search** як вбудований провайдер `web_search`.
|
||||
OpenClaw підтримує **Вебпошук Ollama** як вбудований провайдер `web_search`.
|
||||
|
||||
| Властивість | Деталі |
|
||||
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Властивість | Докладно |
|
||||
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Хост | Використовує налаштований вами хост Ollama (`models.providers.ollama.baseUrl`, якщо задано, інакше `http://127.0.0.1:11434`); `https://ollama.com` напряму використовує розміщений API |
|
||||
| Автентифікація | Не потребує ключа для локальних хостів Ollama, де виконано вхід; `OLLAMA_API_KEY` або налаштована автентифікація провайдера для прямого пошуку через `https://ollama.com` або хостів, захищених автентифікацією |
|
||||
| Вимога | Локальні/власнорозміщені хости мають працювати, і в них має бути виконано вхід через `ollama signin`; прямий розміщений пошук потребує `baseUrl: "https://ollama.com"` плюс справжній ключ API Ollama |
|
||||
| Автентифікація | Без ключа для локальних хостів Ollama, у яких виконано вхід; `OLLAMA_API_KEY` або налаштована автентифікація провайдера для прямого пошуку через `https://ollama.com` або хостів, захищених автентифікацією |
|
||||
| Вимога | Локальні/власнорозміщені хости мають бути запущені та з виконаним входом через `ollama signin`; прямий розміщений пошук потребує `baseUrl: "https://ollama.com"` плюс справжній ключ API Ollama |
|
||||
|
||||
Виберіть **Ollama Web Search** під час `openclaw onboard` або `openclaw configure --section web`, або встановіть:
|
||||
|
||||
@ -358,12 +358,12 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
|
||||
## Розширена конфігурація
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Застарілий режим сумісності з OpenAI">
|
||||
<Accordion title="Застарілий OpenAI-сумісний режим">
|
||||
<Warning>
|
||||
**Виклик інструментів у режимі сумісності з OpenAI працює ненадійно.** Використовуйте цей режим лише тоді, коли вам потрібен формат OpenAI для проксі і ви не залежите від нативної поведінки виклику інструментів.
|
||||
**Виклик інструментів ненадійний у OpenAI-сумісному режимі.** Використовуйте цей режим лише якщо вам потрібен формат OpenAI для проксі і ви не залежите від нативної поведінки виклику інструментів.
|
||||
</Warning>
|
||||
|
||||
Якщо вам потрібно натомість використовувати endpoint, сумісний з OpenAI (наприклад, за проксі, який підтримує лише формат OpenAI), явно встановіть `api: "openai-completions"`:
|
||||
Якщо вам натомість потрібно використовувати OpenAI-сумісну кінцеву точку (наприклад, за проксі, який підтримує лише формат OpenAI), явно встановіть `api: "openai-completions"`:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -372,7 +372,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
|
||||
ollama: {
|
||||
baseUrl: "http://ollama-host:11434/v1",
|
||||
api: "openai-completions",
|
||||
injectNumCtxForOpenAICompat: true, // default: true
|
||||
injectNumCtxForOpenAICompat: true, // типово: true
|
||||
apiKey: "ollama-local",
|
||||
models: [...]
|
||||
}
|
||||
@ -381,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
|
||||
{
|
||||
@ -404,7 +404,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Контекстні вікна">
|
||||
Для автоматично виявлених моделей OpenClaw використовує контекстне вікно, про яке повідомляє Ollama, якщо воно доступне, інакше повертається до типового контекстного вікна Ollama, яке використовує OpenClaw.
|
||||
Для автоматично виявлених моделей OpenClaw використовує контекстне вікно, про яке повідомляє Ollama, коли воно доступне, зокрема більші значення `PARAMETER num_ctx` із власних Modelfile. В іншому разі він повертається до типового контекстного вікна Ollama, яке використовує OpenClaw.
|
||||
|
||||
Ви можете перевизначити `contextWindow` і `maxTokens` у явній конфігурації провайдера:
|
||||
|
||||
@ -429,32 +429,32 @@ 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
|
||||
```
|
||||
|
||||
Жодна додаткова конфігурація не потрібна — OpenClaw позначає їх автоматично.
|
||||
Жодної додаткової конфігурації не потрібно — OpenClaw позначає їх автоматично.
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Вартість моделей">
|
||||
Ollama є безкоштовним і працює локально, тому вартість усіх моделей встановлено на рівні $0. Це стосується як автоматично виявлених, так і вручну визначених моделей.
|
||||
Ollama є безкоштовним і працює локально, тому вартість усіх моделей встановлюється в $0. Це стосується як автоматично виявлених, так і вручну визначених моделей.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Вбудовування пам’яті">
|
||||
Вбудований Plugin Ollama реєструє провайдера вбудовувань пам’яті для
|
||||
[пошуку в пам’яті](/uk/concepts/memory). Він використовує налаштовані базовий URL
|
||||
та ключ API Ollama, викликає поточний endpoint `/api/embed` Ollama і
|
||||
за можливості об’єднує кілька фрагментів пам’яті в один запит `input`.
|
||||
<Accordion title="Ембедінги пам’яті">
|
||||
Вбудований Plugin Ollama реєструє провайдера ембедінгів пам’яті для
|
||||
[пошуку в пам’яті](/uk/concepts/memory). Він використовує налаштовані базову URL-адресу Ollama
|
||||
та ключ API, викликає поточну кінцеву точку Ollama `/api/embed` і групує
|
||||
кілька фрагментів пам’яті в один запит `input`, коли це можливо.
|
||||
|
||||
| Властивість | Значення |
|
||||
| --------------- | ------------------- |
|
||||
| Модель за замовчуванням | `nomic-embed-text` |
|
||||
| Автозавантаження | Так — модель вбудовувань автоматично завантажується, якщо її немає локально |
|
||||
| Властивість | Значення |
|
||||
| -------------- | ------------------- |
|
||||
| Типова модель | `nomic-embed-text` |
|
||||
| Автозавантаження | Так — модель ембедінгів завантажується автоматично, якщо її немає локально |
|
||||
|
||||
Щоб вибрати Ollama як провайдера вбудовувань для пошуку в пам’яті:
|
||||
Щоб вибрати Ollama як провайдера ембедінгів для пошуку в пам’яті:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -469,18 +469,18 @@ 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` надсилають відповідний верхньорівневий рядок з інтенсивністю `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>
|
||||
Якщо вам потрібно використовувати endpoint, сумісний з OpenAI, див. розділ «Застарілий режим сумісності з OpenAI» вище. У цьому режимі потокове передавання та виклик інструментів можуть не працювати одночасно.
|
||||
Якщо вам потрібно використовувати OpenAI-сумісну кінцеву точку, дивіться розділ «Застарілий OpenAI-сумісний режим» вище. У цьому режимі потокове передавання і виклик інструментів можуть не працювати одночасно.
|
||||
</Tip>
|
||||
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Усунення проблем
|
||||
## Усунення несправностей
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Ollama не виявлено">
|
||||
@ -499,7 +499,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Немає доступних моделей">
|
||||
Якщо вашу модель не вказано у списку, або завантажте її локально, або явно визначте її в `models.providers.ollama`.
|
||||
Якщо вашої моделі немає у списку, або завантажте її локально, або визначте її явно в `models.providers.ollama`.
|
||||
|
||||
```bash
|
||||
ollama list # Подивитися, що встановлено
|
||||
@ -511,7 +511,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="У з’єднанні відмовлено">
|
||||
Перевірте, що Ollama працює на правильному порту:
|
||||
Перевірте, що Ollama запущено на правильному порту:
|
||||
|
||||
```bash
|
||||
# Перевірити, чи запущено Ollama
|
||||
@ -525,22 +525,22 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
|
||||
</AccordionGroup>
|
||||
|
||||
<Note>
|
||||
Більше допомоги: [Усунення проблем](/uk/help/troubleshooting) і [FAQ](/uk/help/faq).
|
||||
Більше довідки: [Усунення несправностей](/uk/help/troubleshooting) і [ЧаПи](/uk/help/faq).
|
||||
</Note>
|
||||
|
||||
## Пов’язане
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
|
||||
Огляд усіх провайдерів, посилань на моделі та поведінки перемикання при збоях.
|
||||
Огляд усіх провайдерів, посилань на моделі та поведінки перемикання при відмові.
|
||||
</Card>
|
||||
<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="Конфігурація" href="/uk/gateway/configuration" icon="gear">
|
||||
Повний довідник з конфігурації.
|
||||
Повний довідник із конфігурації.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user