diff --git a/docs/uk/providers/ollama.md b/docs/uk/providers/ollama.md index 0f28d353f..2a34f4283 100644 --- a/docs/uk/providers/ollama.md +++ b/docs/uk/providers/ollama.md @@ -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. -**Користувачі віддаленого 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`). ## Початок роботи -Оберіть бажаний спосіб і режим налаштування. +Виберіть бажаний спосіб налаштування та режим. - - **Найкраще для:** найшвидшого способу отримати робоче налаштування Ollama cloud або local. + + **Найкраще для:** найшвидшого способу отримати робоче хмарне або локальне налаштування Ollama. - + ```bash openclaw onboard ``` Виберіть **Ollama** зі списку провайдерів. - - - **Cloud + Local** — локальний хост Ollama плюс хмарні моделі, маршрутизовані через цей хост + + - **Cloud + Local** — локальний хост Ollama плюс хмарні моделі, що маршрутизуються через цей хост - **Cloud only** — розміщені моделі Ollama через `https://ollama.com` - **Local only** — лише локальні моделі - `Cloud only` запитує `OLLAMA_API_KEY` і пропонує типові розміщені хмарні значення. `Cloud + Local` і `Local only` запитують базовий URL Ollama, виявляють доступні моделі та автоматично завантажують вибрану локальну модель, якщо вона ще недоступна. `Cloud + Local` також перевіряє, чи виконано вхід на цьому хості Ollama для доступу до хмари. + `Cloud only` запитує `OLLAMA_API_KEY` і пропонує типові хмарні значення за замовчуванням. `Cloud + Local` і `Local only` запитують базовий URL Ollama, виявляють доступні моделі та автоматично завантажують вибрану локальну модель, якщо вона ще недоступна. `Cloud + Local` також перевіряє, чи виконано вхід на цьому хості Ollama для доступу до хмари. - + ```bash openclaw models list --provider ollama ``` @@ -59,7 +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`) - **Найкраще для:** повного контролю над налаштуванням cloud або local. + **Найкраще для:** повного контролю над хмарним або локальним налаштуванням. - - - **Cloud + Local**: встановіть Ollama, увійдіть через `ollama signin` і маршрутизуйте хмарні запити через цей хост + + - **Cloud + Local**: установіть Ollama, виконайте вхід через `ollama signin` і маршрутизуйте хмарні запити через цей хост - **Cloud only**: використовуйте `https://ollama.com` з `OLLAMA_API_KEY` - - **Local only**: встановіть Ollama з [ollama.com/download](https://ollama.com/download) + - **Local only**: установіть Ollama з [ollama.com/download](https://ollama.com/download) - + ```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" ``` @@ -109,7 +109,7 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`) openclaw models set ollama/gemma4 ``` - Або встановіть типову модель у конфігурації: + Або встановіть значення за замовчуванням у конфігурації: ```json5 { @@ -130,45 +130,45 @@ OpenClaw інтегрується з нативним API Ollama (`/api/chat`) - `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`. `Cloud only` працює через розміщений API Ollama за адресою `https://ollama.com`. - Під час налаштування використовуйте **Cloud only**. OpenClaw запитує `OLLAMA_API_KEY`, встановлює `baseUrl: "https://ollama.com"` і заповнює список розміщених хмарних моделей. Цей шлях **не** потребує локального сервера Ollama або `ollama signin`. + Під час налаштування використовуйте **Cloud only**. OpenClaw запитує `OLLAMA_API_KEY`, встановлює `baseUrl: "https://ollama.com"` і заповнює список розміщених хмарних моделей. Цей варіант **не** вимагає локального сервера Ollama або `ollama signin`. - Список хмарних моделей, показаний під час `openclaw onboard`, заповнюється в реальному часі з `https://ollama.com/api/tags` з обмеженням до 500 записів, тому засіб вибору відображає поточний розміщений каталог, а не статичний початковий набір. Якщо `ollama.com` недоступний або під час налаштування не повертає моделей, OpenClaw повертається до попередніх жорстко закодованих пропозицій, щоб onboarding усе одно завершився. + Список хмарних моделей, показаний під час `openclaw onboard`, заповнюється в реальному часі з `https://ollama.com/api/tags` і обмежується 500 записами, тому засіб вибору відображає поточний розміщений каталог, а не статичний набір. Якщо `ollama.com` недоступний або не повертає моделей на момент налаштування, OpenClaw повертається до попередніх жорстко закодованих пропозицій, щоб початкове налаштування все одно завершилося. - У режимі лише локального використання OpenClaw виявляє моделі з налаштованого екземпляра Ollama. Цей шлях призначений для локальних або самостійно розміщених серверів Ollama. + У режимі лише локального використання OpenClaw виявляє моделі з налаштованого екземпляра Ollama. Цей варіант призначений для локальних або власнорозміщених серверів Ollama. - Наразі OpenClaw пропонує `gemma4` як локальне типове значення. + Зараз OpenClaw пропонує `gemma4` як локальне значення за замовчуванням. ## Виявлення моделей (неявний провайдер) -Коли ви задаєте `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 Нову модель буде автоматично виявлено, і вона стане доступною для використання. -Якщо ви явно задаєте `models.providers.ollama`, автоматичне виявлення пропускається, і вам потрібно визначати моделі вручну. Див. розділ явної конфігурації нижче. +Якщо ви явно задаєте `models.providers.ollama`, автоматичне виявлення пропускається, і вам потрібно визначати моделі вручну. Дивіться розділ явної конфігурації нижче. ## 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` має бути повним посиланням у форматі ``. Якщо його задано, `openclaw infer image describe` запускає цю модель безпосередньо замість пропуску опису через те, що модель підтримує нативний vision. +`--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 відхиляє запити на опис зображень для - Найпростіший шлях увімкнення лише local — через змінну середовища: + Найпростіший спосіб увімкнути режим лише локального використання — через змінну середовища: ```bash export OLLAMA_API_KEY="ollama-local" ``` - Якщо задано `OLLAMA_API_KEY`, ви можете не вказувати `apiKey` у записі провайдера, і OpenClaw підставить його для перевірок доступності. + Якщо встановлено `OLLAMA_API_KEY`, ви можете не вказувати `apiKey` у записі провайдера, і OpenClaw сам підставить його для перевірок доступності. - Використовуйте явну конфігурацію, якщо вам потрібне розміщене хмарне налаштування, 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 відхиляє запити на опис зображень для ``` - Не додавайте `/v1` до URL. Шлях `/v1` використовує режим сумісності з OpenAI, у якому виклик інструментів працює ненадійно. Використовуйте базовий URL Ollama без суфікса шляху. + Не додавайте `/v1` до URL. Шлях `/v1` використовує режим, сумісний з OpenAI, у якому виклик інструментів працює ненадійно. Використовуйте базовий URL Ollama без суфікса шляху. @@ -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** як вбудований пр - **Виклик інструментів у режимі сумісності з OpenAI працює ненадійно.** Використовуйте цей режим лише якщо вам потрібен формат OpenAI для проксі й ви не залежите від нативної поведінки виклику інструментів. + **Виклик інструментів у режимі сумісності з OpenAI працює ненадійно.** Використовуйте цей режим лише тоді, коли вам потрібен формат OpenAI для проксі і ви не залежите від нативної поведінки виклику інструментів. - Якщо вам потрібно використовувати натомість 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** як вбудований пр - Для автоматично виявлених моделей OpenClaw використовує контекстне вікно, про яке повідомляє Ollama, коли воно доступне, інакше повертається до типового контекстного вікна Ollama, яке використовує OpenClaw. + Для автоматично виявлених моделей OpenClaw використовує контекстне вікно, про яке повідомляє Ollama, якщо воно доступне, інакше повертається до типового контекстного вікна Ollama, яке використовує OpenClaw. Ви можете перевизначити `contextWindow` і `maxTokens` у явній конфігурації провайдера: @@ -429,29 +429,29 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр - OpenClaw типово вважає моделі з назвами на кшталт `deepseek-r1`, `reasoning` або `think` здатними до reasoning. + OpenClaw за замовчуванням вважає моделі з назвами на кшталт `deepseek-r1`, `reasoning` або `think` такими, що підтримують reasoning. ```bash ollama pull deepseek-r1:32b ``` - Додаткова конфігурація не потрібна — OpenClaw позначає їх автоматично. + Жодна додаткова конфігурація не потрібна — OpenClaw позначає їх автоматично. - Ollama є безкоштовним і працює локально, тому вартість усіх моделей установлено на $0. Це стосується як автоматично виявлених, так і вручну визначених моделей. + Ollama є безкоштовним і працює локально, тому вартість усіх моделей встановлено на рівні $0. Це стосується як автоматично виявлених, так і вручну визначених моделей. Вбудований 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** як вбудований пр - - Інтеграція OpenClaw з Ollama типово використовує **нативний API Ollama** (`/api/chat`), який повністю підтримує одночасно потокову передачу та виклик інструментів. Жодної спеціальної конфігурації не потрібно. + + Інтеграція 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"`. - Якщо вам потрібно використовувати endpoint, сумісний з OpenAI, див. розділ «Застарілий режим сумісності з OpenAI» вище. У цьому режимі потокова передача та виклик інструментів можуть не працювати одночасно. + Якщо вам потрібно використовувати endpoint, сумісний з OpenAI, див. розділ «Застарілий режим сумісності з OpenAI» вище. У цьому режимі потокове передавання та виклик інструментів можуть не працювати одночасно. -## Усунення несправностей +## Усунення проблем - Переконайтеся, що 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** як вбудований пр - Якщо вашої моделі немає у списку, або завантажте її локально, або визначте її явно в `models.providers.ollama`. + Якщо вашу модель не вказано у списку, або завантажте її локально, або явно визначте її в `models.providers.ollama`. ```bash ollama list # Подивитися, що встановлено @@ -511,7 +511,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр - Переконайтеся, що Ollama запущено на правильному порту: + Перевірте, що Ollama працює на правильному порту: ```bash # Перевірити, чи запущено Ollama @@ -525,7 +525,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр -Більше довідки: [Усунення несправностей](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). +Більше допомоги: [Усунення проблем](/uk/help/troubleshooting) і [FAQ](/uk/help/faq). ## Пов’язане @@ -535,12 +535,12 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр Огляд усіх провайдерів, посилань на моделі та поведінки перемикання при збоях. - Як вибирати та налаштовувати моделі. + Як вибирати й налаштовувати моделі. - Повні відомості про налаштування та поведінку веб-пошуку на базі Ollama. + Повні відомості про налаштування та поведінку вебпошуку на основі Ollama. - Повний довідник із конфігурації. + Повний довідник з конфігурації. diff --git a/docs/uk/reference/api-usage-costs.md b/docs/uk/reference/api-usage-costs.md index 287f94de9..06527f0f1 100644 --- a/docs/uk/reference/api-usage-costs.md +++ b/docs/uk/reference/api-usage-costs.md @@ -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..apiKey`), які можуть експортувати ключі до env процесу skill. +- **Skills** (`skills.entries..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) diff --git a/docs/uk/tools/ollama-search.md b/docs/uk/tools/ollama-search.md index e2f9605b3..e21283258 100644 --- a/docs/uk/tools/ollama-search.md +++ b/docs/uk/tools/ollama-search.md @@ -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`. + ## Налаштування @@ -38,20 +42,20 @@ OpenClaw підтримує **Ollama Web Search** як вбудованого п ``` - + Виконайте: ```bash openclaw configure --section web ``` - Потім виберіть **Ollama Web Search** як постачальника. + Потім виберіть **вебпошук Ollama** як постачальника. -Якщо ви вже використовуєте 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 та хмарний/локальний режими diff --git a/docs/uk/tools/web.md b/docs/uk/tools/web.md index a884351f7..baf1f6845 100644 --- a/docs/uk/tools/web.md +++ b/docs/uk/tools/web.md @@ -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 під капотом. - `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). ## Швидкий старт - - Виберіть провайдера та виконайте всі потрібні кроки налаштування. Деякі провайдери - не потребують ключа, тоді як інші використовують API key. Докладніше див. на - сторінках провайдерів нижче. + + Виберіть постачальника та виконайте всі потрібні кроки налаштування. Деякі постачальники + не потребують ключа, тоді як інші використовують API-ключі. Докладніше дивіться на + сторінках постачальників нижче. ```bash openclaw configure --section web ``` - Це збереже провайдера і всі потрібні облікові дані. Ви також можете задати env - var (наприклад `BRAVE_API_KEY`) і пропустити цей крок для провайдерів, - які працюють через API. + Це збереже постачальника та всі потрібні облікові дані. Ви також можете встановити змінну середовища + (наприклад, `BRAVE_API_KEY`) і пропустити цей крок для + постачальників на основі API. Тепер агент може викликати `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 (коли -## Вибір провайдера +## Вибір постачальника - Структуровані результати зі сніпетами. Підтримує режим `llm-context`, фільтри країни/мови. Доступний безкоштовний рівень. + Структуровані результати з уривками. Підтримує режим `llm-context`, фільтри країни/мови. Доступний безкоштовний тариф. - Fallback без ключа. API key не потрібен. Неофіційна інтеграція на основі HTML. + Резервний варіант без ключа. API-ключ не потрібен. Неофіційна інтеграція на основі HTML. - Нейронний + ключовий пошук із витягуванням вмісту (highlights, текст, підсумки). + Нейронний + ключовий пошук із витягуванням вмісту (виділення, текст, підсумки). - Структуровані результати. Найкраще працює разом із `firecrawl_search` і `firecrawl_scrape` для глибокого витягування. + Структуровані результати. Найкраще поєднувати з `firecrawl_search` і `firecrawl_scrape` для глибокого витягування. - AI-синтезовані відповіді з цитатами через Google Search grounding. + Відповіді, синтезовані ШІ, з цитуваннями через Google Search grounding. - AI-синтезовані відповіді з цитатами через xAI web grounding. + Відповіді, синтезовані ШІ, з цитуваннями через xAI web grounding. - AI-синтезовані відповіді з цитатами через вебпошук Moonshot. + Відповіді, синтезовані ШІ, з цитуваннями через вебпошук Moonshot. Структуровані результати через API пошуку MiniMax Coding Plan. - Пошук без ключа через ваш налаштований host Ollama. Потребує `ollama signin`. + Пошук через локальний хост Ollama, у який виконано вхід, або через розміщений API Ollama. Структуровані результати з керуванням витягуванням вмісту та фільтрацією доменів. - Self-hosted meta-search. API key не потрібен. Агрегує Google, Bing, DuckDuckGo тощо. + Самостійно розміщений метапошук. API-ключ не потрібен. Агрегує Google, Bing, DuckDuckGo та інші. - Структуровані результати з глибиною пошуку, фільтрацією тем і `tavily_extract` для витягування URL. + Структуровані результати з глибиною пошуку, фільтрацією за темою та `tavily_extract` для витягування URL. -### Порівняння провайдерів +### Порівняння постачальників -| 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 (ви отримаєте помилку +про відсутній ключ із підказкою налаштувати його). - Усі поля ключів провайдерів підтримують об’єкти SecretRef. SecretRef у межах Plugin - під `plugins.entries..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..config.webSearch.apiKey` розв’язуються для + вбудованих постачальників Exa, Firecrawl, Gemini, Grok, Kimi, Perplexity і Tavily + незалежно від того, чи вибрано постачальника явно через `tools.web.search.provider`, чи + через автовиявлення. У режимі автовиявлення OpenClaw розв’язує лише ключ + вибраного постачальника — SecretRef-и невибраних постачальників залишаються неактивними, тож ви можете + тримати налаштованими кількох постачальників без витрат на розв’язання для + тих, які не використовуєте. ## Конфігурація @@ -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..config.webSearch.*`. Приклади див. на сторінках -провайдерів. +Специфічна для постачальника конфігурація (API-ключі, базові URL, режими) міститься в +`plugins.entries..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-ключів - - Виконайте `openclaw configure --section web` або задайте ключ напряму: + + Виконайте `openclaw configure --section web` або встановіть ключ безпосередньо: ```json5 { @@ -270,65 +269,67 @@ OpenClaw також може запропонувати необов’язко - Задайте 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). ## Параметри інструмента -| 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) | - Не всі параметри працюють з усіма провайдерами. Режим 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` - -- для розширених параметрів використовуйте їхні окремі інструменти. + -- для додаткових параметрів використовуйте їхні спеціалізовані інструменти. ## x_search -`x_search` виконує запити до дописів X (колишній Twitter) через xAI і повертає -AI-синтезовані відповіді з цитатами. Він приймає запити природною мовою та +`x_search` виконує запити до дописів у X (раніше Twitter) за допомогою xAI і повертає +синтезовані ШІ відповіді з цитуваннями. Він приймає запити природною мовою та необов’язкові структуровані фільтри. OpenClaw вмикає вбудований інструмент xAI `x_search` лише для запиту, який обслуговує цей виклик інструмента. - xAI документує `x_search` як інструмент, що підтримує пошук за ключовими словами, семантичний пошук, пошук користувачів і отримання thread. Для статистики окремих дописів, як-от reposts, - replies, bookmarks або views, надавайте перевагу цільовому lookup точного URL допису - або status ID. Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повертати менш повні метадані для конкретного допису. Хороший шаблон: спочатку знайдіть допис, а потім - виконайте другий запит `x_search`, сфокусований саме на ньому. + xAI документує `x_search` як такий, що підтримує пошук за ключовими словами, семантичний пошук, пошук користувачів + і отримання гілок. Для статистики взаємодії окремого допису, такої як репости, + відповіді, закладки або перегляди, краще виконувати цільовий пошук за точним URL допису + або ID статусу. Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повернути + менш повні метадані окремого допису. Хороший підхід: спочатку знайти допис, а потім + виконати другий запит `x_search`, зосереджений саме на цьому дописі. -### 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