openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh uk translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-05-02 04:06:06 +00:00
parent d2499be2db
commit c15bbd77ec
2 changed files with 141 additions and 137 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

60
docs/uk/tools/gemini-search.md
View File

@ -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-ключа
<Steps>
<Step title="Створіть ключ">
@ -27,7 +27,7 @@ OpenClaw підтримує моделі Gemini з вбудованим
API-ключ.
</Step>
<Step title="Збережіть ключ">
Задайте `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) -- структуровані результати + витягування вмісту

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

@ -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 під капотом.
<Info>
`web_search` — це легкий HTTP-інструмент, а не браузерна автоматизація. Для
сайтів із великою кількістю JS або входом в обліковий запис використовуйте [Веббраузер](/uk/tools/browser). Для
`web_search` — це легкий HTTP-інструмент, а не автоматизація браузера. Для
сайтів із великою кількістю JS або входів у систему використовуйте [Веббраузер](/uk/tools/browser). Для
отримання конкретного URL використовуйте [Web Fetch](/uk/tools/web-fetch).
</Info>
@ -34,16 +34,16 @@ OpenClaw також містить `x_search` для дописів X (рані
<Steps>
<Step title="Виберіть провайдера">
Виберіть провайдера й виконайте всі потрібні кроки налаштування. Деякі провайдери
не потребують ключа, а інші використовують ключі API. Докладніше дивіться
не потребують ключів, тоді як інші використовують API-ключі. Докладніше дивіться
на сторінках провайдерів нижче.
</Step>
<Step title="Налаштуйте">
```bash
openclaw configure --section web
```
Це зберігає провайдера та всі потрібні облікові дані. Також можна задати змінну
середовища (наприклад `BRAVE_API_KEY`) і пропустити цей крок для провайдерів,
що працюють через API.
Це збереже провайдера й будь-які потрібні облікові дані. Ви також можете задати env
var (наприклад `BRAVE_API_KEY`) і пропустити цей крок для провайдерів
на основі API.
</Step>
<Step title="Використовуйте">
Тепер агент може викликати `web_search`:
@ -65,74 +65,74 @@ OpenClaw також містить `x_search` для дописів X (рані
<CardGroup cols={2}>
<Card title="Brave Search" icon="shield" href="/uk/tools/brave-search">
Структуровані результати з фрагментами. Підтримує режим `llm-context`, фільтри країни/мови. Доступний безплатний рівень.
Структуровані результати з фрагментами. Підтримує режим `llm-context`, фільтри країни/мови. Доступний безкоштовний рівень.
</Card>
<Card title="DuckDuckGo" icon="bird" href="/uk/tools/duckduckgo-search">
Резервний варіант без ключа. Ключ API не потрібен. Неофіційна інтеграція на основі HTML.
Резервний варіант без ключа. API-ключ не потрібен. Неофіційна інтеграція на основі HTML.
</Card>
<Card title="Exa" icon="brain" href="/uk/tools/exa-search">
Нейронний + ключовий пошук із витягуванням вмісту (виділення, текст, підсумки).
</Card>
<Card title="Firecrawl" icon="flame" href="/uk/tools/firecrawl">
Структуровані результати. Найкраще поєднувати з `firecrawl_search` і `firecrawl_scrape` для глибокого витягування.
Структуровані результати. Найкраще використовувати разом із `firecrawl_search` і `firecrawl_scrape` для глибокого витягування.
</Card>
<Card title="Gemini" icon="sparkles" href="/uk/tools/gemini-search">
Синтезовані ШІ відповіді з цитуваннями через прив’язку до Google Search.
Синтезовані AI відповіді з цитуваннями через Google Search grounding.
</Card>
<Card title="Grok" icon="zap" href="/uk/tools/grok-search">
Синтезовані ШІ відповіді з цитуваннями через прив’язку до вебу xAI.
Синтезовані AI відповіді з цитуваннями через xAI web grounding.
</Card>
<Card title="Kimi" icon="moon" href="/uk/tools/kimi-search">
Синтезовані ШІ відповіді з цитуваннями через вебпошук Moonshot.
Синтезовані AI відповіді з цитуваннями через вебпошук Moonshot.
</Card>
<Card title="MiniMax Search" icon="globe" href="/uk/tools/minimax-search">
Структуровані результати через пошуковий API MiniMax Coding Plan.
</Card>
<Card title="Ollama Web Search" icon="globe" href="/uk/tools/ollama-search">
Пошук через локальний хост Ollama із виконаним входом або розміщений API Ollama.
Пошук через локальний хост Ollama з виконаним входом або розміщений Ollama API.
</Card>
<Card title="Perplexity" icon="search" href="/uk/tools/perplexity-search">
Структуровані результати з керуванням витягуванням вмісту та фільтрацією доменів.
Структуровані результати з елементами керування витягуванням вмісту та фільтрацією доменів.
</Card>
<Card title="SearXNG" icon="server" href="/uk/tools/searxng-search">
Самостійно розгорнутий метапошук. Ключ API не потрібен. Агрегує Google, Bing, DuckDuckGo тощо.
Самостійно розгорнутий метапошук. API-ключ не потрібен. Агрегує Google, Bing, DuckDuckGo та інші.
</Card>
<Card title="Tavily" icon="globe" href="/uk/tools/tavily">
Структуровані результати з глибиною пошуку, фільтрацією за темою та `tavily_extract` для витягування URL.
Структуровані результати з глибиною пошуку, фільтрацією тем і `tavily_extract` для витягування URL.
</Card>
</CardGroup>
### Порівняння провайдерів
| Провайдер | Стиль результатів | Фільтри | Ключ 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 (ви отримаєте помилку про відсутній ключ
із підказкою налаштувати його).
<Note>
Усі поля ключів провайдера підтримують об’єкти SecretRef. SecretRefs в області Plugin
Усі поля ключів провайдерів підтримують об’єкти SecretRef. Plugin-обмежені SecretRefs
у `plugins.entries.<plugin>.config.webSearch.apiKey` розв’язуються для
вбудованих провайдерів вебпошуку на основі API, зокрема Brave, Exa, Firecrawl,
Gemini, Grok, Kimi, MiniMax, Perplexity і Tavily,
незалежно від того, чи провайдера вибрано явно через `tools.web.search.provider`, чи
вибрано через автовиявлення. У режимі автовиявлення OpenClaw розв’язує лише ключ
вибраного провайдера -- невибрані SecretRefs залишаються неактивними, тож можна
тримати налаштованими кілька провайдерів без витрат на розв’язання для тих,
які ви не використовуєте.
вибрано через автовиявлення. У режимі автовиявлення OpenClaw розв’язує лише
ключ вибраного провайдера -- невибрані SecretRefs залишаються неактивними, тож ви можете
тримати кілька провайдерів налаштованими без витрат на розв’язання для тих,
які не використовуєте.
</Note>
## Конфігурація
@ -219,36 +219,36 @@ OpenClaw також містить `x_search` для дописів X (рані
}
```
Конфігурація, специфічна для провайдера (ключі API, базові URL, режими), розміщується в
Специфічна для провайдера конфігурація (API-ключі, базові URL, режими) розміщується в
`plugins.entries.<plugin>.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
<Tabs>
<Tab title="Файл конфігурації">
@ -272,13 +272,13 @@ OpenClaw також може запропонувати необов’язко
</Tab>
<Tab title="Змінна середовища">
Задайте змінну середовища постачальника в середовищі процесу Gateway:
Задайте змінну середовища провайдера в середовищі процесу Gateway:
```bash
export BRAVE_API_KEY="YOUR_KEY"
```
Для встановлення gateway додайте її до `~/.openclaw/.env`.
Для встановлення Gateway помістіть її в `~/.openclaw/.env`.
Див. [Змінні середовища](/uk/help/faq#env-vars-and-env-loading).
</Tab>
@ -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) |
<Warning>
Не всі параметри працюють з усіма постачальниками. Режим 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`
-- використовуйте їхні спеціалізовані інструменти для розширених параметрів.
</Warning>
## x_search
@ -325,11 +326,12 @@ OpenClaw також може запропонувати необов’язко
лише для запиту, який обслуговує цей виклик інструмента.
<Note>
xAI документує `x_search` як такий, що підтримує пошук за ключовими словами, семантичний пошук, пошук користувачів
і отримання тредів. Для статистики взаємодій на рівні окремого допису, як-от репости,
відповіді, закладки або перегляди, віддавайте перевагу цільовому пошуку за точною URL-адресою допису
або status ID. Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повернути менш
повні метадані для окремого допису. Хороший шаблон: спочатку знайдіть допис, а потім
xAI документує `x_search` як такий, що підтримує пошук за ключовими словами,
семантичний пошук, пошук користувачів і отримання тредів. Для статистики
взаємодії з окремим дописом, як-от репости, відповіді, закладки або перегляди,
надавайте перевагу цільовому пошуку за точною URL-адресою допису або ID статусу.
Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повернути
менш повні метадані окремого допису. Добрий шаблон: спершу знайдіть допис, потім
виконайте другий запит `x_search`, зосереджений на цьому точному дописі.
</Note>
@ -361,20 +363,20 @@ OpenClaw також може запропонувати необов’язко
}
```
`x_search` надсилає POST-запит до `<baseUrl>/responses`, коли
`x_search` надсилає POST-запити до `<baseUrl>/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