OpenClaw Skills: задачи, инструменты и расходы API
OpenClaw Skills описывают, когда и как агенту использовать инструменты. Навык хранится в каталоге с файлом SKILL.md; рядом могут лежать скрипты и справочные материалы. Сам текст навыка не создаёт API-ключ и не выдаёт права на файлы. Подключите модель Relay отдельно, затем проверьте один навык на тестовом документе и посмотрите, какие действия он действительно выполняет.
Что содержат OpenClaw Skills
В SKILL.md есть метаданные с именем и описанием, затем инструкции для агента. Описание помогает выбрать навык для задачи, а тело объясняет порядок работы с доступными инструментами. Скрипт рядом с инструкцией остаётся отдельным исполняемым файлом.
Не смешивайте навык и инструмент. Инструкция «прочитай CSV и найди пустые поля» объясняет задачу, но читать файл будет инструмент клиента с правами его процесса. Если чтение запрещено окружением, хороший навык должен сообщить об отказе, а не обещать успешную проверку.
Перед включением чужого навыка прочитайте инструкции и вспомогательные файлы. Ищите запуск команд, загрузку кода, отправку содержимого на внешний адрес и обращения к секретам. Название «анализ таблицы» не доказывает, что пакет только читает таблицу.
Как подключить модель Relay
Используйте инструкцию OpenClaw в документации Relay и руководство установленной версии клиента. В ней описан пользовательский провайдер Chat Completions с базовым адресом https://relay-llm.ru/v1. Выберите точный ID из каталога, например gpt-6-sol.
Создайте отдельный ключ для испытания навыков и передайте его процессу через окружение. Не помещайте секрет в SKILL.md: содержимое навыка предназначено для чтения агентом, а не для хранения доступов. Лимит расходов ключа настройте в кабинете до длинной цепочки вызовов.
Сначала задайте модели короткий вопрос без навыка. Если ответ не пришёл, проверьте ключ, адрес и ID. Подключение навыка не исправляет ошибку авторизации. Формат базового API разобран в документации Chat Completions.
Как написать первый навык для чтения документа
Возьмите одну задачу без внешних сервисов: найти противоречия в обезличенной заметке. Подготовьте отдельный каталог навыка и файл SKILL.md. Место размещения и способ загрузки сверяйте с руководством вашей версии OpenClaw.
---
name: review-test-note
description: Проверить тестовую заметку на противоречия с опорой на цитаты.
---
Прочитай только файл, который явно указал пользователь.
Выпиши противоречащие друг другу утверждения и точные цитаты.
Если противоречий нет, сообщи об этом без добавления новых фактов.
Если файл недоступен, остановись и сообщи, что прочитать его не удалось.
Не изменяй файл. Не запускай команды. Не вызывай сетевые инструменты.Эти строки задают поведение, но права процесса нужно ограничить отдельно. Для проверки оставьте в рабочем каталоге только тестовую заметку и отключите инструменты записи и запуска команд, если клиент поддерживает такие ограничения. Не рассчитывайте на текстовый запрет как на изоляцию.
Положите в заметку две противоположные фразы о готовности задачи. Попросите применить навык и назвать обе цитаты. Это учебный вход: он проверяет поиск противоречия, а не качество модели на любых документах.
Как убедиться, что навык прочитан и задача выполнена
Проверьте в доступной диагностике клиента, что навык выбран и его инструкция загружена. Если агент ответил общими словами, попросите привести цитату из указанного файла. Затем сравните её с оригиналом. Само упоминание имени навыка не подтверждает чтение.
Проведите ещё два теста: заметка без противоречий и недоступный файл. В первом случае агент не должен придумывать конфликт; во втором не должен сообщать, что документ проверен. Проверьте также, что исходный файл не изменился.
Если навык не находится, последовательно проверьте имя, расположение каталога, наличие SKILL.md и условия загрузки. Некоторые навыки требуют отдельную программу или переменную окружения. Сверяйте требования пакета, не устанавливайте зависимости наугад по тексту ошибки модели.
Как остановить повторяющиеся вызовы и лишний расход
Одна задача навыка может включать несколько обращений к модели. В контекст попадают инструкции и результаты инструментов, поэтому длинный вывод команды способен увеличить расход последующих шагов. Сверьте ставку в ценах, а стоимость отдельных вызовов в журнале кабинета.
Запишите ожидаемое число действий для теста. Для нашей заметки достаточно прочитать один файл и сформировать ответ; повтор чтения без изменения входа требует объяснения. Если агент зациклился, остановите запуск и проверьте последнюю ошибку инструмента.
Задайте предел шагов или времени средствами клиента, когда такая настройка доступна. Ограничение расходов ключа защищает бюджет API, но не останавливает локальный скрипт, который уже запущен. Завершение процесса и отмену внешних действий проверяйте отдельно.
Не переносите непроверенный навык на рабочие документы сразу после удачного теста. Сначала просмотрите, какие инструменты он вызвал и куда передал текст. Для изменения файлов сделайте отдельный сценарий с копиями и проверкой разницы.
FAQ
Чем OpenClaw Skills отличаются от API-ключа?
Навык задаёт инструкции агенту. Ключ Relay авторизует вызовы модели. Доступ к диску и командам определяется клиентом и окружением.
Почему навык не загрузился?
Проверьте расположение, файл SKILL.md и требования пакета. Названия параметров загрузки берите из руководства вашей версии OpenClaw.
Можно ли хранить ключ Relay внутри навыка?
Не помещайте секрет в инструкции и репозиторий. Передавайте его процессу через защищённое окружение по инструкции подключения.
Гарантирует ли навык отсутствие ошибок в документе?
Нет. Проверяйте результат по исходному тексту и сохраняйте случаи, на которых навык пропустил или придумал противоречие.