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 03:45:14 +00:00
parent 0878b5a371
commit 7200ef4356
2 changed files with 120 additions and 118 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
docs/uk/tools/brave-search.md
View File

@ -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) -- нейронний пошук із витягуванням вмісту

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

@ -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 під капотом.
<Info>
`web_search` — це легкий HTTP-інструмент, а не браузерна автоматизація. Для
@ -32,20 +32,20 @@ OpenClaw також включає `x_search` для дописів X (рані
## Швидкий старт
<Steps>
<Step title="Choose a provider">
Виберіть провайдера й виконайте потрібне налаштування. Деякі провайдери
не потребують ключів, тоді як інші використовують API-ключі. Докладніше
дивіться на сторінках провайдерів нижче.
<Step title="Виберіть провайдера">
Виберіть провайдера й виконайте всі потрібні кроки налаштування. Деякі провайдери
не потребують ключа, а інші використовують ключі API. Докладніше дивіться
на сторінках провайдерів нижче.
</Step>
<Step title="Configure">
<Step title="Налаштуйте">
```bash
openclaw configure --section web
```
Це зберігає провайдера й потрібні облікові дані. Також можна встановити змінну
середовища (наприклад `BRAVE_API_KEY`) і пропустити цей крок для провайдерів
на основі API.
Це зберігає провайдера та всі потрібні облікові дані. Також можна задати змінну
середовища (наприклад `BRAVE_API_KEY`) і пропустити цей крок для провайдерів,
що працюють через API.
</Step>
<Step title="Use it">
<Step title="Використовуйте">
Тепер агент може викликати `web_search`:
```javascript
@ -68,72 +68,72 @@ OpenClaw також включає `x_search` для дописів X (рані
Структуровані результати з фрагментами. Підтримує режим `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` для глибокого витягування.
</Card>
<Card title="Gemini" icon="sparkles" href="/uk/tools/gemini-search">
AI-синтезовані відповіді з цитуваннями через прив’язку до Google Search.
Синтезовані ШІ відповіді з цитуваннями через прив’язку до Google Search.
</Card>
<Card title="Grok" icon="zap" href="/uk/tools/grok-search">
AI-синтезовані відповіді з цитуваннями через вебприв’язку xAI.
Синтезовані ШІ відповіді з цитуваннями через прив’язку до вебу xAI.
</Card>
<Card title="Kimi" icon="moon" href="/uk/tools/kimi-search">
AI-синтезовані відповіді з цитуваннями через вебпошук Moonshot.
Синтезовані ШІ відповіді з цитуваннями через вебпошук Moonshot.
</Card>
<Card title="MiniMax Search" icon="globe" href="/uk/tools/minimax-search">
Структуровані результати через пошуковий API MiniMax Coding Plan.
</Card>
<Card title="Ollama Web Search" icon="globe" href="/uk/tools/ollama-search">
Пошук через локальний хост Ollama з виконаним входом або розміщений Ollama API.
Пошук через локальний хост Ollama із виконаним входом або розміщений API Ollama.
</Card>
<Card title="Perplexity" icon="search" href="/uk/tools/perplexity-search">
Структуровані результати з керуванням витягуванням вмісту й фільтрацією доменів.
Структуровані результати з керуванням витягуванням вмісту та фільтрацією доменів.
</Card>
<Card title="SearXNG" icon="server" href="/uk/tools/searxng-search">
Самостійно розгорнутий метапошук. 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-ключ |
| Провайдер | Стиль результатів | Фільтри | Ключ 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 як резервний варіант (ви отримаєте помилку про відсутній ключ
із пропозицією налаштувати його).
<Note>
Усі поля ключів провайдерів підтримують об’єкти SecretRef. SecretRef у межах Plugin
Усі поля ключів провайдера підтримують об’єкти SecretRef. SecretRefs в області Plugin
у `plugins.entries.<plugin>.config.webSearch.apiKey` розв’язуються для
вбудованих провайдерів вебпошуку на основі API, зокрема Brave, Exa, Firecrawl,
Gemini, Grok, Kimi, MiniMax, Perplexity і Tavily,
незалежно від того, чи провайдера вибрано явно через `tools.web.search.provider`, чи
вибрано через автовиявлення. У режимі автовиявлення OpenClaw розв’язує лише
ключ вибраного провайдера -- невибрані SecretRef залишаються неактивними, тож можна
вибрано через автовиявлення. У режимі автовиявлення OpenClaw розв’язує лише ключ
вибраного провайдера -- невибрані SecretRefs залишаються неактивними, тож можна
тримати налаштованими кілька провайдерів без витрат на розв’язання для тих,
які ви не використовуєте.
</Note>
@ -219,38 +219,39 @@ OpenClaw також включає `x_search` для дописів X (рані
}
```
Конфігурація, специфічна для провайдера (API-ключі, базові URL, режими), міститься в
`plugins.entries.<plugin>.config.webSearch.*`. Приклади дивіться на сторінках провайдерів.
Конфігурація, специфічна для провайдера (ключі 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, налаштований у
`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-ключів
<Tabs>
<Tab title="Config file">
<Tab title="Файл конфігурації">
Запустіть `openclaw configure --section web` або задайте ключ напряму:
```json5
@ -270,14 +271,14 @@ OpenClaw також може запропонувати необов’язко
```
</Tab>
<Tab title="Environment variable">
<Tab title="Змінна середовища">
Задайте змінну середовища постачальника в середовищі процесу Gateway:
```bash
export BRAVE_API_KEY="YOUR_KEY"
```
Для встановлення gateway додайте її в `~/.openclaw/.env`.
Для встановлення gateway додайте її до `~/.openclaw/.env`.
Див. [Змінні середовища](/uk/help/faq#env-vars-and-env-loading).
</Tab>
@ -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) |
<Warning>
Не всі параметри працюють з усіма постачальниками. Режим 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`
-- використовуйте їхні спеціальні інструменти для розширених параметрів.
</Warning>
## x_search
`x_search` виконує запити до дописів X (раніше Twitter) за допомогою xAI та повертає
`x_search` запитує дописи X (раніше Twitter) за допомогою xAI і повертає
синтезовані AI відповіді з цитуваннями. Він приймає запити природною мовою та
необов’язкові структуровані фільтри. OpenClaw вмикає вбудований інструмент xAI `x_search`
лише для запиту, який обслуговує цей виклик інструмента.
<Note>
xAI документує `x_search` як такий, що підтримує пошук за ключовими словами, семантичний пошук, пошук користувачів
і отримання гілок. Для статистики взаємодії з окремим дописом, як-от репости,
і отримання тредів. Для статистики взаємодій на рівні окремого допису, як-от репости,
відповіді, закладки або перегляди, віддавайте перевагу цільовому пошуку за точною URL-адресою допису
або ID статусу. Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повернути менш
повні метадані окремого допису. Хороший шаблон: спочатку знайдіть допис, а потім
виконайте другий запит `x_search`, сфокусований на цьому точному дописі.
або status ID. Широкі пошуки за ключовими словами можуть знайти потрібний допис, але повернути менш
повні метадані для окремого допису. Хороший шаблон: спочатку знайдіть допис, а потім
виконайте другий запит `x_search`, зосереджений на цьому точному дописі.
</Note>
### Конфігурація x_search
@ -359,10 +361,10 @@ 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
@ -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-хост