Tavily Web Search Skill for OpenClaw

Лёгкий навык веб-поиска Tavily для OpenClaw, который работает без использования pip и сторонних Python-пакетов. Решение ориентировано на минималистичные окружения и упрощённые серверные конфигурации.

Обзор

Этот навык реализует поиск через Tavily API, используя только стандартную библиотеку Python. Он не требует установки дополнительных зависимостей и подходит для систем, где установка пакетов ограничена или нежелательна.

• Raspberry Pi
• Ubuntu Server
• малые VPS
• изолированные или ограниченные окружения

Вместо официального SDK используется прямое обращение к REST API Tavily, что делает решение максимально лёгким и переносимым. :

Основные возможности

• Поиск в интернете через Tavily API
• Отсутствие необходимости в pip install
• Нет внешних зависимостей
• Поддержка общего поиска и новостей
• Генерация кратких ответов и работа с изображениями
• Фильтрация по доменам
• Простая интеграция в OpenClaw
• Настройка API-ключа через файл

Почему этот вариант существует

Хотя официальный Python SDK Tavily удобен, он не всегда подходит для всех сред. В ряде случаев требуется более предсказуемое и минималистичное решение.

• минимальный размер и простота
• отсутствие этапа установки зависимостей
• предсказуемое развёртывание
• совместимость с ограниченными системами

Это особенно актуально для серверов без полноценного менеджера пакетов или для систем, где важна максимальная стабильность окружения. :

Структура проекта

skills/tavily/
├── SKILL.md
├── .secrets/
│ └── tavily.key
└── scripts/
 └── tavily_search.py

Настройка API-ключа

Для работы необходимо создать директорию с секретами и добавить файл с ключом Tavily:

mkdir -p skills/tavily/.secrets
chmod 700 skills/tavily/.secrets
nano skills/tavily/.secrets/tavily.key

Файл должен содержать только сам API-ключ, например:

tvly-xxxxxxxxxxxxxxxx

После этого необходимо ограничить доступ к файлу:

chmod 600 skills/tavily/.secrets/tavily.key

Примеры использования

Базовый поиск:

python3 tavily_search.py --query "latest AI news"

Поиск новостей:

python3 tavily_search.py --query "gold prices" --topic news

Расширенный поиск:

python3 tavily_search.py --query "raspberry pi optimization" --depth advanced

JSON-вывод:

python3 tavily_search.py --query "python asyncio" --json

Поддерживаемые параметры

• --query — поисковый запрос
• --topic — тип (general или news)
• --depth — глубина поиска
• --max-results — количество результатов
• --images — включение изображений
• --include-domains — фильтр по доменам
• --exclude-domains — исключение доменов
• --json — вывод в формате JSON

Интеграция с OpenClaw

Навык используется внутри OpenClaw через файл SKILL.md. Типичный сценарий работы:

• пользователь запрашивает поиск или актуальную информацию
• OpenClaw вызывает навык Tavily
• выполняется скрипт tavily_search.py
• ключ читается из файла .secrets/tavily.key
• результаты возвращаются для последующей обработки

Требования

• Python 3
• доступ к сети
• валидный API-ключ Tavily
• отсутствие необходимости в дополнительных пакетах

Заключение

Этот навык идеально подходит для тех, кто хочет получить возможности Tavily-поиска в OpenClaw без усложнения инфраструктуры. Он обеспечивает лёгкость, надёжность и совместимость с минимальными системами, сохраняя при этом функциональность полноценного веб-поиска для AI-агентов. :