From c15bbd77eca7110d644e1a6c591e14fc8df0e633 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sat, 2 May 2026 04:06:06 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/tools/gemini-search.md | 60 ++++----- docs/uk/tools/web.md | 218 +++++++++++++++++---------------- 2 files changed, 141 insertions(+), 137 deletions(-) diff --git a/docs/uk/tools/gemini-search.md b/docs/uk/tools/gemini-search.md index fe1e3ae0e..f70f5d8e8 100644 --- a/docs/uk/tools/gemini-search.md +++ b/docs/uk/tools/gemini-search.md @@ -1,25 +1,25 @@ --- read_when: - Ви хочете використовувати Gemini для web_search - - Потрібен GEMINI_API_KEY - - Вам потрібне обґрунтування через Google Search -summary: Вебпошук Gemini із прив’язкою до Google Search + - Вам потрібен GEMINI_API_KEY + - Вам потрібне обґрунтування результатами Google Search +summary: Вебпошук Gemini з обґрунтуванням за допомогою Google Search title: Пошук Gemini x-i18n: - generated_at: "2026-05-02T02:49:20Z" + generated_at: "2026-05-02T04:05:01Z" model: gpt-5.5 provider: openai - source_hash: 5e36382dc6a4f9a30f12025cc81bb7ed4999e56a236fc85ee7a37444674bf798 + source_hash: e48b73a59f1af08cb1e30f149a18534dc76ba8dff26935d83fe8ccdaa8ab74e6 source_path: tools/gemini-search.md workflow: 16 --- OpenClaw підтримує моделі Gemini з вбудованим [обґрунтуванням Google Search](https://ai.google.dev/gemini-api/docs/grounding), -яке повертає AI-синтезовані відповіді на основі живих результатів Google Search -із цитуваннями. +яке повертає синтезовані ШІ відповіді, підкріплені актуальними результатами Google Search із +цитуваннями. -## Отримайте API-ключ +## Отримання API-ключа @@ -27,7 +27,7 @@ OpenClaw підтримує моделі Gemini з вбудованим API-ключ. - Задайте `GEMINI_API_KEY` у середовищі Gateway або налаштуйте через: + Установіть `GEMINI_API_KEY` в оточенні Gateway або налаштуйте через: ```bash openclaw configure --section web @@ -63,49 +63,51 @@ OpenClaw підтримує моделі Gemini з вбудованим } ``` -**Альтернатива через середовище:** задайте `GEMINI_API_KEY` у середовищі Gateway. +**Альтернатива через оточення:** установіть `GEMINI_API_KEY` в оточенні Gateway. Для встановлення gateway помістіть його в `~/.openclaw/.env`. ## Як це працює -На відміну від традиційних пошукових провайдерів, які повертають список посилань і фрагментів, -Gemini використовує обґрунтування Google Search, щоб створювати AI-синтезовані відповіді з +На відміну від традиційних постачальників пошуку, які повертають список посилань і фрагментів, +Gemini використовує обґрунтування Google Search, щоб створювати синтезовані ШІ відповіді з вбудованими цитуваннями. Результати містять як синтезовану відповідь, так і вихідні -URL. +URL-адреси. -- URL цитувань із обґрунтування Gemini автоматично перетворюються з URL - переспрямування Google на прямі URL. -- Перетворення переспрямувань використовує шлях захисту від SSRF (HEAD + перевірки переспрямувань + - перевірка http/https) перед поверненням фінального URL цитування. -- Перетворення переспрямувань використовує строгі типові налаштування SSRF, тому переспрямування на +- URL-адреси цитувань із обґрунтування Gemini автоматично перетворюються з URL-адрес + перенаправлення Google на прямі URL-адреси. +- Обробка перенаправлень використовує шлях захисту від SSRF (HEAD + перевірки перенаправлень + + перевірка http/https) перед поверненням фінальної URL-адреси цитування. +- Обробка перенаправлень використовує строгі стандартні налаштування SSRF, тому перенаправлення на приватні/внутрішні цілі блокуються. ## Підтримувані параметри -Пошук Gemini підтримує `query`. +Пошук Gemini підтримує `query`, `freshness`, `date_after` і `date_before`. `count` приймається для сумісності зі спільним `web_search`, але обґрунтування Gemini все одно повертає одну синтезовану відповідь із цитуваннями, а не список із N результатів. -Фільтри, специфічні для провайдера, як-от `country`, `language`, `freshness` і -`domain_filter`, не підтримуються. +`freshness` приймає `day`, `week`, `month`, `year` і спільні скорочення +`pd`, `pw`, `pm` та `py`. OpenClaw перетворює ці значення або явний +діапазон `date_after`/`date_before` на `timeRangeFilter` обґрунтування +Gemini Google Search. `country`, `language` і `domain_filter` не підтримуються. ## Вибір моделі -Типова модель — `gemini-2.5-flash` (швидка й економічна). Будь-яку модель Gemini, +Стандартна модель — `gemini-2.5-flash` (швидка й економічно ефективна). Будь-яку модель Gemini, що підтримує обґрунтування, можна використовувати через `plugins.entries.google.config.webSearch.model`. -## Перевизначення базового URL +## Перевизначення базової URL-адреси -Задайте `plugins.entries.google.config.webSearch.baseUrl`, коли вебпошук Gemini -має проходити через проксі оператора або власну Gemini-сумісну кінцеву точку. Просте -значення `https://generativelanguage.googleapis.com` нормалізується до -`https://generativelanguage.googleapis.com/v1beta`; власні шляхи проксі зберігаються -як надано після обрізання кінцевих скісних рисок. +Установіть `plugins.entries.google.config.webSearch.baseUrl`, коли вебпошук Gemini +має проходити через операторський проксі або власну сумісну з Gemini кінцеву точку. Значення +`https://generativelanguage.googleapis.com` нормалізується до +`https://generativelanguage.googleapis.com/v1beta`; власні шляхи проксі залишаються +такими, як надано, після обрізання кінцевих скісних рисок. ## Пов’язане -- [Огляд Web Search](/uk/tools/web) -- усі провайдери й автоматичне виявлення +- [Огляд вебпошуку](/uk/tools/web) -- усі постачальники та автовиявлення - [Brave Search](/uk/tools/brave-search) -- структуровані результати з фрагментами - [Perplexity Search](/uk/tools/perplexity-search) -- структуровані результати + витягування вмісту diff --git a/docs/uk/tools/web.md b/docs/uk/tools/web.md index 6a23db2da..6bdb24b64 100644 --- a/docs/uk/tools/web.md +++ b/docs/uk/tools/web.md @@ -1,31 +1,31 @@ --- read_when: - - Ви хочете увімкнути або налаштувати web_search + - Ви хочете ввімкнути або налаштувати web_search - Ви хочете ввімкнути або налаштувати x_search - - Потрібно вибрати пошукового провайдера - - Ви хочете зрозуміти автовиявлення та резервне перемикання провайдера + - Потрібно вибрати провайдера пошуку + - Ви хочете зрозуміти автоматичне виявлення та резервне перемикання провайдера sidebarTitle: Web Search summary: web_search, x_search і web_fetch -- пошук в інтернеті, пошук дописів X або отримання вмісту сторінки -title: Вебпошук +title: Пошук в інтернеті x-i18n: - generated_at: "2026-05-02T03:44:11Z" + generated_at: "2026-05-02T04:05:02Z" model: gpt-5.5 provider: openai - source_hash: 873d953c068096a926940eb7065961814900417afdfbcf04946a6cefcd58f578 + source_hash: 6112a067d6261dcad47a3a83c5185e6e492693b6df6a9d0bb2ca83d7ce2294cb source_path: tools/web.md workflow: 16 --- -Інструмент `web_search` шукає в інтернеті за допомогою налаштованого провайдера й +Інструмент `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-інструмент, а не браузерна автоматизація. Для - сайтів із великою кількістю JS або входом в обліковий запис використовуйте [Веббраузер](/uk/tools/browser). Для + `web_search` — це легкий HTTP-інструмент, а не автоматизація браузера. Для + сайтів із великою кількістю JS або входів у систему використовуйте [Веббраузер](/uk/tools/browser). Для отримання конкретного URL використовуйте [Web Fetch](/uk/tools/web-fetch). @@ -34,16 +34,16 @@ OpenClaw також містить `x_search` для дописів X (рані Виберіть провайдера й виконайте всі потрібні кроки налаштування. Деякі провайдери - не потребують ключа, а інші використовують ключі API. Докладніше дивіться + не потребують ключів, тоді як інші використовують API-ключі. Докладніше дивіться на сторінках провайдерів нижче. ```bash openclaw configure --section web ``` - Це зберігає провайдера та всі потрібні облікові дані. Також можна задати змінну - середовища (наприклад `BRAVE_API_KEY`) і пропустити цей крок для провайдерів, - що працюють через API. + Це збереже провайдера й будь-які потрібні облікові дані. Ви також можете задати env + var (наприклад `BRAVE_API_KEY`) і пропустити цей крок для провайдерів + на основі API. Тепер агент може викликати `web_search`: @@ -65,74 +65,74 @@ OpenClaw також містить `x_search` для дописів X (рані - Структуровані результати з фрагментами. Підтримує режим `llm-context`, фільтри країни/мови. Доступний безплатний рівень. + Структуровані результати з фрагментами. Підтримує режим `llm-context`, фільтри країни/мови. Доступний безкоштовний рівень. - Резервний варіант без ключа. Ключ API не потрібен. Неофіційна інтеграція на основі HTML. + Резервний варіант без ключа. API-ключ не потрібен. Неофіційна інтеграція на основі HTML. Нейронний + ключовий пошук із витягуванням вмісту (виділення, текст, підсумки). - Структуровані результати. Найкраще поєднувати з `firecrawl_search` і `firecrawl_scrape` для глибокого витягування. + Структуровані результати. Найкраще використовувати разом із `firecrawl_search` і `firecrawl_scrape` для глибокого витягування. - Синтезовані ШІ відповіді з цитуваннями через прив’язку до Google Search. + Синтезовані AI відповіді з цитуваннями через Google Search grounding. - Синтезовані ШІ відповіді з цитуваннями через прив’язку до вебу xAI. + Синтезовані AI відповіді з цитуваннями через xAI web grounding. - Синтезовані ШІ відповіді з цитуваннями через вебпошук Moonshot. + Синтезовані AI відповіді з цитуваннями через вебпошук Moonshot. Структуровані результати через пошуковий API MiniMax Coding Plan. - Пошук через локальний хост Ollama із виконаним входом або розміщений API Ollama. + Пошук через локальний хост Ollama з виконаним входом або розміщений Ollama API. - Структуровані результати з керуванням витягуванням вмісту та фільтрацією доменів. + Структуровані результати з елементами керування витягуванням вмісту та фільтрацією доменів. - Самостійно розгорнутий метапошук. Ключ API не потрібен. Агрегує Google, Bing, DuckDuckGo тощо. + Самостійно розгорнутий метапошук. API-ключ не потрібен. Агрегує Google, Bing, DuckDuckGo та інші. - Структуровані результати з глибиною пошуку, фільтрацією за темою та `tavily_extract` для витягування URL. + Структуровані результати з глибиною пошуку, фільтрацією тем і `tavily_extract` для витягування URL. ### Порівняння провайдерів -| Провайдер | Стиль результатів | Фільтри | Ключ 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` | +| Провайдер | Стиль результатів | Фільтри | 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) | Синтезовані 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_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 автоматично використовують розміщений 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. +Прямі моделі 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"` — стандартне та рекомендоване налаштування +- Керований `web_search` усе ще застосовується до моделей без Codex +- `mode: "cached"` — типове й рекомендоване налаштування - `tools.web.search.enabled: false` вимикає і керований, і нативний пошук ```json5 @@ -162,11 +162,11 @@ OpenClaw також містить `x_search` для дописів X (рані ## Налаштування вебпошуку -Списки провайдерів у документації та потоках налаштування впорядковані за абеткою. Автовиявлення використовує +Списки провайдерів у документації та потоках налаштування впорядковані за абеткою. Автовиявлення зберігає окремий порядок пріоритету. Якщо `provider` не задано, OpenClaw перевіряє провайдерів у такому порядку й використовує -першого готового: +першого, який готовий: Спочатку провайдери на основі API: @@ -180,25 +180,25 @@ 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) -Після цього резервні варіанти без ключа: +Після цього резервні варіанти без ключів: -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. SecretRefs в області Plugin + Усі поля ключів провайдерів підтримують об’єкти SecretRef. Plugin-обмежені SecretRefs у `plugins.entries..config.webSearch.apiKey` розв’язуються для вбудованих провайдерів вебпошуку на основі API, зокрема Brave, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax, Perplexity і Tavily, незалежно від того, чи провайдера вибрано явно через `tools.web.search.provider`, чи - вибрано через автовиявлення. У режимі автовиявлення OpenClaw розв’язує лише ключ - вибраного провайдера -- невибрані SecretRefs залишаються неактивними, тож можна - тримати налаштованими кілька провайдерів без витрат на розв’язання для тих, - які ви не використовуєте. + вибрано через автовиявлення. У режимі автовиявлення OpenClaw розв’язує лише + ключ вибраного провайдера -- невибрані SecretRefs залишаються неактивними, тож ви можете + тримати кілька провайдерів налаштованими без витрат на розв’язання для тих, + які не використовуєте. ## Конфігурація @@ -219,36 +219,36 @@ OpenClaw також містить `x_search` для дописів X (рані } ``` -Конфігурація, специфічна для провайдера (ключі API, базові URL, режими), розміщується в +Специфічна для провайдера конфігурація (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, налаштований у +- сьогодні вбудований провайдер web-fetch — Firecrawl, налаштований у `plugins.entries.firecrawl.config.webFetch.*` Коли ви вибираєте **Kimi** під час `openclaw onboard` або `openclaw configure --section web`, OpenClaw також може запитати: -- регіон API Moonshot (`https://api.moonshot.ai/v1` або `https://api.moonshot.cn/v1`) -- стандартну модель вебпошуку Kimi (за замовчуванням `kimi-k2.6`) +- регіон Moonshot API (`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 не +OpenClaw також може запропонувати необов’язкове налаштування `x_search` із тим самим ключем. +Це окремий наступний крок у шляху Grok, а не окремий вибір провайдера +вебпошуку верхнього рівня. Якщо ви виберете іншого провайдера, OpenClaw не показуватиме запит `x_search`. -### Зберігання API-ключів +### Зберігання ключів API @@ -272,13 +272,13 @@ OpenClaw також може запропонувати необов’язко - Задайте змінну середовища постачальника в середовищі процесу Gateway: + Задайте змінну середовища провайдера в середовищі процесу Gateway: ```bash export BRAVE_API_KEY="YOUR_KEY" ``` - Для встановлення gateway додайте її до `~/.openclaw/.env`. + Для встановлення Gateway помістіть її в `~/.openclaw/.env`. Див. [Змінні середовища](/uk/help/faq#env-vars-and-env-loading). @@ -286,35 +286,36 @@ 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` | Масив 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` | Код мови UI (лише Brave) | +| `domain_filter` | Масив дозволених/заборонених доменів (лише Perplexity) | +| `max_tokens` | Загальний бюджет вмісту, типово 25000 (лише Perplexity) | +| `max_tokens_per_page` | Ліміт токенів на сторінку, типово 2048 (лише Perplexity) | - Не всі параметри працюють з усіма постачальниками. Режим Brave `llm-context` - відхиляє `ui_lang`; `date_before` також потребує `date_after`, оскільки користувацькі - діапазони свіжості Brave вимагають і початкової, і кінцевої дати. + Не всі параметри працюють з усіма провайдерами. Режим Brave `llm-context` + відхиляє `ui_lang`; `date_before` також потребує `date_after`, бо власні + діапазони актуальності Brave вимагають і початкової, і кінцевої дат. Gemini, Grok і Kimi повертають одну синтезовану відповідь із цитуваннями. Вони приймають `count` для сумісності зі спільним інструментом, але це не змінює - форму обґрунтованої відповіді. - Perplexity поводиться так само, коли ви використовуєте шлях сумісності Sonar/OpenRouter - (`plugins.entries.perplexity.config.webSearch.baseUrl` / + форму обґрунтованої відповіді. Gemini підтримує `freshness`, `date_after` і + `date_before`, перетворюючи їх на часові діапазони обґрунтування Google Search. + Perplexity поводиться так само, коли ви використовуєте шлях сумісності + Sonar/OpenRouter (`plugins.entries.perplexity.config.webSearch.baseUrl` / `model` або `OPENROUTER_API_KEY`). - SearXNG приймає `http://` лише для довірених приватних мережевих або loopback-хостів; + SearXNG приймає `http://` лише для довірених хостів приватної мережі або local loopback; публічні кінцеві точки SearXNG мають використовувати `https://`. - Firecrawl і Tavily підтримують через `web_search` лише `query` і `count` - -- використовуйте їхні спеціальні інструменти для розширених параметрів. + Firecrawl і Tavily підтримують лише `query` і `count` через `web_search` + -- використовуйте їхні спеціалізовані інструменти для розширених параметрів. ## x_search @@ -325,11 +326,12 @@ OpenClaw також може запропонувати необов’язко лише для запиту, який обслуговує цей виклик інструмента. - xAI документує `x_search` як такий, що підтримує пошук за ключовими словами, семантичний пошук, пошук користувачів - і отримання тредів. Для статистики взаємодій на рівні окремого допису, як-от репости, - відповіді, закладки або перегляди, віддавайте перевагу цільовому пошуку за точною URL-адресою допису - або status ID. Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повернути менш - повні метадані для окремого допису. Хороший шаблон: спочатку знайдіть допис, а потім + xAI документує `x_search` як такий, що підтримує пошук за ключовими словами, + семантичний пошук, пошук користувачів і отримання тредів. Для статистики + взаємодії з окремим дописом, як-от репости, відповіді, закладки або перегляди, + надавайте перевагу цільовому пошуку за точною URL-адресою допису або ID статусу. + Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повернути + менш повні метадані окремого допису. Добрий шаблон: спершу знайдіть допис, потім виконайте другий запит `x_search`, зосереджений на цьому точному дописі. @@ -361,20 +363,20 @@ 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 -| Параметр | Опис | -| ---------------------------- | ------------------------------------------------------ | -| `query` | Пошуковий запит (обов’язково) | -| `allowed_x_handles` | Обмежити результати конкретними X handles | -| `excluded_x_handles` | Виключити конкретні X handles | +| Параметр | Опис | +| ---------------------------- | -------------------------------------------------------- | +| `query` | Пошуковий запит (обов’язково) | +| `allowed_x_handles` | Обмежити результати певними іменами користувачів X | +| `excluded_x_handles` | Виключити певні імена користувачів X | | `from_date` | Включати лише дописи на цю дату або після неї (YYYY-MM-DD) | -| `to_date` | Включати лише дописи на цю дату або до неї (YYYY-MM-DD) | +| `to_date` | Включати лише дописи на цю дату або до неї (YYYY-MM-DD) | | `enable_image_understanding` | Дозволити xAI аналізувати зображення, прикріплені до відповідних дописів | | `enable_video_understanding` | Дозволити xAI аналізувати відео, прикріплені до відповідних дописів | @@ -423,7 +425,7 @@ await web_search({ ## Профілі інструментів -Якщо ви використовуєте профілі інструментів або allowlists, додайте `web_search`, `x_search` або `group:web`: +Якщо ви використовуєте профілі інструментів або списки дозволів, додайте `web_search`, `x_search` або `group:web`: ```json5 { @@ -438,5 +440,5 @@ 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) -- вебпошук без ключа через ваш Ollama-хост +- [Grok Search](/uk/tools/grok-search) -- Grok як провайдер `web_search` +- [Ollama Web Search](/uk/tools/ollama-search) -- вебпошук без ключа через ваш хост Ollama