Веб-поиск в OpenClaw — все провайдеры, настройка, сравнение

OpenClaw умеет искать информацию в интернете — и это одна из его самых полезных функций. Вместо того чтобы отвечать только из памяти модели, агент находит актуальные данные, проверяет факты и ссылается на источники.

Доступно 10 провайдеров поиска, включая бесплатные варианты без API-ключа. В этой статье — сравнение всех провайдеров, пошаговая настройка и рекомендации.

Как это работает

Когда вы задаёте агенту вопрос, требующий актуальной информации (новости, цены, документация), OpenClaw:

1. Отправляет поисковый запрос выбранному провайдеру
2. Получает результаты (ссылки, сниппеты или AI-синтезированные ответы)
3. Использует их как контекст для ответа
4. Кеширует результаты (по умолчанию 15 минут)

Сравнение всех провайдеров

Классический поиск (структурированные результаты)

Провайдеры возвращают список ссылок с заголовками и сниппетами — как обычный поисковик.

Провайдер	API-ключ	Бесплатно	Фильтры	Особенности
Brave Search	Да	~1000 запросов/мес	Страна, язык, дата	Приоритет #1, стабильный, LLM-оптимизирован
Tavily	Да	Free tier	Глубина, домен, тема	search + extract (JS-рендеринг страниц)
Exa	Да	—	Режим поиска	Neural + keyword поиск с извлечением контента
Perplexity	Да	—	Домен, дата, язык	Два режима: структурированный и AI-синтез
Firecrawl	Да	—	—	Поиск + глубокий скрейпинг страниц

Бесплатные без API-ключа

Провайдер	Лимиты	Стабильность	Особенности
SearXNG	Безлимитно	Высокая	Self-hosted мета-поиск. Нужен Docker
DuckDuckGo	Безлимитно	Низкая	HTML-скрейпинг, experimental, может сломаться

AI-синтезированные ответы

Вместо списка ссылок эти провайдеры возвращают готовый ответ с цитатами — как если бы AI прочитал результаты за вас.

Провайдер	API-ключ	Фильтры	Модель
Gemini	GEMINI_API_KEY	Нет	gemini-2.5-flash (настраивается)
Grok	XAI_API_KEY	Нет	+ бонус: поиск по X (Twitter)
Kimi	KIMI_API_KEY	Нет	Moonshot

Какой провайдер выбрать

Хочу бесплатно и надёжно → SearXNG. Требует Docker, но после настройки — бесплатный безлимитный поиск через Google, Bing и другие движки.

Хочу бесплатно и без Docker → DuckDuckGo. Работает без ключа, но это unofficial интеграция через HTML-скрейпинг. Может перестать работать при изменениях на стороне DDG.

Хочу качество за минимальные деньги → Brave Search. $5/мес в бесплатном кредите (~1000 запросов). Стабильный, с фильтрами по стране и дате. Приоритет #1 в автоопределении OpenClaw.

Нужен глубокий анализ страниц → Tavily. Уникальная функция tavily_extract — извлечение контента даже из JS-rendered страниц. Два режима глубины: basic (быстро) и advanced (точно).

Уже используете Gemini/Grok/Kimi → соответствующий AI-поиск. Если у вас уже есть API-ключ одного из этих провайдеров — поиск заработает автоматически.

Настройка

Быстрый способ

Интерактивный мастер настройки:

openclaw configure --section web

Выберите провайдера из списка, введите API-ключ (если требуется) — готово.

Через конфиг

Откройте ~/.openclaw/openclaw.json и добавьте секцию tools.web.search:

{
  tools: {
    web: {
      search: {
        enabled: true,        // включить/выключить поиск
        provider: "brave",    // имя провайдера
        maxResults: 5,        // количество результатов (1-10)
        timeoutSeconds: 30,   // таймаут запроса
        cacheTtlMinutes: 15   // время кеширования
      }
    }
  }
}

Через переменные окружения

API-ключ можно задать через переменные среды (в ~/.openclaw/.env или системные):

Провайдер	Переменная
Brave Search	BRAVE_API_KEY
Tavily	TAVILY_API_KEY
Perplexity	PERPLEXITY_API_KEY
Gemini	GEMINI_API_KEY
Grok / xAI	XAI_API_KEY
Kimi	KIMI_API_KEY или MOONSHOT_API_KEY

Exa, Firecrawl и SearXNG настраиваются через конфиг или openclaw configure.

Настройка SearXNG (бесплатный безлимитный поиск)

