Урок 4. Инструменты ассистента#

Зачем это нужно#

AI-модель сама по себе умеет только генерировать текст. Но благодаря инструментам (tools) ваш ассистент OpenClaw может выполнять команды на компьютере, искать информацию в интернете, управлять браузером, читать и создавать файлы. Инструменты превращают ассистента из «говорящей головы» в настоящего помощника, который действует.

Какие инструменты есть#

🖥️ exec — выполнение команд#

Что делает: запускает команды в терминале (командной строке) вашего компьютера.

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

«Покажи, сколько свободного места на диске»
«Создай папку для проекта»
«Запусти скрипт обработки данных»

Как это выглядит в работе:

Вы пишете ассистенту: «Какая сейчас дата и время на сервере?»

Ассистент выполнит команду date и покажет результат.

Важные параметры:

command — команда для выполнения (обязательно)
timeout — максимальное время выполнения (по умолчанию 30 минут)
background — запустить в фоне (не ждать завершения)

Про безопасность: по умолчанию команды выполняются в изолированной среде (песочнице). Это защищает вашу систему от случайных ошибок.

🔍 web_search — поиск в интернете#

Что делает: ищет информацию в интернете через поисковую систему Brave Search.

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

«Найди текущий курс доллара»
«Какая погода завтра в Москве?»
«Найди рецепт борща»

Как настроить:

Для работы нужен бесплатный API-ключ от Brave Search:

openclaw configure --section web

Или в файле настроек:

{
  tools: {
    web: {
      search: {
        enabled: true,
        // Ключ лучше хранить в переменной окружения BRAVE_API_KEY
      }
    }
  }
}

Параметры поиска:

query — поисковый запрос
count — количество результатов (от 1 до 10)

📄 web_fetch — загрузка веб-страниц#

Что делает: открывает веб-страницу и извлекает из неё читаемый текст (убирает рекламу, меню и прочий «мусор»).

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

«Прочитай эту статью и сделай краткое изложение» (с ссылкой)
«Что написано на главной странице этого сайта?»

Параметры:

url — адрес страницы
extractMode — формат извлечения: markdown (по умолчанию) или text
maxChars — максимальное количество символов (для длинных страниц)

Ограничение: web_fetch не выполняет JavaScript. Если сайт загружается динамически (например, одностраничное приложение), лучше использовать браузер.

🌐 browser — управление браузером#

Что делает: открывает настоящий браузер и может с ним взаимодействовать — нажимать кнопки, заполнять формы, делать скриншоты.

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

«Открой сайт и сделай скриншот»
«Зайди на сайт, заполни форму и нажми кнопку отправить»
«Проверь статус заказа на сайте магазина»

Основные действия браузера:

Действие	Что делает
`start` / `stop`	Запустить / остановить браузер
`open`	Открыть новую вкладку
`snapshot`	Получить «снимок» страницы (текстовое описание элементов)
`screenshot`	Сделать снимок экрана (картинку)
`act`	Выполнить действие: нажать, ввести текст, прокрутить
`navigate`	Перейти по адресу

Как работает автоматизация браузера:

Ассистент делает snapshot — получает список элементов на странице
Находит нужный элемент (кнопку, поле ввода)
Выполняет act — нажимает или вводит текст
Проверяет результат через новый snapshot или screenshot

📁 Работа с файлами: read, write, edit#

read — прочитать содержимое файла write — создать или перезаписать файл edit — внести точечные изменения в файл

Примеры:

«Прочитай файл отчёт.txt»
«Создай файл со списком задач»
«Замени слово “черновик” на “финальная версия” в документе»

📨 message — отправка сообщений#

Что делает: отправляет сообщения в мессенджеры (Telegram, WhatsApp, Discord, Slack и другие).

Примеры:

«Отправь сообщение в Telegram-группу»
«Создай опрос в Discord»

Как управлять инструментами#

Отключение ненужных инструментов#

Если хотите запретить ассистенту использовать определённые инструменты:

{
  tools: {
    deny: ["browser"]     // запретить браузер
  }
}

Профили инструментов#

Для быстрой настройки есть готовые профили:

Профиль	Что включено
`minimal`	Только статус сессии
`coding`	Файлы, команды, сессии, память
`messaging`	Сообщения и сессии
`full`	Все инструменты (по умолчанию)

Пример — только для работы с сообщениями:

{
  tools: {
    profile: "messaging"
  }
}

Группы инструментов#

Для удобства инструменты объединены в группы:

Группа	Инструменты
`group:runtime`	exec, bash, process
`group:fs`	read, write, edit
`group:web`	web_search, web_fetch
`group:ui`	browser, canvas
`group:memory`	memory_search, memory_get
`group:messaging`	message
`group:nodes`	nodes

Пример — разрешить только файлы и браузер:

{
  tools: {
    allow: ["group:fs", "browser"]
  }
}

Практический пример#

Допустим, вы просите ассистента: «Найди в интернете курс евро к рублю и запиши в файл».

Ассистент выполнит цепочку действий:

web_search — найдёт текущий курс
write — создаст файл с результатом

Всё это происходит автоматически — вы просто формулируете задачу на обычном языке.

Итоги урока#

Инструменты — это возможности ассистента действовать в реальном мире
exec — выполняет команды на компьютере
web_search — ищет в интернете (нужен ключ Brave Search)
web_fetch — загружает и извлекает текст с веб-страниц
browser — управляет настоящим браузером
read/write/edit — работа с файлами
message — отправка сообщений в мессенджеры
Инструменты можно включать, отключать и группировать через настройки
Ассистент сам выбирает нужные инструменты для выполнения вашей задачи

Следующий урок: Навыки (Skills)