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 01:12:42 +00:00
parent e6cad7a375
commit d1766e5d39
4 changed files with 366 additions and 316 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -1,50 +1,50 @@
---
read_when:
- Ви хочете запустити OpenClaw із хмарними або локальними моделями через Ollama
- Вам потрібні вказівки щодо налаштування та конфігурації Ollama
- Ви хочете використовувати візійні моделі Ollama для розпізнавання зображень
- Вам потрібні вказівки з налаштування та конфігурації Ollama
- Ви хочете використовувати візуальні моделі Ollama для розуміння зображень
summary: Запустіть OpenClaw з Ollama (хмарні та локальні моделі)
title: Ollama
x-i18n:
generated_at: "2026-04-27T00:05:56Z"
generated_at: "2026-04-27T01:11:27Z"
model: gpt-5.4
provider: openai
source_hash: d035b17148e4b049765db2b3b572fe61085d2d18df4e921b328b20f57acf5ce0
source_hash: 5bb8f968bd936c107e21b9286257573a2f2b88cfa1a4da232e87a0f86654c4d0
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**: Не використовуйте URL `/v1`, сумісний з OpenAI (`http://host:11434/v1`), з OpenClaw. Це ламає виклик інструментів, і моделі можуть виводити сирий JSON інструментів як звичайний текст. Натомість використовуйте URL нативного API Ollama: `baseUrl: "http://host:11434"` (без `/v1`).
</Warning>
## Початок роботи
Оберіть бажаний спосіб і режим налаштування.
Виберіть бажаний спосіб налаштування та режим.
<Tabs>
<Tab title="Onboarding (recommended)">
**Найкраще для:** найшвидшого способу отримати робоче налаштування Ollama cloud або local.
<Tab title="Початкове налаштування (рекомендовано)">
**Найкраще для:** найшвидшого способу отримати робоче хмарне або локальне налаштування Ollama.
<Steps>
<Step title="Запустіть onboarding">
<Step title="Запустіть початкове налаштування">
```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
```
@ -59,7 +59,7 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
--accept-risk
```
За потреби вкажіть власний базовий URL або модель:
За бажанням можна вказати власний базовий URL або модель:
```bash
openclaw onboard --non-interactive \
@ -72,15 +72,15 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
</Tab>
<Tab title="Ручне налаштування">
**Найкраще для:** повного контролю над налаштуванням cloud або local.
**Найкраще для:** повного контролю над хмарним або локальним налаштуванням.
<Steps>
<Step title="Оберіть cloud або 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)
- **Local only**: установіть Ollama з [ollama.com/download](https://ollama.com/download)
</Step>
<Step title="Завантажте локальну модель (лише local)">
<Step title="Завантажте локальну модель (лише локальний режим)">
```bash
ollama pull gemma4
# або
@ -96,10 +96,10 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
# Хмара
export OLLAMA_API_KEY="your-ollama-api-key"
# Лише local
# Лише локально
export OLLAMA_API_KEY="ollama-local"
# Або налаштуйте у своєму файлі конфігурації
# Або налаштуйте у своєму конфігураційному файлі
openclaw config set models.providers.ollama.apiKey "OLLAMA_API_KEY"
```
</Step>
@ -109,7 +109,7 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`)
openclaw models set ollama/gemma4
```
Або встановіть типову модель у конфігурації:
Або встановіть значення за замовчуванням у конфігурації:
```json5
{
@ -130,45 +130,45 @@ 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 повертається до попередніх жорстко закодованих пропозицій, щоб onboarding усе одно завершився.
Список хмарних моделей, показаний під час `openclaw onboard`, заповнюється в реальному часі з `https://ollama.com/api/tags` і обмежується 500 записами, тому засіб вибору відображає поточний розміщений каталог, а не статичний набір. Якщо `ollama.com` недоступний або не повертає моделей на момент налаштування, OpenClaw повертається до попередніх жорстко закодованих пропозицій, щоб початкове налаштування все одно завершилося.
</Tab>
<Tab title="Local only">
У режимі лише локального використання OpenClaw виявляє моделі з налаштованого екземпляра Ollama. Цей шлях призначений для локальних або самостійно розміщених серверів Ollama.
У режимі лише локального використання 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 автоматично додає зображення в запит |
| Виявлення 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
# Подивіться, які моделі доступні
@ -185,12 +185,12 @@ 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="Базова (неявне виявлення)">
Найпростіший шлях увімкнення лише 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
{
@ -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,19 +325,19 @@ OpenClaw відхиляє запити на опис зображень для
}
```
Також підтримуються власні ідентифікатори провайдера Ollama. Коли посилання на модель використовує префікс активного провайдера, наприклад `ollama-spark/qwen3:32b`, OpenClaw прибирає лише цей префікс перед викликом Ollama, щоб сервер отримав `qwen3:32b`.
Також підтримуються власні ідентифікатори провайдера Ollama. Коли посилання на модель використовує префікс активного провайдера, наприклад `ollama-spark/qwen3:32b`, OpenClaw видаляє лише цей префікс перед викликом Ollama, щоб сервер отримав `qwen3:32b`.
## Веб-пошук Ollama
## Вебпошук Ollama
OpenClaw підтримує **Ollama Web Search** як вбудований провайдер `web_search`.
| Властивість | Докладно |
| ----------- | ----------------------------------------------------------------------------------------------------------------------- |
| Хост | Використовує налаштований вами хост Ollama (`models.providers.ollama.baseUrl`, якщо задано, інакше `http://127.0.0.1:11434`) |
| Автентифікація | Без ключа |
| Вимога | Ollama має бути запущений, і в ньому має бути виконано вхід через `ollama signin` |
| Властивість | Деталі |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Хост | Використовує налаштований вами хост 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 Web Search** під час `openclaw onboard` або `openclaw configure --section web`, або задайте:
Виберіть **Ollama Web Search** під час `openclaw onboard` або `openclaw configure --section web`, або встановіть:
```json5
{
@ -360,10 +360,10 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
<AccordionGroup>
<Accordion title="Застарілий режим сумісності з OpenAI">
<Warning>
**Виклик інструментів у режимі сумісності з OpenAI працює ненадійно.** Використовуйте цей режим лише якщо вам потрібен формат OpenAI для проксі й ви не залежите від нативної поведінки виклику інструментів.
**Виклик інструментів у режимі сумісності з OpenAI працює ненадійно.** Використовуйте цей режим лише тоді, коли вам потрібен формат OpenAI для проксі і ви не залежите від нативної поведінки виклику інструментів.
</Warning>
Якщо вам потрібно використовувати натомість endpoint, сумісний з OpenAI (наприклад, за проксі, який підтримує лише формат OpenAI), явно задайте `api: "openai-completions"`:
Якщо вам потрібно натомість використовувати endpoint, сумісний з 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, // типово: true
injectNumCtxForOpenAICompat: true, // default: 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, якщо воно доступне, інакше повертається до типового контекстного вікна Ollama, яке використовує OpenClaw.
Ви можете перевизначити `contextWindow` і `maxTokens` у явній конфігурації провайдера:
@ -429,29 +429,29 @@ 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 Ollama `/api/embed` і за
можливості об’єднує кілька фрагментів пам’яті в один запит `input`.
та ключ API Ollama, викликає поточний endpoint `/api/embed` Ollama і
за можливості об’єднує кілька фрагментів пам’яті в один запит `input`.
| Властивість | Значення |
| -------------- | ------------------- |
| Типова модель | `nomic-embed-text` |
| Властивість | Значення |
| --------------- | ------------------- |
| Модель за замовчуванням | `nomic-embed-text` |
| Автозавантаження | Так — модель вбудовувань автоматично завантажується, якщо її немає локально |
Щоб вибрати Ollama як провайдера вбудовувань для пошуку в пам’яті:
@ -468,29 +468,29 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
</Accordion>
<Accordion title="Конфігурація потокової передачі">
Інтеграція OpenClaw з Ollama типово використовує **нативний API Ollama** (`/api/chat`), який повністю підтримує одночасно потокову передачу та виклик інструментів. Жодної спеціальної конфігурації не потрібно.
<Accordion title="Конфігурація потокового передавання">
Інтеграція Ollama в OpenClaw за замовчуванням використовує **нативний 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` надсилають відповідний верхньорівневий рядок з інтенсивністю `think`. `/think max` зіставляється з найвищою нативною інтенсивністю Ollama, `think: "high"`.
<Tip>
Якщо вам потрібно використовувати endpoint, сумісний з OpenAI, див. розділ «Застарілий режим сумісності з OpenAI» вище. У цьому режимі потокова передача та виклик інструментів можуть не працювати одночасно.
Якщо вам потрібно використовувати endpoint, сумісний з OpenAI, див. розділ «Застарілий режим сумісності з OpenAI» вище. У цьому режимі потокове передавання та виклик інструментів можуть не працювати одночасно.
</Tip>
</Accordion>
</AccordionGroup>
## Усунення несправностей
## Усунення проблем
<AccordionGroup>
<Accordion title="Ollama не виявлено">
Переконайтеся, що Ollama запущено, що ви задали `OLLAMA_API_KEY` (або профіль автентифікації) і що ви **не** визначили явний запис `models.providers.ollama`:
Переконайтеся, що Ollama запущено, що ви встановили `OLLAMA_API_KEY` (або профіль автентифікації), і що ви **не** визначили явний запис `models.providers.ollama`:
```bash
ollama serve
```
Переконайтеся, що API доступний:
Перевірте, що API доступний:
```bash
curl http://localhost:11434/api/tags
@ -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,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,12 +535,12 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
Огляд усіх провайдерів, посилань на моделі та поведінки перемикання при збоях.
</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>

139
docs/uk/reference/api-usage-costs.md
View File

@ -2,94 +2,95 @@
read_when:
- Ви хочете зрозуміти, які функції можуть викликати платні API
- Вам потрібно перевірити ключі, витрати та видимість використання
- Ви пояснюєте звітність про витрати у /status або /usage
summary: Перевірте, що може витрачати гроші, які ключі використовуються та як переглянути використання
- Ви пояснюєте звітування про витрати у /status або /usage
summary: Перевірте, що може витрачати кошти, які ключі використовуються та як переглянути використання
title: Використання API та витрати
x-i18n:
generated_at: "2026-04-24T20:38:04Z"
generated_at: "2026-04-27T01:11:39Z"
model: gpt-5.4
provider: openai
source_hash: 2958c0961b46961d942a5bb6e7954eda6bf3d0f659ae0bffb390a8502e00ff38
source_hash: d61fb753442d3be6987877c296238c350d81fcaa8f785f3f33c23463b7831836
source_path: reference/api-usage-costs.md
workflow: 15
---
# Використання API та витрати
У цьому документі перелічено **функції, які можуть викликати API-ключі**, і де відображаються їхні витрати. Він зосереджений на
У цьому документі перелічено **функції, які можуть використовувати API-ключі**, і де відображаються їхні витрати. Він зосереджений на
функціях OpenClaw, які можуть генерувати використання провайдера або платні виклики API.
## Де відображаються витрати (чат + CLI)
**Знімок витрат за сесію**
**Миттєвий знімок вартості за сеанс**
- `/status` показує поточну модель сесії, використання контексту та токени останньої відповіді.
- Якщо модель використовує **автентифікацію API-ключем**, `/status` також показує **орієнтовну вартість** останньої відповіді.
- Якщо метадані live-сесії неповні, `/status` може відновити лічильники токенів/кешу
та мітку активної runtime-моделі з останнього запису використання в транскрипті.
Наявні ненульові live-значення все одно мають пріоритет, а підсумки транскрипту
розміру prompt можуть мати перевагу, коли збережені підсумки відсутні або менші.
- `/status` показує поточну модель сеансу, використання контексту та токени останньої відповіді.
- Якщо модель використовує **автентифікацію через API-ключ**, `/status` також показує **орієнтовну вартість** останньої відповіді.
- Якщо метадані живого сеансу обмежені, `/status` може відновити лічильники
токенів/кешу та мітку активної моделі середовища виконання з останнього запису
про використання в транскрипті. Наявні ненульові живі значення все ще мають
пріоритет, а підсумки транскрипту розміру запиту можуть мати перевагу, якщо
збережені підсумки відсутні або менші.
**Нижній колонтитул витрат для кожного повідомлення**
**Нижній колонтитул вартості для кожного повідомлення**
- `/usage full` додає нижній колонтитул використання до кожної відповіді, включно з **орієнтовною вартістю** (лише для API-ключа).
- `/usage tokens` показує лише токени; OAuth/token-потоки у стилі підписки та CLI-потоки приховують вартість у доларах.
- Примітка Gemini CLI: коли CLI повертає JSON-вивід, OpenClaw зчитує використання з
`stats`, нормалізує `stats.cached` у `cacheRead` і за потреби виводить вхідні токени
з `stats.input_tokens - stats.cached`.
- `/usage tokens` показує лише токени; потоки OAuth/токенів у стилі підписки та CLI приховують вартість у доларах.
- Примітка щодо Gemini CLI: коли CLI повертає вивід JSON, OpenClaw зчитує використання з
`stats`, нормалізує `stats.cached` у `cacheRead` і виводить вхідні токени з
`stats.input_tokens - stats.cached`, коли це потрібно.
Примітка Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI
у стилі OpenClaw знову дозволене, тому OpenClaw вважає повторне використання Claude CLI
та використання `claude -p` санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику.
Anthropic усе ще не надає оцінку вартості в доларах для кожного повідомлення, яку OpenClaw міг би
Примітка щодо Anthropic: співробітники Anthropic повідомили нам, що використання Claude CLI у стилі OpenClaw
знову дозволене, тому OpenClaw вважає повторне використання Claude CLI та використання `claude -p`
санкціонованими для цієї інтеграції, якщо Anthropic не опублікує нову політику.
Anthropic досі не надає оцінку вартості в доларах для кожного повідомлення, яку OpenClaw міг би
показувати в `/usage full`.
**Вікна використання CLI (квоти провайдера)**
- `openclaw status --usage` і `openclaw channels list` показують **вікна використання**
провайдера (знімки квот, а не витрати на кожне повідомлення).
- Зрозумілий для людини вивід нормалізується до `X% left` для всіх провайдерів.
- Поточні провайдери з вікнами використання: Anthropic, GitHub Copilot, Gemini CLI,
провайдера (знімки квот, а не витрати на окремі повідомлення).
- Зручний для людини вивід нормалізується до `X% left` для всіх провайдерів.
- Поточні провайдери вікон використання: Anthropic, GitHub Copilot, Gemini CLI,
OpenAI Codex, MiniMax, Xiaomi та z.ai.
- Примітка MiniMax: його сирі поля `usage_percent` / `usagePercent` означають квоту, що
залишилася, тому OpenClaw інвертує їх перед відображенням. Поля на основі лічильників
усе одно мають пріоритет, якщо вони присутні. Якщо провайдер повертає `model_remains`,
OpenClaw надає перевагу запису chat-моделі, за потреби виводить мітку вікна з часових міток
- Примітка щодо MiniMax: його сирі поля `usage_percent` / `usagePercent` означають
залишок квоти, тому OpenClaw інвертує їх перед відображенням. Поля на основі кількості
все ще мають пріоритет, якщо вони присутні. Якщо провайдер повертає `model_remains`, OpenClaw надає перевагу
запису моделі чату, за потреби виводить мітку вікна з часових міток
і включає назву моделі до мітки плану.
- Автентифікація використання для цих вікон квот надходить із provider-specific hooks, коли вони
доступні; інакше OpenClaw повертається до відповідних OAuth/API-key
облікових даних з auth profiles, змінних середовища або config.
- Автентифікація використання для цих вікон квот надходить із специфічних для провайдера хуків, коли вони доступні;
інакше OpenClaw використовує резервний варіант — підбір облікових даних OAuth/API-ключа
з профілів автентифікації, змінних середовища або конфігурації.
Див. [Використання токенів і витрати](/uk/reference/token-use) для подробиць і прикладів.
## Як виявляються ключі
OpenClaw може підхоплювати облікові дані з:
OpenClaw може отримувати облікові дані з:
- **Профілів автентифікації** (для кожного агента, зберігаються в `auth-profiles.json`).
- **Змінних середовища** (наприклад, `OPENAI_API_KEY`, `BRAVE_API_KEY`, `FIRECRAWL_API_KEY`).
- **Config** (`models.providers.*.apiKey`, `plugins.entries.*.config.webSearch.apiKey`,
- **Конфігурації** (`models.providers.*.apiKey`, `plugins.entries.*.config.webSearch.apiKey`,
`plugins.entries.firecrawl.config.webFetch.apiKey`, `memorySearch.*`,
`talk.providers.*.apiKey`).
- **Skills** (`skills.entries.<name>.apiKey`), які можуть експортувати ключі до env процесу skill.
- **Skills** (`skills.entries.<name>.apiKey`), які можуть експортувати ключі до середовища процесу skill.
## Функції, які можуть витрачати ключі
### 1) Відповіді основної моделі (чат + інструменти)
### 1) Основні відповіді моделі (чат + інструменти)
Кожна відповідь або виклик інструмента використовує **поточного провайдера моделі** (OpenAI, Anthropic тощо). Це
основне джерело використання та витрат.
Сюди також входять хостингові провайдери у стилі підписки, які все одно виставляють рахунки поза
локальним UI OpenClaw, такі як **OpenAI Codex**, **Alibaba Cloud Model Studio
Сюди також входять розміщені провайдери в стилі підписки, які все одно виставляють рахунки поза
локальним UI OpenClaw, наприклад **OpenAI Codex**, **Alibaba Cloud Model Studio
Coding Plan**, **MiniMax Coding Plan**, **Z.AI / GLM Coding Plan** та
шлях входу Anthropic OpenClaw Claude з увімкненим **Extra Usage**.
шлях входу Claude від Anthropic у OpenClaw з увімкненим **Extra Usage**.
Див. [Моделі](/uk/providers/models) для config ціноутворення та [Використання токенів і витрати](/uk/reference/token-use) для відображення.
Див. [Моделі](/uk/providers/models) для конфігурації цін і [Використання токенів і витрати](/uk/reference/token-use) для відображення.
### 2) Розуміння медіа (аудіо/зображення/відео)
Вхідні медіа можуть бути підсумовані/транскрибовані до виконання відповіді. Для цього використовуються API моделі/провайдера.
Вхідні медіа можуть бути підсумовані/транскрибовані до запуску відповіді. Для цього використовуються API моделей/провайдерів.
- Аудіо: OpenAI / Groq / Deepgram / Google / Mistral.
- Зображення: OpenAI / OpenRouter / Anthropic / Google / MiniMax / Moonshot / Qwen / Z.AI.
@ -99,14 +100,14 @@ Coding Plan**, **MiniMax Coding Plan**, **Z.AI / GLM Coding Plan** та
### 3) Генерація зображень і відео
Спільні можливості генерації також можуть витрачати ключі провайдера:
Спільні можливості генерації також можуть витрачати ключі провайдерів:
- Генерація зображень: OpenAI / Google / fal / MiniMax
- Генерація відео: Qwen
Генерація зображень може виводити auth-backed provider за замовчуванням, якщо
Генерація зображень може визначати типовий провайдер із автентифікацією, якщо
`agents.defaults.imageGenerationModel` не задано. Генерація відео наразі
вимагає явного `agents.defaults.videoGenerationModel`, наприклад
потребує явного `agents.defaults.videoGenerationModel`, наприклад
`qwen/wan2.6-t2v`.
Див. [Генерація зображень](/uk/tools/image-generation), [Qwen Cloud](/uk/providers/qwen)
@ -114,23 +115,23 @@ Coding Plan**, **MiniMax Coding Plan**, **Z.AI / GLM Coding Plan** та
### 4) Ембедінги пам’яті + семантичний пошук
Семантичний пошук у пам’яті використовує **API ембедінгів**, коли налаштований для віддалених провайдерів:
Семантичний пошук у пам’яті використовує **API ембедінгів**, якщо налаштовано віддалені провайдери:
- `memorySearch.provider = "openai"` → ембедінги OpenAI
- `memorySearch.provider = "gemini"` → ембедінги Gemini
- `memorySearch.provider = "voyage"` → ембедінги Voyage
- `memorySearch.provider = "mistral"` → ембедінги Mistral
- `memorySearch.provider = "lmstudio"` → ембедінги LM Studio (локально/self-hosted)
- `memorySearch.provider = "ollama"` → ембедінги Ollama (локально/self-hosted; зазвичай без тарифікації hosted API)
- Необов’язковий fallback до віддаленого провайдера, якщо локальні ембедінги не працюють
- `memorySearch.provider = "lmstudio"` → ембедінги LM Studio (локально/самостійний хостинг)
- `memorySearch.provider = "ollama"` → ембедінги Ollama (локально/самостійний хостинг; зазвичай без оплати розміщеного API)
- Необов’язковий резервний перехід до віддаленого провайдера, якщо локальні ембедінги не спрацьовують
Ви можете залишити це локальним за допомогою `memorySearch.provider = "local"` (без використання API).
Ви можете залишити все локально за допомогою `memorySearch.provider = "local"` (без використання API).
Див. [Пам’ять](/uk/concepts/memory).
### 5) Інструмент вебпошуку
`web_search` може спричиняти плату за використання залежно від вашого провайдера:
`web_search` може спричиняти списання за використання залежно від вашого провайдера:
- **Brave Search API**: `BRAVE_API_KEY` або `plugins.entries.brave.config.webSearch.apiKey`
- **Exa**: `EXA_API_KEY` або `plugins.entries.exa.config.webSearch.apiKey`
@ -139,18 +140,18 @@ Coding Plan**, **MiniMax Coding Plan**, **Z.AI / GLM Coding Plan** та
- **Grok (xAI)**: `XAI_API_KEY` або `plugins.entries.xai.config.webSearch.apiKey`
- **Kimi (Moonshot)**: `KIMI_API_KEY`, `MOONSHOT_API_KEY` або `plugins.entries.moonshot.config.webSearch.apiKey`
- **MiniMax Search**: `MINIMAX_CODE_PLAN_KEY`, `MINIMAX_CODING_API_KEY`, `MINIMAX_API_KEY` або `plugins.entries.minimax.config.webSearch.apiKey`
- **Ollama Web Search**: за замовчуванням без ключа, але потребує доступного хоста Ollama плюс `ollama signin`; також може повторно використовувати звичайну bearer-автентифікацію провайдера Ollama, якщо хост її вимагає
- **Ollama Web Search**: без ключа для доступного локального хоста Ollama із виконаним входом; прямий пошук через `https://ollama.com` використовує `OLLAMA_API_KEY`, а хости, захищені автентифікацією, можуть повторно використовувати звичайну bearer-автентифікацію провайдера Ollama
- **Perplexity Search API**: `PERPLEXITY_API_KEY`, `OPENROUTER_API_KEY` або `plugins.entries.perplexity.config.webSearch.apiKey`
- **Tavily**: `TAVILY_API_KEY` або `plugins.entries.tavily.config.webSearch.apiKey`
- **DuckDuckGo**: fallback без ключа (без тарифікації API, але неофіційний і на основі HTML)
- **SearXNG**: `SEARXNG_BASE_URL` або `plugins.entries.searxng.config.webSearch.baseUrl` (без ключа/self-hosted; без тарифікації hosted API)
- **DuckDuckGo**: резервний варіант без ключа (без оплати API, але неофіційний і на основі HTML)
- **SearXNG**: `SEARXNG_BASE_URL` або `plugins.entries.searxng.config.webSearch.baseUrl` (без ключа/самостійний хостинг; без оплати розміщеного API)
Застарілі шляхи провайдера `tools.web.search.*` усе ще завантажуються через тимчасовий shim сумісності, але вони більше не є рекомендованою поверхнею config.
Застарілі шляхи провайдера `tools.web.search.*` усе ще завантажуються через тимчасовий шар сумісності, але це вже не рекомендована поверхня конфігурації.
**Безплатний кредит Brave Search:** кожен тарифний план Brave включає кредит
\$5/місяць, який поновлюється. Тариф Search коштує \$5 за 1 000 запитів, тож кредит покриває
1 000 запитів/місяць без оплати. Установіть ліміт використання в панелі керування Brave,
щоб уникнути неочікуваних витрат.
**Безплатний кредит Brave Search:** Кожен план Brave включає \$5/місяць поновлюваного
безплатного кредиту. План Search коштує \$5 за 1 000 запитів, тож цей кредит покриває
1 000 запитів/місяць без оплати. Установіть свій ліміт використання в панелі керування Brave,
щоб уникнути неочікуваних списань.
Див. [Вебінструменти](/uk/tools/web).
@ -160,37 +161,37 @@ Coding Plan**, **MiniMax Coding Plan**, **Z.AI / GLM Coding Plan** та
- `FIRECRAWL_API_KEY` або `plugins.entries.firecrawl.config.webFetch.apiKey`
Якщо Firecrawl не налаштований, інструмент повертається до прямого fetch разом із вбудованим plugin `web-readability` (без платного API). Вимкніть `plugins.entries.web-readability.enabled`, щоб пропустити локальне вилучення Readability.
Якщо Firecrawl не налаштовано, інструмент використовує резервний варіант — пряме отримання плюс вбудований Plugin `web-readability` (без платного API). Вимкніть `plugins.entries.web-readability.enabled`, щоб пропустити локальне витягування Readability.
Див. [Вебінструменти](/uk/tools/web).
### 6) Знімки використання провайдера (status/health)
Деякі команди status викликають **ендпоїнти використання провайдера**, щоб показати вікна квот або стан автентифікації.
Зазвичай це виклики з невеликим обсягом, але вони все одно звертаються до API провайдера:
Деякі команди статусу викликають **кінцеві точки використання провайдера**, щоб показувати вікна квот або стан автентифікації.
Зазвичай це виклики з малим обсягом, але вони все одно звертаються до API провайдера:
- `openclaw status --usage`
- `openclaw models status --json`
Див. [CLI моделей](/uk/cli/models).
### 7) Захисне підсумовування Compaction
### 7) Підсумовування захисту Compaction
Захисний механізм Compaction може підсумовувати історію сесії за допомогою **поточної моделі**, що
викликає API провайдера під час виконання.
Захист Compaction може підсумовувати історію сеансу за допомогою **поточної моделі**, що
викликає API провайдера під час роботи.
Див. [Керування сесією + Compaction](/uk/reference/session-management-compaction).
Див. [Керування сеансом + Compaction](/uk/reference/session-management-compaction).
### 8) Сканування / probe моделей
### 8) Сканування / перевірка моделі
`openclaw models scan` може виконувати probe моделей OpenRouter і використовує `OPENROUTER_API_KEY`, коли
probe увімкнено.
`openclaw models scan` може перевіряти моделі OpenRouter і використовує `OPENROUTER_API_KEY`, коли
перевірку ввімкнено.
Див. [CLI моделей](/uk/cli/models).
### 9) Talk (мовлення)
Режим Talk може викликати **ElevenLabs**, якщо налаштований:
Режим Talk може викликати **ElevenLabs**, якщо налаштовано:
- `ELEVENLABS_API_KEY` або `talk.providers.elevenlabs.apiKey`
@ -206,5 +207,5 @@ API, це може спричиняти витрати відповідно до
## Пов’язане
- [Використання токенів і витрати](/uk/reference/token-use)
- [Кешування prompt](/uk/reference/prompt-caching)
- [Кешування запитів](/uk/reference/prompt-caching)
- [Відстеження використання](/uk/concepts/usage-tracking)

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

@ -1,29 +1,33 @@
---
read_when:
- Ви хочете використовувати Ollama для `web_search`
- Ви хочете постачальника `web_search` без ключа
- Вам потрібен постачальник `web_search` без ключа
- Ви хочете використовувати розміщений вебпошук Ollama з `OLLAMA_API_KEY`
- Вам потрібні вказівки з налаштування вебпошуку Ollama
summary: Вебпошук Ollama через ваш налаштований хост Ollama
summary: Вебпошук Ollama через локальний хост Ollama або розміщений API Ollama
title: вебпошук Ollama
x-i18n:
generated_at: "2026-04-27T00:14:08Z"
generated_at: "2026-04-27T01:11:28Z"
model: gpt-5.4
provider: openai
source_hash: cd8f2c8411c9a9ef4c1d6499edd2496e5f23172e7d94c3e38336986337aa353e
source_hash: 2c20b2405dab06f091ed636a8cc1f5e85a2f9e7ac62489db28c8f9ec9fee8357
source_path: tools/ollama-search.md
workflow: 15
---
OpenClaw підтримує **Ollama Web Search** як вбудованого постачальника `web_search`. Він
OpenClaw підтримує **вебпошук Ollama** як вбудованого постачальника `web_search`. Він
використовує API вебпошуку Ollama і повертає структуровані результати із заголовками, URL-адресами
та фрагментами.
На відміну від постачальника моделей Ollama, це налаштування типово не потребує API-ключа.
Однак потрібні:
Для локального або самостійно розгорнутого Ollama це налаштування
типово не потребує API-ключа. Проте потрібні:
- хост Ollama, до якого OpenClaw має доступ
- `ollama signin`
Для прямого розміщеного пошуку встановіть базову URL-адресу постачальника Ollama на `https://ollama.com`
і вкажіть справжній `OLLAMA_API_KEY`.
## Налаштування
<Steps>
@ -38,20 +42,20 @@ 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 повторно
використовує той самий налаштований хост.
## Конфігурація
@ -69,6 +73,25 @@ OpenClaw підтримує **Ollama Web Search** як вбудованого п
Необов’язкове перевизначення хоста Ollama:
```json5
{
plugins: {
entries: {
ollama: {
config: {
webSearch: {
baseUrl: "http://ollama-host:11434",
},
},
},
},
},
}
```
Якщо ви вже налаштували Ollama як постачальника моделей, постачальник вебпошуку
може повторно використовувати цей хост:
```json5
{
models: {
@ -81,30 +104,55 @@ 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)
для запитів до цього налаштованого хоста.
Прямий розміщений вебпошук Ollama:
```json5
{
models: {
providers: {
ollama: {
baseUrl: "https://ollama.com",
apiKey: "OLLAMA_API_KEY",
},
},
},
tools: {
web: {
search: {
provider: "ollama",
},
},
},
}
```
## Примітки
- Для цього постачальника не потрібне окреме поле API-ключа для вебпошуку.
- Якщо хост Ollama захищено автентифікацією, OpenClaw повторно використовує звичайний
API-ключ постачальника Ollama, якщо він є.
- Для цього постачальника не потрібне окреме поле API-ключа саме для вебпошуку.
- Якщо хост 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`, не надсилаючи
OpenClaw може повернутися до `https://ollama.com/api/web_search`, не надсилаючи
цей env-ключ на локальний хост.
- Під час налаштування OpenClaw попереджає, якщо Ollama недоступний або вхід не виконано, але
це не блокує вибір.
- Автовиявлення під час виконання може перейти до Ollama Web Search, якщо не налаштовано
жодного постачальника з обліковими даними вищого пріоритету.
- Хости локального демона Ollama використовують локальну проксі-кінцеву точку
- OpenClaw попереджає під час налаштування, якщо Ollama недоступний або в нього не виконано вхід,
але це не блокує вибір.
- Автовиявлення під час виконання може переключитися на вебпошук Ollama, якщо не налаштовано
жодного постачальника з вищим пріоритетом і обліковими даними.
- Локальні хости демона Ollama використовують локальну проксі-кінцеву точку
`/api/experimental/web_search`, яка підписує та пересилає запити до Ollama Cloud.
- Хости `https://ollama.com` використовують загальнодоступну розміщену кінцеву точку
- Хости `https://ollama.com` використовують публічну розміщену кінцеву точку
`/api/web_search` безпосередньо з bearer-автентифікацією через API-ключ.
## Пов’язане
- [Огляд вебпошуку](/uk/tools/web) -- усі постачальники та автовиявлення
- [Ollama](/uk/providers/ollama) -- налаштування моделей Ollama і хмарний/локальний режими
- [Ollama](/uk/providers/ollama) -- налаштування моделей Ollama та хмарний/локальний режими

275
docs/uk/tools/web.md
View File

@ -1,51 +1,49 @@
---
read_when:
- Ви хочете ввімкнути або налаштувати `web_search`
- Ви хочете ввімкнути або налаштувати `x_search`
- Вам потрібно вибрати пошукового провайдера
- |-
Ви хочете зрозуміти автовизначення і fallback провайдерів +#+#+#+#+#+analysis to=functions.read 】【。】【commentary 天天中彩票是不是json
{"path":"/home/runner/work/docs/docs/source/scripts/docs-i18n","offset":1,"limit":10}
- Ви хочете ввімкнути або налаштувати web_search
- Ви хочете ввімкнути або налаштувати x_search
- Вам потрібно вибрати постачальника пошуку
- Ви хочете зрозуміти авто виявлення та резервне перемикання на постачальника
sidebarTitle: Web Search
summary: '`web_search`, `x_search` і `web_fetch` — шукайте в інтернеті, у дописах X або отримуйте вміст сторінок'
title: Вебпошук
summary: web_search, x_search та web_fetch — шукати в інтернеті, шукати дописи в X або отримувати вміст сторінки
title: Пошук у вебі
x-i18n:
generated_at: "2026-04-23T21:18:08Z"
generated_at: "2026-04-27T01:11:29Z"
model: gpt-5.4
provider: openai
source_hash: 2713e8b13cf0f3c6bba38bee50c24771b914a5cd235ca521bed434a6ddbe2305
source_hash: db2effe661329a0bf4eb98c23a097816343819ae12dbc0f0e77fa935567eb1f0
source_path: tools/web.md
workflow: 15
---
Інструмент `web_search` виконує пошук в інтернеті за допомогою налаштованого провайдера та
повертає результати. Результати кешуються за запитом на 15 хвилин (налаштовується).
Інструмент `web_search` шукає в інтернеті за допомогою налаштованого постачальника та
повертає результати. Результати кешуються за запитом на 15 хвилин (можна налаштувати).
OpenClaw також містить `x_search` для дописів X (колишній Twitter) і
`web_fetch` для легкого отримання URL. На цьому етапі `web_fetch` залишається
OpenClaw також містить `x_search` для дописів у X (раніше Twitter) та
`web_fetch` для полегшеного отримання URL. На цьому етапі `web_fetch` залишається
локальним, тоді як `web_search` і `x_search` можуть використовувати xAI Responses під капотом.
<Info>
`web_search` — це легкий HTTP-інструмент, а не автоматизація браузера. Для
сайтів із важким JS або логінами використовуйте [Web Browser](/uk/tools/browser). Для
`web_search` — це полегшений HTTP-інструмент, а не автоматизація браузера. Для
сайтів із великою кількістю JS або входом в обліковий запис використовуйте [Web Browser](/uk/tools/browser). Для
отримання конкретного URL використовуйте [Web Fetch](/uk/tools/web-fetch).
</Info>
## Швидкий старт
<Steps>
<Step title="Виберіть провайдера">
Виберіть провайдера та виконайте всі потрібні кроки налаштування. Деякі провайдери
не потребують ключа, тоді як інші використовують API key. Докладніше див. на
сторінках провайдерів нижче.
<Step title="Виберіть постачальника">
Виберіть постачальника та виконайте всі потрібні кроки налаштування. Деякі постачальники
не потребують ключа, тоді як інші використовують API-ключі. Докладніше дивіться на
сторінках постачальників нижче.
</Step>
<Step title="Налаштуйте">
```bash
openclaw configure --section web
```
Це збереже провайдера і всі потрібні облікові дані. Ви також можете задати env
var (наприклад `BRAVE_API_KEY`) і пропустити цей крок для провайдерів,
які працюють через API.
Це збереже постачальника та всі потрібні облікові дані. Ви також можете встановити змінну середовища
(наприклад, `BRAVE_API_KEY`) і пропустити цей крок для
постачальників на основі API.
</Step>
<Step title="Використовуйте">
Тепер агент може викликати `web_search`:
@ -54,7 +52,7 @@ OpenClaw також містить `x_search` для дописів X (коли
await web_search({ query: "OpenClaw plugin SDK" });
```
Для дописів X використовуйте:
Для дописів у X використовуйте:
```javascript
await x_search({ query: "dinner recipes" });
@ -63,78 +61,78 @@ OpenClaw також містить `x_search` для дописів X (коли
</Step>
</Steps>
## Вибір провайдера
## Вибір постачальника
<CardGroup cols={2}>
<Card title="Brave Search" icon="shield" href="/uk/tools/brave-search">
Структуровані результати зі сніпетами. Підтримує режим `llm-context`, фільтри країни/мови. Доступний безкоштовний рівень.
Структуровані результати з уривками. Підтримує режим `llm-context`, фільтри країни/мови. Доступний безкоштовний тариф.
</Card>
<Card title="DuckDuckGo" icon="bird" href="/uk/tools/duckduckgo-search">
Fallback без ключа. API key не потрібен. Неофіційна інтеграція на основі HTML.
Резервний варіант без ключа. API-ключ не потрібен. Неофіційна інтеграція на основі HTML.
</Card>
<Card title="Exa" icon="brain" href="/uk/tools/exa-search">
Нейронний + ключовий пошук із витягуванням вмісту (highlights, текст, підсумки).
Нейронний + ключовий пошук із витягуванням вмісту (виділення, текст, підсумки).
</Card>
<Card title="Firecrawl" icon="flame" href="/uk/tools/firecrawl">
Структуровані результати. Найкраще працює разом із `firecrawl_search` і `firecrawl_scrape` для глибокого витягування.
Структуровані результати. Найкраще поєднувати з `firecrawl_search` і `firecrawl_scrape` для глибокого витягування.
</Card>
<Card title="Gemini" icon="sparkles" href="/uk/tools/gemini-search">
AI-синтезовані відповіді з цитатами через Google Search grounding.
Відповіді, синтезовані ШІ, з цитуваннями через Google Search grounding.
</Card>
<Card title="Grok" icon="zap" href="/uk/tools/grok-search">
AI-синтезовані відповіді з цитатами через xAI web grounding.
Відповіді, синтезовані ШІ, з цитуваннями через xAI web grounding.
</Card>
<Card title="Kimi" icon="moon" href="/uk/tools/kimi-search">
AI-синтезовані відповіді з цитатами через вебпошук Moonshot.
Відповіді, синтезовані ШІ, з цитуваннями через вебпошук Moonshot.
</Card>
<Card title="MiniMax Search" icon="globe" href="/uk/tools/minimax-search">
Структуровані результати через API пошуку MiniMax Coding Plan.
</Card>
<Card title="Ollama Web Search" icon="globe" href="/uk/tools/ollama-search">
Пошук без ключа через ваш налаштований host Ollama. Потребує `ollama signin`.
Пошук через локальний хост Ollama, у який виконано вхід, або через розміщений API Ollama.
</Card>
<Card title="Perplexity" icon="search" href="/uk/tools/perplexity-search">
Структуровані результати з керуванням витягуванням вмісту та фільтрацією доменів.
</Card>
<Card title="SearXNG" icon="server" href="/uk/tools/searxng-search">
Self-hosted meta-search. API key не потрібен. Агрегує Google, Bing, DuckDuckGo тощо.
Самостійно розміщений метапошук. API-ключ не потрібен. Агрегує Google, Bing, DuckDuckGo та інші.
</Card>
<Card title="Tavily" icon="globe" href="/uk/tools/tavily">
Структуровані результати з глибиною пошуку, фільтрацією тем і `tavily_extract` для витягування URL.
Структуровані результати з глибиною пошуку, фільтрацією за темою та `tavily_extract` для витягування URL.
</Card>
</CardGroup>
### Порівняння провайдерів
### Порівняння постачальників
| Provider | Result style | Filters | API key |
| ----------------------------------------- | -------------------------- | -------------------------------------------------- | --------------------------------------------------------------------------------- |
| [Brave](/uk/tools/brave-search) | Структуровані сніпети | Країна, мова, час, режим `llm-context` | `BRAVE_API_KEY` |
| [DuckDuckGo](/uk/tools/duckduckgo-search) | Структуровані сніпети | -- | Немає (без ключа) |
| [Exa](/uk/tools/exa-search) | Структурований + витягнутий | Режим neural/keyword, дата, витягування вмісту | `EXA_API_KEY` |
| [Firecrawl](/uk/tools/firecrawl) | Структуровані сніпети | Через інструмент `firecrawl_search` | `FIRECRAWL_API_KEY` |
| [Gemini](/uk/tools/gemini-search) | AI-синтезовані + цитати | -- | `GEMINI_API_KEY` |
| [Grok](/uk/tools/grok-search) | AI-синтезовані + цитати | -- | `XAI_API_KEY` |
| [Kimi](/uk/tools/kimi-search) | AI-синтезовані + цитати | -- | `KIMI_API_KEY` / `MOONSHOT_API_KEY` |
| [MiniMax Search](/uk/tools/minimax-search) | Структуровані сніпети | Регіон (`global` / `cn`) | `MINIMAX_CODE_PLAN_KEY` / `MINIMAX_CODING_API_KEY` |
| [Ollama Web Search](/uk/tools/ollama-search) | Структуровані сніпети | -- | Типово немає; потрібен `ollama signin`, може повторно використовувати bearer auth провайдера Ollama, якщо host його потребує |
| [Perplexity](/uk/tools/perplexity-search) | Структуровані сніпети | Країна, мова, час, домени, ліміти вмісту | `PERPLEXITY_API_KEY` / `OPENROUTER_API_KEY` |
| [SearXNG](/uk/tools/searxng-search) | Структуровані сніпети | Категорії, мова | Немає (self-hosted) |
| [Tavily](/uk/tools/tavily) | Структуровані сніпети | Через інструмент `tavily_search` | `TAVILY_API_KEY` |
| Постачальник | Стиль результатів | Фільтри | API-ключ |
| ----------------------------------------- | -------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------- |
| [Brave](/uk/tools/brave-search) | Структуровані уривки | Країна, мова, час, режим `llm-context` | `BRAVE_API_KEY` |
| [DuckDuckGo](/uk/tools/duckduckgo-search) | Структуровані уривки | -- | Немає (без ключа) |
| [Exa](/uk/tools/exa-search) | Структуровані + витягнуті | Нейронний/ключовий режим, дата, витягування | `EXA_API_KEY` |
| [Firecrawl](/uk/tools/firecrawl) | Структуровані уривки | Через інструмент `firecrawl_search` | `FIRECRAWL_API_KEY` |
| [Gemini](/uk/tools/gemini-search) | Синтезовані ШІ + цитування | -- | `GEMINI_API_KEY` |
| [Grok](/uk/tools/grok-search) | Синтезовані ШІ + цитування | -- | `XAI_API_KEY` |
| [Kimi](/uk/tools/kimi-search) | Синтезовані ШІ + цитування | -- | `KIMI_API_KEY` / `MOONSHOT_API_KEY` |
| [MiniMax Search](/uk/tools/minimax-search) | Структуровані уривки | Регіон (`global` / `cn`) | `MINIMAX_CODE_PLAN_KEY` / `MINIMAX_CODING_API_KEY` |
| [Ollama Web Search](/uk/tools/ollama-search) | Структуровані уривки | -- | Немає для локальних хостів із виконаним входом; `OLLAMA_API_KEY` для прямого пошуку `https://ollama.com` |
| [Perplexity](/uk/tools/perplexity-search) | Структуровані уривки | Країна, мова, час, домени, ліміти вмісту | `PERPLEXITY_API_KEY` / `OPENROUTER_API_KEY` |
| [SearXNG](/uk/tools/searxng-search) | Структуровані уривки | Категорії, мова | Немає (самостійне розміщення) |
| [Tavily](/uk/tools/tavily) | Структуровані уривки | Через інструмент `tavily_search` | `TAVILY_API_KEY` |
## Автовизначення
## Автовиявлення
## Нативний вебпошук OpenAI
Прямі моделі OpenAI Responses автоматично використовують hosted-інструмент OpenAI `web_search`, коли в OpenClaw увімкнено вебпошук і не закріплено жодного керованого провайдера. Це поведінка, якою володіє провайдер у bundled Plugin OpenAI, і вона застосовується лише до нативного трафіку OpenAI API, а не до proxy base URL, сумісних з OpenAI, або маршрутів Azure. Задайте `tools.web.search.provider` на іншого провайдера, наприклад `brave`, щоб зберегти керований інструмент `web_search` для моделей OpenAI, або задайте `tools.web.search.enabled: false`, щоб вимкнути і керований пошук, і нативний пошук OpenAI.
Безпосередні моделі OpenAI Responses автоматично використовують розміщений OpenAI інструмент `web_search`, коли в OpenClaw увімкнено вебпошук і не закріплено керованого постачальника. Це поведінка, що належить постачальнику, у вбудованому Plugin OpenAI і застосовується лише до нативного трафіку OpenAI API, а не до OpenAI-сумісних проксі-URL або маршрутів Azure. Установіть `tools.web.search.provider` на іншого постачальника, наприклад `brave`, щоб зберегти керований інструмент `web_search` для моделей OpenAI, або встановіть `tools.web.search.enabled: false`, щоб вимкнути і керований пошук, і нативний пошук OpenAI.
## Нативний вебпошук Codex
Моделі з підтримкою Codex за бажанням можуть використовувати нативний для провайдера інструмент Responses `web_search` замість керованої функції `web_search` OpenClaw.
Моделі з підтримкою Codex можуть за бажанням використовувати нативний інструмент Responses `web_search` постачальника замість керованої функції OpenClaw `web_search`.
- Налаштовується в `tools.web.search.openaiCodex`
- Активується лише для моделей із підтримкою Codex (`openai-codex/*` або провайдерів із `api: "openai-codex-responses"`)
- Керований `web_search` і далі застосовується до моделей без Codex
- `mode: "cached"` — типове й рекомендоване налаштування
- Активується лише для моделей із підтримкою Codex (`openai-codex/*` або постачальників, що використовують `api: "openai-codex-responses"`)
- Керований `web_search` і далі застосовується до моделей без підтримки Codex
- `mode: "cached"` — типовий і рекомендований параметр
- `tools.web.search.enabled: false` вимикає і керований, і нативний пошук
```json5
@ -164,13 +162,13 @@ OpenClaw також містить `x_search` для дописів X (коли
## Налаштування вебпошуку
Списки провайдерів у документації та потоках setup розташовані в алфавітному порядку. Для автовизначення використовується
Списки постачальників у документації та сценаріях налаштування наведено в алфавітному порядку. Автовиявлення використовує
окремий порядок пріоритету.
Якщо `provider` не задано, OpenClaw перевіряє провайдерів у такому порядку й використовує
Якщо `provider` не встановлено, OpenClaw перевіряє постачальників у такому порядку та використовує
першого, який готовий:
Спочатку провайдери з API:
Спочатку постачальники на основі API:
1. **Brave** -- `BRAVE_API_KEY` або `plugins.entries.brave.config.webSearch.apiKey` (порядок 10)
2. **MiniMax Search** -- `MINIMAX_CODE_PLAN_KEY` / `MINIMAX_CODING_API_KEY` або `plugins.entries.minimax.config.webSearch.apiKey` (порядок 15)
@ -182,24 +180,24 @@ OpenClaw також містить `x_search` для дописів X (коли
8. **Exa** -- `EXA_API_KEY` або `plugins.entries.exa.config.webSearch.apiKey` (порядок 65)
9. **Tavily** -- `TAVILY_API_KEY` або `plugins.entries.tavily.config.webSearch.apiKey` (порядок 70)
Після цього — fallback без ключа:
Після цього резервні варіанти без ключа:
10. **DuckDuckGo** -- fallback HTML без ключа, без облікового запису й API key (порядок 100)
11. **Ollama Web Search** -- fallback без ключа через ваш налаштований host Ollama; потребує доступного Ollama і входу через `ollama signin`, а також може повторно використовувати bearer auth провайдера Ollama, якщо host його потребує (порядок 110)
10. **DuckDuckGo** -- HTML-резервний варіант без ключа, без облікового запису чи API-ключа (порядок 100)
11. **Ollama Web Search** -- резервний варіант без ключа через налаштований локальний хост Ollama, коли він доступний і в ньому виконано вхід за допомогою `ollama signin`; може повторно використовувати bearer-автентифікацію постачальника Ollama, якщо вона потрібна хосту, і може викликати прямий пошук `https://ollama.com`, якщо налаштовано `OLLAMA_API_KEY` (порядок 110)
12. **SearXNG** -- `SEARXNG_BASE_URL` або `plugins.entries.searxng.config.webSearch.baseUrl` (порядок 200)
Якщо жодного провайдера не виявлено, використовується fallback до Brave (ви отримаєте
помилку про відсутній ключ із підказкою налаштувати його).
Якщо жодного постачальника не виявлено, використовується Brave (ви отримаєте помилку
про відсутній ключ із підказкою налаштувати його).
<Note>
Усі поля ключів провайдерів підтримують об’єкти SecretRef. SecretRef у межах Plugin
під `plugins.entries.<plugin>.config.webSearch.apiKey` визначаються для
bundled-провайдерів Exa, Firecrawl, Gemini, Grok, Kimi, Perplexity і Tavily
незалежно від того, чи вибрано провайдера явно через `tools.web.search.provider`,
чи його вибрано через auto-detect. У режимі auto-detect OpenClaw визначає лише
ключ вибраного провайдера — SecretRef невибраних провайдерів залишаються
неактивними, тож ви можете тримати налаштованими кількох провайдерів, не
сплачуючи вартість визначення для тих, які не використовуються.
Усі поля ключів постачальників підтримують об’єкти SecretRef. SecretRef-и з областю Plugin
у `plugins.entries.<plugin>.config.webSearch.apiKey` розв’язуються для
вбудованих постачальників Exa, Firecrawl, Gemini, Grok, Kimi, Perplexity і Tavily
незалежно від того, чи вибрано постачальника явно через `tools.web.search.provider`, чи
через автовиявлення. У режимі автовиявлення OpenClaw розв’язує лише ключ
вибраного постачальника — SecretRef-и невибраних постачальників залишаються неактивними, тож ви можете
тримати налаштованими кількох постачальників без витрат на розв’язання для
тих, які не використовуєте.
</Note>
## Конфігурація
@ -210,7 +208,7 @@ OpenClaw також містить `x_search` для дописів X (коли
web: {
search: {
enabled: true, // типово: true
provider: "brave", // або не задавайте для автовизначення
provider: "brave", // або пропустіть для автовиявлення
maxResults: 5,
timeoutSeconds: 30,
cacheTtlMinutes: 15,
@ -220,15 +218,16 @@ OpenClaw також містить `x_search` для дописів X (коли
}
```
Config, специфічна для провайдера (API keys, base URL, режими), міститься в
`plugins.entries.<plugin>.config.webSearch.*`. Приклади див. на сторінках
провайдерів.
Специфічна для постачальника конфігурація (API-ключі, базові URL, режими) міститься в
`plugins.entries.<plugin>.config.webSearch.*`. Приклади дивіться на сторінках
постачальників.
Вибір fallback-провайдера `web_fetch` є окремим:
Вибір резервного постачальника для `web_fetch` налаштовується окремо:
- виберіть його через `tools.web.fetch.provider`
- або пропустіть це поле й дозвольте OpenClaw автоматично визначити першого готового провайдера web-fetch на основі доступних облікових даних
- наразі bundled-провайдером web-fetch є Firecrawl, який налаштовується в
- або пропустіть це поле й дозвольте OpenClaw автоматично виявити першого готового
постачальника web-fetch серед доступних облікових даних
- наразі вбудованим постачальником web-fetch є Firecrawl, що налаштовується в
`plugins.entries.firecrawl.config.webFetch.*`
Коли ви вибираєте **Kimi** під час `openclaw onboard` або
@ -238,19 +237,19 @@ Config, специфічна для провайдера (API keys, base URL, р
- типову модель вебпошуку Kimi (типово `kimi-k2.6`)
Для `x_search` налаштуйте `plugins.entries.xai.config.xSearch.*`. Він використовує
той самий fallback `XAI_API_KEY`, що й вебпошук Grok.
Застаріла config `tools.web.x_search.*` автоматично мігрується через `openclaw doctor --fix`.
той самий резервний `XAI_API_KEY`, що й вебпошук Grok.
Застаріла конфігурація `tools.web.x_search.*` автоматично мігрується за допомогою `openclaw doctor --fix`.
Коли ви вибираєте Grok під час `openclaw onboard` або `openclaw configure --section web`,
OpenClaw також може запропонувати необов’язкове налаштування `x_search` з тим самим ключем.
Це окремий подальший крок усередині шляху Grok, а не окремий top-level
вибір провайдера вебпошуку. Якщо ви вибираєте іншого провайдера, OpenClaw не
показує prompt для `x_search`.
OpenClaw також може запропонувати додаткове налаштування `x_search` з тим самим ключем.
Це окремий наступний крок у межах шляху Grok, а не окремий вибір постачальника
вебпошуку верхнього рівня. Якщо ви виберете іншого постачальника, OpenClaw не
показуватиме запит для `x_search`.
### Зберігання API key
### Зберігання API-ключів
<Tabs>
<Tab title="Файл config">
Виконайте `openclaw configure --section web` або задайте ключ напряму:
<Tab title="Файл конфігурації">
Виконайте `openclaw configure --section web` або встановіть ключ безпосередньо:
```json5
{
@ -270,65 +269,67 @@ OpenClaw також може запропонувати необов’язко
</Tab>
<Tab title="Змінна середовища">
Задайте env var провайдера в середовищі процесу Gateway:
Встановіть змінну середовища постачальника в середовищі процесу Gateway:
```bash
export BRAVE_API_KEY="YOUR_KEY"
```
Для встановленого gateway помістіть його в `~/.openclaw/.env`.
Див. [Env vars](/uk/help/faq#env-vars-and-env-loading).
Для встановлення gateway додайте її в `~/.openclaw/.env`.
Дивіться [Змінні середовища](/uk/help/faq#env-vars-and-env-loading).
</Tab>
</Tabs>
## Параметри інструмента
| Parameter | Description |
| --------------------- | -------------------------------------------------------- |
| `query` | Пошуковий запит (обов’язково) |
| `count` | Кількість результатів для повернення (1-10, типово: 5) |
| `country` | 2-літерний код країни ISO (наприклад, "US", "DE") |
| `language` | Код мови ISO 639-1 (наприклад, "en", "de") |
| `search_lang` | Код мови пошуку (лише Brave) |
| `freshness` | Фільтр часу: `day`, `week`, `month` або `year` |
| `date_after` | Результати після цієї дати (YYYY-MM-DD) |
| `date_before` | Результати до цієї дати (YYYY-MM-DD) |
| `ui_lang` | Код мови UI (лише Brave) |
| `domain_filter` | Масив allowlist/denylist доменів (лише Perplexity) |
| `max_tokens` | Загальний бюджет вмісту, типово 25000 (лише Perplexity) |
| `max_tokens_per_page` | Ліміт токенів на сторінку, типово 2048 (лише Perplexity) |
| Параметр | Опис |
| -------------------- | ----------------------------------------------------- |
| `query` | Пошуковий запит (обов’язково) |
| `count` | Кількість результатів для повернення (1-10, типово: 5) |
| `country` | 2-літерний код країни ISO (наприклад, "US", "DE") |
| `language` | Код мови ISO 639-1 (наприклад, "en", "de") |
| `search_lang` | Код мови пошуку (лише для Brave) |
| `freshness` | Часовий фільтр: `day`, `week`, `month` або `year` |
| `date_after` | Результати після цієї дати (YYYY-MM-DD) |
| `date_before` | Результати до цієї дати (YYYY-MM-DD) |
| `ui_lang` | Код мови інтерфейсу (лише для Brave) |
| `domain_filter` | Масив списку дозволених/заборонених доменів (лише для Perplexity) |
| `max_tokens` | Загальний бюджет вмісту, типово 25000 (лише для Perplexity) |
| `max_tokens_per_page` | Ліміт токенів на сторінку, типово 2048 (лише для Perplexity) |
<Warning>
Не всі параметри працюють з усіма провайдерами. Режим Brave `llm-context`
Не всі параметри працюють з усіма постачальниками. Режим Brave `llm-context`
відхиляє `ui_lang`, `freshness`, `date_after` і `date_before`.
Gemini, Grok і Kimi повертають одну синтезовану відповідь із цитатами. Вони
Gemini, Grok і Kimi повертають одну синтезовану ШІ відповідь із цитуваннями. Вони
приймають `count` для сумісності зі спільним інструментом, але це не змінює
форму обґрунтованої відповіді.
Perplexity поводиться так само, коли ви використовуєте шлях
сумісності Sonar/OpenRouter (`plugins.entries.perplexity.config.webSearch.baseUrl` /
форму grounded-відповіді.
Perplexity поводиться так само, коли ви використовуєте шлях сумісності Sonar/OpenRouter
(`plugins.entries.perplexity.config.webSearch.baseUrl` /
`model` або `OPENROUTER_API_KEY`).
SearXNG приймає `http://` лише для довірених хостів у приватній мережі або loopback;
публічні endpoint SearXNG мають використовувати `https://`.
SearXNG приймає `http://` лише для довірених хостів приватної мережі або loopback;
публічні кінцеві точки SearXNG повинні використовувати `https://`.
Firecrawl і Tavily підтримують лише `query` і `count` через `web_search`
-- для розширених параметрів використовуйте їхні окремі інструменти.
-- для додаткових параметрів використовуйте їхні спеціалізовані інструменти.
</Warning>
## x_search
`x_search` виконує запити до дописів X (колишній Twitter) через xAI і повертає
AI-синтезовані відповіді з цитатами. Він приймає запити природною мовою та
`x_search` виконує запити до дописів у X (раніше Twitter) за допомогою xAI і повертає
синтезовані ШІ відповіді з цитуваннями. Він приймає запити природною мовою та
необов’язкові структуровані фільтри. OpenClaw вмикає вбудований інструмент xAI `x_search`
лише для запиту, який обслуговує цей виклик інструмента.
<Note>
xAI документує `x_search` як інструмент, що підтримує пошук за ключовими словами, семантичний пошук, пошук користувачів і отримання thread. Для статистики окремих дописів, як-от reposts,
replies, bookmarks або views, надавайте перевагу цільовому lookup точного URL допису
або status ID. Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повертати менш повні метадані для конкретного допису. Хороший шаблон: спочатку знайдіть допис, а потім
виконайте другий запит `x_search`, сфокусований саме на ньому.
xAI документує `x_search` як такий, що підтримує пошук за ключовими словами, семантичний пошук, пошук користувачів
і отримання гілок. Для статистики взаємодії окремого допису, такої як репости,
відповіді, закладки або перегляди, краще виконувати цільовий пошук за точним URL допису
або ID статусу. Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повернути
менш повні метадані окремого допису. Хороший підхід: спочатку знайти допис, а потім
виконати другий запит `x_search`, зосереджений саме на цьому дописі.
</Note>
### config x_search
### Конфігурація x_search
```json5
{
@ -345,7 +346,7 @@ AI-синтезовані відповіді з цитатами. Він при
cacheTtlMinutes: 15,
},
webSearch: {
apiKey: "xai-...", // необов’язково, якщо задано XAI_API_KEY
apiKey: "xai-...", // необов’язково, якщо встановлено XAI_API_KEY
},
},
},
@ -356,13 +357,13 @@ AI-синтезовані відповіді з цитатами. Він при
### Параметри x_search
| Parameter | Description |
| ---------------------------- | ---------------------------------------------------------- |
| `query` | Пошуковий запит (обов’язково) |
| `allowed_x_handles` | Обмежити результати конкретними X-handle |
| `excluded_x_handles` | Виключити конкретні X-handle |
| `from_date` | Включати лише дописи на або після цієї дати (YYYY-MM-DD) |
| `to_date` | Включати лише дописи на або до цієї дати (YYYY-MM-DD) |
| Параметр | Опис |
| -------------------------- | ----------------------------------------------------- |
| `query` | Пошуковий запит (обов’язково) |
| `allowed_x_handles` | Обмежити результати конкретними X-хендлами |
| `excluded_x_handles` | Виключити конкретні X-хендли |
| `from_date` | Включати лише дописи в цю дату або пізніше (YYYY-MM-DD) |
| `to_date` | Включати лише дописи в цю дату або раніше (YYYY-MM-DD) |
| `enable_image_understanding` | Дозволити xAI аналізувати зображення, прикріплені до відповідних дописів |
| `enable_video_understanding` | Дозволити xAI аналізувати відео, прикріплені до відповідних дописів |
@ -377,7 +378,7 @@ await x_search({
```
```javascript
// Статистика окремого допису: використовуйте точний URL статусу або status ID, коли це можливо
// Статистика окремого допису: використовуйте точний URL статусу або ID статусу, коли це можливо
await x_search({
query: "https://x.com/huntharo/status/1905678901234567890",
});
@ -389,10 +390,10 @@ await x_search({
// Базовий пошук
await web_search({ query: "OpenClaw plugin SDK" });
// Пошук, специфічний для Німеччини
// Пошук для Німеччини
await web_search({ query: "TV online schauen", country: "DE", language: "de" });
// Недавні результати (за останній тиждень)
// Нещодавні результати (за минулий тиждень)
await web_search({ query: "AI developments", freshness: "week" });
// Діапазон дат
@ -402,7 +403,7 @@ await web_search({
date_before: "2024-06-30",
});
// Фільтрація доменів (лише Perplexity)
// Фільтрація доменів (лише для Perplexity)
await web_search({
query: "product reviews",
domain_filter: ["-reddit.com", "-pinterest.com"],
@ -411,7 +412,7 @@ await web_search({
## Профілі інструментів
Якщо ви використовуєте профілі інструментів або allowlist, додайте `web_search`, `x_search` або `group:web`:
Якщо ви використовуєте профілі інструментів або списки дозволів, додайте `web_search`, `x_search` або `group:web`:
```json5
{
@ -424,7 +425,7 @@ await web_search({
## Пов’язане
- [Web Fetch](/uk/tools/web-fetch) -- отримання URL і витягування читабельного вмісту
- [Web Browser](/uk/tools/browser) -- повна автоматизація браузера для сайтів із важким JS
- [Grok Search](/uk/tools/grok-search) -- Grok як провайдер `web_search`
- [Ollama Web Search](/uk/tools/ollama-search) -- вебпошук без ключа через ваш host Ollama
- [Web Fetch](/uk/tools/web-fetch) -- отримати URL і витягти читабельний вміст
- [Web Browser](/uk/tools/browser) -- повна автоматизація браузера для сайтів із великою кількістю JS
- [Grok Search](/uk/tools/grok-search) -- Grok як постачальник `web_search`
- [Ollama Web Search](/uk/tools/ollama-search) -- вебпошук без ключа через ваш хост Ollama