From 7200ef435654b718e22b848dc680058a18104d48 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sat, 2 May 2026 03:45:14 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/tools/brave-search.md | 56 +++++------ docs/uk/tools/web.md | 182 +++++++++++++++++----------------- 2 files changed, 120 insertions(+), 118 deletions(-) diff --git a/docs/uk/tools/brave-search.md b/docs/uk/tools/brave-search.md index 9736180f8..54b896caa 100644 --- a/docs/uk/tools/brave-search.md +++ b/docs/uk/tools/brave-search.md @@ -1,27 +1,27 @@ --- read_when: - - Ви хочете використовувати Brave Search для `web_search` - - Вам потрібен `BRAVE_API_KEY` або деталі плану -summary: Налаштування API Brave Search для `web_search` -title: Brave search + - Ви хочете використовувати Brave Search для web_search + - Потрібен BRAVE_API_KEY або відомості про план +summary: Налаштування Brave Search API для web_search +title: Пошук Brave x-i18n: - generated_at: "2026-04-24T02:52:01Z" - model: gpt-5.4 + generated_at: "2026-05-02T03:43:54Z" + model: gpt-5.5 provider: openai - source_hash: 0a59df7a5d52f665673b82b76ec9dce7ca34bf4e7b678029f6f7f7c5340c173b + source_hash: d5b6624d078ba55e30fbac4dd863a0d016e2e8d160e32bcc406e5070998241ba source_path: tools/brave-search.md - workflow: 15 + workflow: 16 --- -# API Brave Search +# Brave Search API -OpenClaw підтримує API Brave Search як провайдера `web_search`. +OpenClaw підтримує Brave Search API як провайдера `web_search`. ## Отримання API-ключа -1. Створіть обліковий запис Brave Search API за адресою [https://brave.com/search/api/](https://brave.com/search/api/) +1. Створіть обліковий запис Brave Search API на [https://brave.com/search/api/](https://brave.com/search/api/) 2. На панелі керування виберіть план **Search** і згенеруйте API-ключ. -3. Збережіть ключ у конфігурації або встановіть `BRAVE_API_KEY` у середовищі Gateway. +3. Збережіть ключ у конфігурації або задайте `BRAVE_API_KEY` у середовищі Gateway. ## Приклад конфігурації @@ -33,7 +33,7 @@ OpenClaw підтримує API Brave Search як провайдера `web_sear config: { webSearch: { apiKey: "BRAVE_API_KEY_HERE", - mode: "web", // або "llm-context" + mode: "web", // or "llm-context" }, }, }, @@ -51,13 +51,13 @@ OpenClaw підтримує API Brave Search як провайдера `web_sear } ``` -Налаштування пошуку Brave, специфічні для провайдера, тепер розміщуються в `plugins.entries.brave.config.webSearch.*`. -Застарілий `tools.web.search.apiKey` усе ще завантажується через шар сумісності, але більше не є канонічним шляхом конфігурації. +Специфічні для провайдера налаштування пошуку Brave тепер містяться в `plugins.entries.brave.config.webSearch.*`. +Застарілий `tools.web.search.apiKey` досі завантажується через шар сумісності, але більше не є канонічним шляхом конфігурації. `webSearch.mode` керує транспортом Brave: -- `web` (типово): звичайний вебпошук Brave із заголовками, URL-адресами та фрагментами -- `llm-context`: API LLM Context від Brave із попередньо витягнутими текстовими фрагментами та джерелами для обґрунтування +- `web` (за замовчуванням): звичайний вебпошук Brave із заголовками, URL-адресами та фрагментами +- `llm-context`: Brave LLM Context API із попередньо витягнутими текстовими фрагментами та джерелами для обґрунтування ## Параметри інструмента @@ -100,20 +100,20 @@ OpenClaw підтримує API Brave Search як провайдера `web_sear **Приклади:** ```javascript -// Пошук із прив’язкою до країни та мови +// Country and language-specific search await web_search({ query: "renewable energy", country: "DE", language: "de", }); -// Нещодавні результати (за останній тиждень) +// Recent results (past week) await web_search({ query: "AI news", freshness: "week", }); -// Пошук за діапазоном дат +// Date range search await web_search({ query: "AI developments", date_after: "2024-01-01", @@ -123,16 +123,16 @@ await web_search({ ## Примітки -- OpenClaw використовує план Brave **Search**. Якщо у вас є застаріла підписка (наприклад, початковий безплатний план із 2 000 запитів на місяць), вона залишається дійсною, але не включає новіші можливості, як-от LLM Context або вищі ліміти швидкості. -- Кожен план Brave включає **\$5/місяць безплатного кредиту** (з поновленням). План Search коштує \$5 за 1 000 запитів, тож кредит покриває 1 000 запитів на місяць. Установіть ліміт використання на панелі керування Brave, щоб уникнути неочікуваних витрат. Актуальні плани дивіться на [порталі API Brave](https://brave.com/search/api/). -- План Search включає endpoint LLM Context і права на AI inference. Збереження результатів для навчання або налаштування моделей потребує плану з явними правами на зберігання. Див. [Умови надання послуг](https://api-dashboard.search.brave.com/terms-of-service) Brave. -- Режим `llm-context` повертає обґрунтовані записи джерел замість звичайної форми фрагментів вебпошуку. -- Режим `llm-context` не підтримує `ui_lang`, `freshness`, `date_after` або `date_before`. -- `ui_lang` має містити регіональний підтеґ, наприклад `en-US`. -- Результати кешуються на 15 хвилин типово (налаштовується через `cacheTtlMinutes`). +- OpenClaw використовує план Brave **Search**. Якщо у вас є застаріла підписка (наприклад, початковий безкоштовний план із 2 000 запитів на місяць), вона залишається чинною, але не включає новіші можливості, як-от LLM Context або вищі ліміти частоти запитів. +- Кожен план Brave включає **\$5/місяць безкоштовного кредиту** (з поновленням). План Search коштує \$5 за 1 000 запитів, тож кредит покриває 1 000 запитів на місяць. Задайте ліміт використання на панелі керування Brave, щоб уникнути неочікуваних витрат. Актуальні плани дивіться на [порталі Brave API](https://brave.com/search/api/). +- План Search включає кінцеву точку LLM Context і права на AI-інференс. Збереження результатів для навчання або налаштування моделей потребує плану з явними правами на зберігання. Дивіться [Умови надання послуг](https://api-dashboard.search.brave.com/terms-of-service) Brave. +- Режим `llm-context` повертає обґрунтовані записи джерел замість звичайної структури фрагментів вебпошуку. +- Режим `llm-context` підтримує `freshness` і обмежені діапазони `date_after` + `date_before`. Він не підтримує `ui_lang`; `date_before` без `date_after` відхиляється, оскільки Brave вимагає, щоб користувацькі діапазони свіжості містили і початкову, і кінцеву дати. +- `ui_lang` має містити підтеґ регіону, як-от `en-US`. +- Результати кешуються на 15 хвилин за замовчуванням (налаштовується через `cacheTtlMinutes`). ## Пов’язане - [Огляд Web Search](/uk/tools/web) -- усі провайдери та автоматичне виявлення -- [Perplexity Search](/uk/tools/perplexity-search) -- структуровані результати з фільтрацією за доменом +- [Perplexity Search](/uk/tools/perplexity-search) -- структуровані результати з фільтрацією за доменами - [Exa Search](/uk/tools/exa-search) -- нейронний пошук із витягуванням вмісту diff --git a/docs/uk/tools/web.md b/docs/uk/tools/web.md index f56298d59..6a23db2da 100644 --- a/docs/uk/tools/web.md +++ b/docs/uk/tools/web.md @@ -1,27 +1,27 @@ --- read_when: - - Ви хочете ввімкнути або налаштувати web_search + - Ви хочете увімкнути або налаштувати web_search - Ви хочете ввімкнути або налаштувати x_search - - Потрібно вибрати постачальника пошуку + - Потрібно вибрати пошукового провайдера - Ви хочете зрозуміти автовиявлення та резервне перемикання провайдера sidebarTitle: Web Search -summary: web_search, x_search і web_fetch -- пошук у вебі, пошук дописів у X або отримання вмісту сторінки +summary: web_search, x_search і web_fetch -- пошук в інтернеті, пошук дописів X або отримання вмісту сторінки title: Вебпошук x-i18n: - generated_at: "2026-05-02T03:13:21Z" + generated_at: "2026-05-02T03:44:11Z" model: gpt-5.5 provider: openai - source_hash: 9e0140a3f472afe58d13ffc87bb3c91e3b5f7ddf49f883b38ae9b832e62cafe3 + source_hash: 873d953c068096a926940eb7065961814900417afdfbcf04946a6cefcd58f578 source_path: tools/web.md workflow: 16 --- -Інструмент `web_search` шукає в інтернеті за допомогою налаштованого вами провайдера й -повертає результати. Результати кешуються за запитом на 15 хвилин (можна налаштувати). +Інструмент `web_search` шукає в інтернеті за допомогою налаштованого провайдера й +повертає результати. Результати кешуються за запитом на 15 хвилин (налаштовується). -OpenClaw також включає `x_search` для дописів X (раніше Twitter) і +OpenClaw також містить `x_search` для дописів X (раніше Twitter) і `web_fetch` для легкого отримання URL. На цьому етапі `web_fetch` залишається -локальним, тоді як `web_search` і `x_search` можуть використовувати xAI Responses під капотом. +локальним, а `web_search` і `x_search` можуть використовувати xAI Responses під капотом. `web_search` — це легкий HTTP-інструмент, а не браузерна автоматизація. Для @@ -32,20 +32,20 @@ OpenClaw також включає `x_search` для дописів X (рані ## Швидкий старт - - Виберіть провайдера й виконайте потрібне налаштування. Деякі провайдери - не потребують ключів, тоді як інші використовують API-ключі. Докладніше - дивіться на сторінках провайдерів нижче. + + Виберіть провайдера й виконайте всі потрібні кроки налаштування. Деякі провайдери + не потребують ключа, а інші використовують ключі API. Докладніше дивіться + на сторінках провайдерів нижче. - + ```bash openclaw configure --section web ``` - Це зберігає провайдера й потрібні облікові дані. Також можна встановити змінну - середовища (наприклад `BRAVE_API_KEY`) і пропустити цей крок для провайдерів - на основі API. + Це зберігає провайдера та всі потрібні облікові дані. Також можна задати змінну + середовища (наприклад `BRAVE_API_KEY`) і пропустити цей крок для провайдерів, + що працюють через API. - + Тепер агент може викликати `web_search`: ```javascript @@ -68,72 +68,72 @@ OpenClaw також включає `x_search` для дописів X (рані Структуровані результати з фрагментами. Підтримує режим `llm-context`, фільтри країни/мови. Доступний безплатний рівень. - Резервний варіант без ключа. API-ключ не потрібен. Неофіційна інтеграція на основі HTML. + Резервний варіант без ключа. Ключ API не потрібен. Неофіційна інтеграція на основі HTML. - Нейронний і ключовий пошук із витягуванням вмісту (виділення, текст, резюме). + Нейронний + ключовий пошук із витягуванням вмісту (виділення, текст, підсумки). Структуровані результати. Найкраще поєднувати з `firecrawl_search` і `firecrawl_scrape` для глибокого витягування. - AI-синтезовані відповіді з цитуваннями через прив’язку до Google Search. + Синтезовані ШІ відповіді з цитуваннями через прив’язку до Google Search. - AI-синтезовані відповіді з цитуваннями через вебприв’язку xAI. + Синтезовані ШІ відповіді з цитуваннями через прив’язку до вебу xAI. - AI-синтезовані відповіді з цитуваннями через вебпошук Moonshot. + Синтезовані ШІ відповіді з цитуваннями через вебпошук Moonshot. Структуровані результати через пошуковий API MiniMax Coding Plan. - Пошук через локальний хост Ollama з виконаним входом або розміщений Ollama API. + Пошук через локальний хост Ollama із виконаним входом або розміщений API Ollama. - Структуровані результати з керуванням витягуванням вмісту й фільтрацією доменів. + Структуровані результати з керуванням витягуванням вмісту та фільтрацією доменів. - Самостійно розгорнутий метапошук. API-ключ не потрібен. Агрегує Google, Bing, DuckDuckGo тощо. + Самостійно розгорнутий метапошук. Ключ API не потрібен. Агрегує Google, Bing, DuckDuckGo тощо. - Структуровані результати з глибиною пошуку, фільтрацією за темами й `tavily_extract` для витягування URL. + Структуровані результати з глибиною пошуку, фільтрацією за темою та `tavily_extract` для витягування URL. ### Порівняння провайдерів -| Провайдер | Стиль результатів | Фільтри | API-ключ | +| Провайдер | Стиль результатів | Фільтри | Ключ API | | ----------------------------------------- | -------------------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------- | | [Brave](/uk/tools/brave-search) | Структуровані фрагменти | Країна, мова, час, режим `llm-context` | `BRAVE_API_KEY` | | [DuckDuckGo](/uk/tools/duckduckgo-search) | Структуровані фрагменти | -- | Немає (без ключа) | -| [Exa](/uk/tools/exa-search) | Структуровані + витягнуті | Нейронний/ключовий режим, дата, витягування вмісту | `EXA_API_KEY` | +| [Exa](/uk/tools/exa-search) | Структуровані + витягнуті | Нейронний/ключовий режим, дата, витягування вмісту | `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` | +| [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) | Структуровані фрагменти | Категорії, мова | Немає (самостійно розгорнуто) | +| [SearXNG](/uk/tools/searxng-search) | Структуровані фрагменти | Категорії, мова | Немає (самостійно розгорнутий) | | [Tavily](/uk/tools/tavily) | Структуровані фрагменти | Через інструмент `tavily_search` | `TAVILY_API_KEY` | ## Автовиявлення ## Нативний вебпошук OpenAI -Прямі моделі OpenAI Responses автоматично використовують розміщений OpenAI інструмент `web_search`, коли вебпошук OpenClaw увімкнено й не закріплено керованого провайдера. Це поведінка, що належить провайдеру, у вбудованому OpenAI Plugin і застосовується лише до нативного трафіку OpenAI API, а не до OpenAI-сумісних проксі базових URL або маршрутів 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` замість керованої функції OpenClaw `web_search`. +Моделі з підтримкою Codex можуть за бажанням використовувати нативний для провайдера інструмент Responses `web_search` замість керованої функції OpenClaw `web_search`. - Налаштуйте його в `tools.web.search.openaiCodex` - Він активується лише для моделей із підтримкою Codex (`openai-codex/*` або провайдерів, що використовують `api: "openai-codex-responses"`) -- Керований `web_search` і надалі застосовується до моделей без Codex -- `mode: "cached"` — типове й рекомендоване налаштування -- `tools.web.search.enabled: false` вимикає як керований, так і нативний пошук +- Керований `web_search` і далі застосовується до моделей без Codex +- `mode: "cached"` — стандартне та рекомендоване налаштування +- `tools.web.search.enabled: false` вимикає і керований, і нативний пошук ```json5 { @@ -162,11 +162,11 @@ OpenClaw також включає `x_search` для дописів X (рані ## Налаштування вебпошуку -Списки провайдерів у документації та потоках налаштування впорядковані за алфавітом. Автовиявлення зберігає +Списки провайдерів у документації та потоках налаштування впорядковані за абеткою. Автовиявлення використовує окремий порядок пріоритету. -Якщо `provider` не встановлено, OpenClaw перевіряє провайдерів у такому порядку й використовує -перший готовий: +Якщо `provider` не задано, OpenClaw перевіряє провайдерів у такому порядку й використовує +першого готового: Спочатку провайдери на основі API: @@ -182,21 +182,21 @@ OpenClaw також включає `x_search` для дописів X (рані Після цього резервні варіанти без ключа: -10. **DuckDuckGo** -- резервний HTML-варіант без ключа, облікового запису або API-ключа (порядок 100) -11. **Ollama Web Search** -- резервний варіант без ключа через налаштований локальний хост Ollama, коли він доступний і вхід виконано за допомогою `ollama signin`; може повторно використовувати bearer-автентифікацію провайдера Ollama, коли вона потрібна хосту, і може викликати прямий пошук `https://ollama.com`, коли налаштовано `OLLAMA_API_KEY` (порядок 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) -Якщо провайдера не виявлено, система повертається до Brave (ви отримаєте помилку про відсутній ключ, -яка запропонує його налаштувати). +Якщо провайдера не виявлено, використовується Brave як резервний варіант (ви отримаєте помилку про відсутній ключ +із пропозицією налаштувати його). - Усі поля ключів провайдерів підтримують об’єкти SecretRef. SecretRef у межах Plugin + Усі поля ключів провайдера підтримують об’єкти SecretRef. SecretRefs в області Plugin у `plugins.entries..config.webSearch.apiKey` розв’язуються для вбудованих провайдерів вебпошуку на основі API, зокрема Brave, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax, Perplexity і Tavily, незалежно від того, чи провайдера вибрано явно через `tools.web.search.provider`, чи - вибрано через автовиявлення. У режимі автовиявлення OpenClaw розв’язує лише - ключ вибраного провайдера -- невибрані SecretRef залишаються неактивними, тож можна + вибрано через автовиявлення. У режимі автовиявлення OpenClaw розв’язує лише ключ + вибраного провайдера -- невибрані SecretRefs залишаються неактивними, тож можна тримати налаштованими кілька провайдерів без витрат на розв’язання для тих, які ви не використовуєте. @@ -219,38 +219,39 @@ OpenClaw також включає `x_search` для дописів X (рані } ``` -Конфігурація, специфічна для провайдера (API-ключі, базові URL, режими), міститься в -`plugins.entries..config.webSearch.*`. Приклади дивіться на сторінках провайдерів. +Конфігурація, специфічна для провайдера (ключі API, базові URL, режими), розміщується в +`plugins.entries..config.webSearch.*`. Приклади дивіться на сторінках +провайдерів. Вибір резервного провайдера `web_fetch` є окремим: - виберіть його за допомогою `tools.web.fetch.provider` -- або опустіть це поле й дозвольте OpenClaw автоматично виявити першого готового провайдера web-fetch +- або пропустіть це поле й дозвольте OpenClaw автоматично виявити першого готового провайдера web-fetch з доступних облікових даних - `web_fetch` без пісочниці може використовувати встановлені провайдери Plugin, які оголошують - `contracts.webFetchProviders`; запити в пісочниці залишаються лише вбудованими -- сьогодні вбудований провайдер web-fetch — Firecrawl, налаштований у + `contracts.webFetchProviders`; отримання в пісочниці залишається лише вбудованим +- сьогодні вбудованим провайдером web-fetch є Firecrawl, налаштований у `plugins.entries.firecrawl.config.webFetch.*` Коли ви вибираєте **Kimi** під час `openclaw onboard` або `openclaw configure --section web`, OpenClaw також може запитати: -- регіон Moonshot API (`https://api.moonshot.ai/v1` або `https://api.moonshot.cn/v1`) -- типову модель вебпошуку Kimi (типово `kimi-k2.6`) +- регіон API Moonshot (`https://api.moonshot.ai/v1` або `https://api.moonshot.cn/v1`) +- стандартну модель вебпошуку Kimi (за замовчуванням `kimi-k2.6`) Для `x_search` налаштуйте `plugins.entries.xai.config.xSearch.*`. Він використовує той самий резервний `XAI_API_KEY`, що й вебпошук Grok. -Застарілу конфігурацію `tools.web.x_search.*` автоматично мігрує `openclaw doctor --fix`. +Застаріла конфігурація `tools.web.x_search.*` автоматично мігрується командою `openclaw doctor --fix`. Коли ви вибираєте Grok під час `openclaw onboard` або `openclaw configure --section web`, OpenClaw також може запропонувати необов’язкове налаштування `x_search` з тим самим ключем. -Це окремий наступний крок усередині шляху Grok, а не окремий вибір постачальника -вебпошуку верхнього рівня. Якщо ви виберете іншого постачальника, OpenClaw не +Це окремий подальший крок усередині шляху Grok, а не окремий вибір +постачальника вебпошуку верхнього рівня. Якщо ви виберете іншого постачальника, OpenClaw не показуватиме запит `x_search`. -### Зберігання ключів API +### Зберігання API-ключів - + Запустіть `openclaw configure --section web` або задайте ключ напряму: ```json5 @@ -270,14 +271,14 @@ OpenClaw також може запропонувати необов’язко ``` - + Задайте змінну середовища постачальника в середовищі процесу Gateway: ```bash export BRAVE_API_KEY="YOUR_KEY" ``` - Для встановлення gateway додайте її в `~/.openclaw/.env`. + Для встановлення gateway додайте її до `~/.openclaw/.env`. Див. [Змінні середовища](/uk/help/faq#env-vars-and-env-loading). @@ -285,50 +286,51 @@ OpenClaw також може запропонувати необов’язко ## Параметри інструмента -| Параметр | Опис | -| --------------------- | ----------------------------------------------------- | -| `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) | +| Параметр | Опис | +| --------------------- | ------------------------------------------------------ | +| `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` | Масив allowlist/denylist доменів (лише Perplexity) | +| `max_tokens` | Загальний бюджет вмісту, стандартно 25000 (лише Perplexity) | +| `max_tokens_per_page` | Ліміт токенів на сторінку, стандартно 2048 (лише Perplexity) | Не всі параметри працюють з усіма постачальниками. Режим Brave `llm-context` - відхиляє `ui_lang`, `freshness`, `date_after` і `date_before`. + відхиляє `ui_lang`; `date_before` також потребує `date_after`, оскільки користувацькі + діапазони свіжості Brave вимагають і початкової, і кінцевої дати. Gemini, Grok і Kimi повертають одну синтезовану відповідь із цитуваннями. Вони приймають `count` для сумісності зі спільним інструментом, але це не змінює форму обґрунтованої відповіді. Perplexity поводиться так само, коли ви використовуєте шлях сумісності Sonar/OpenRouter (`plugins.entries.perplexity.config.webSearch.baseUrl` / `model` або `OPENROUTER_API_KEY`). - SearXNG приймає `http://` лише для довірених хостів приватної мережі або loopback; + SearXNG приймає `http://` лише для довірених приватних мережевих або loopback-хостів; публічні кінцеві точки SearXNG мають використовувати `https://`. - Firecrawl і Tavily підтримують лише `query` і `count` через `web_search` + Firecrawl і Tavily підтримують через `web_search` лише `query` і `count` -- використовуйте їхні спеціальні інструменти для розширених параметрів. ## x_search -`x_search` виконує запити до дописів X (раніше Twitter) за допомогою xAI та повертає +`x_search` запитує дописи X (раніше Twitter) за допомогою xAI і повертає синтезовані AI відповіді з цитуваннями. Він приймає запити природною мовою та необов’язкові структуровані фільтри. OpenClaw вмикає вбудований інструмент xAI `x_search` лише для запиту, який обслуговує цей виклик інструмента. xAI документує `x_search` як такий, що підтримує пошук за ключовими словами, семантичний пошук, пошук користувачів - і отримання гілок. Для статистики взаємодії з окремим дописом, як-от репости, + і отримання тредів. Для статистики взаємодій на рівні окремого допису, як-от репости, відповіді, закладки або перегляди, віддавайте перевагу цільовому пошуку за точною URL-адресою допису - або ID статусу. Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повернути менш - повні метадані окремого допису. Хороший шаблон: спочатку знайдіть допис, а потім - виконайте другий запит `x_search`, сфокусований на цьому точному дописі. + або status ID. Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повернути менш + повні метадані для окремого допису. Хороший шаблон: спочатку знайдіть допис, а потім + виконайте другий запит `x_search`, зосереджений на цьому точному дописі. ### Конфігурація x_search @@ -359,10 +361,10 @@ OpenClaw також може запропонувати необов’язко } ``` -`x_search` надсилає POST-запити до `/responses`, коли +`x_search` надсилає POST-запит до `/responses`, коли задано `plugins.entries.xai.config.xSearch.baseUrl`. Якщо це поле пропущено, -він повертається до `plugins.entries.xai.config.webSearch.baseUrl`, потім до -застарілого `tools.web.search.grok.baseUrl`, і зрештою до публічної кінцевої точки xAI. +він використовує резервно `plugins.entries.xai.config.webSearch.baseUrl`, потім +застарілий `tools.web.search.grok.baseUrl`, і нарешті публічну кінцеву точку xAI. ### Параметри x_search @@ -421,7 +423,7 @@ await web_search({ ## Профілі інструментів -Якщо ви використовуєте профілі інструментів або списки дозволів, додайте `web_search`, `x_search` або `group:web`: +Якщо ви використовуєте профілі інструментів або allowlists, додайте `web_search`, `x_search` або `group:web`: ```json5 { @@ -434,7 +436,7 @@ await web_search({ ## Пов’язане -- [Web Fetch](/uk/tools/web-fetch) -- отримати URL і витягти придатний для читання вміст +- [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 +- [Ollama Web Search](/uk/tools/ollama-search) -- вебпошук без ключа через ваш Ollama-хост