SearXNG — self-hosted мета-поисковик. Агрегирует результаты из Google, Bing, DuckDuckGo и других движков. Бесплатный, без лимитов, приватный.

Шаг 1: Запуск SearXNG

docker run -d -p 8888:8080 searxng/searxng

Убедитесь, что в настройках SearXNG включён JSON-формат (файл settings.yml внутри контейнера):

search:
  formats:
    - html
    - json

Шаг 2: Настройка OpenClaw

openclaw configure --section web
# Выберите "searxng"
# Укажите URL: http://localhost:8888

Или через переменную:

export SEARXNG_BASE_URL="http://localhost:8888"

Или в openclaw.json:

{
  tools: {
    web: {
      search: {
        provider: "searxng"
      }
    }
  }
}

Дополнительные настройки SearXNG

• categories — категории поиска: "general", "news", "images" (по умолчанию: general)
• language — язык результатов: "ru", "en" и др.

SearXNG на VPS

Если OpenClaw развёрнут на VPS — SearXNG можно запустить на том же сервере:

docker run -d --name searxng --restart unless-stopped -p 127.0.0.1:8888:8080 searxng/searxng

Привязка к 127.0.0.1 — SearXNG будет доступен только локально, без открытия наружу.

Настройка Brave Search

Шаг 1: Получение API-ключа

1. Зарегистрируйтесь на brave.com/search/api
2. Выберите тариф Search (включает $5 бесплатного кредита — ~1000 запросов/мес)
3. Сгенерируйте API-ключ

Шаг 2: Настройка

openclaw configure --section web
# Выберите "brave"
# Введите API-ключ

Или через переменную:

export BRAVE_API_KEY="BSA..."

Параметры Brave

• count — количество результатов (1-10)
• country / language — ISO-коды для локализации
• freshness — фильтр по свежести: day, week, month, year
• date_after / date_before — точный диапазон дат (формат YYYY-MM-DD)

Настройка Tavily

Шаг 1: Получение API-ключа

1. Зарегистрируйтесь на tavily.com
2. Сгенерируйте ключ в личном кабинете

Шаг 2: Настройка

export TAVILY_API_KEY="tvly-..."
openclaw configure --section web

Инструменты Tavily

OpenClaw получает два инструмента:

tavily_search — поиск с параметрами:

• search_depth — basic (быстро) или advanced (точно)
• topic — general, news, finance
• max_results — от 1 до 20
• include_domains / exclude_domains — фильтр по доменам
• time_range — day, week, month, year

tavily_extract — извлечение контента из URL:

• Работает с JS-rendered страницами
• Поддерживает query-focused chunking (извлечение релевантных фрагментов)

Автоопределение провайдера

Если provider не указан в конфиге, OpenClaw автоматически выбирает провайдера по наличию API-ключей в таком порядке:

1. Brave Search
2. Gemini
3. Grok
4. Kimi
5. Perplexity
6. Firecrawl
7. Tavily
8. DuckDuckGo
9. SearXNG

Если ни одного ключа нет — поиск работает через DuckDuckGo (без гарантий стабильности) или SearXNG (если настроен).

Общие настройки

Ограничение результатов

{
  tools: {
    web: {
      search: {
        maxResults: 3  // меньше результатов = меньше токенов = дешевле
      }
    }
  }
}

Отключение поиска

{
  tools: {
    web: {
      search: {
        enabled: false
      }
    }
  }
}

Ограничение размера ответа (web fetch)

{
  tools: {
    web: {
      fetch: {
        maxResponseBytes: 1048576  // 1 MB лимит на скачивание страницы
      }
    }
  }
}

Рекомендации

• Для экономии — начните с SearXNG или DuckDuckGo, перейдите на Brave при необходимости
• Для продакшена — Brave Search (стабильный, с фильтрами) или Tavily (если нужен extract)
• Для AI-ответов — Gemini (бесплатный tier Google AI Studio) или Grok (если нужен поиск по X)
• Уменьшите maxResults до 3, если хотите сэкономить на токенах — меньше результатов поиска попадает в контекст модели
• Не забывайте про кеш — повторные запросы в течение 15 минут не тратят квоту провайдера

Полезные ссылки

• Документация OpenClaw: Web Search — официальный гайд
• Настройка SearXNG — подробная инструкция
• Все модели для OpenClaw — какие модели доступны
• Настройка OpenClaw — полный гайд по конфигурации
• OpenClaw бесплатно — как использовать без затрат