Как создать собственный навык OpenClaw
Расширьте возможности своего агента, создавая собственные навыки. Опубликуйте в магазине и получайте доход.
Введение
Навыки OpenClaw — это MCP-серверы (Model Context Protocol), которые предоставляют инструменты агенту. Когда вы создаете навык, вы даете своему агенту новые возможности — от доступа к API до управления оборудованием и обработки файлов. Навыки — это основной способ заставить вашего агента OpenClaw делать что-то большее, чем просто разговаривать.
Предварительные требования
- Установлен Node.js 18+ или Python 3.10+
- Базовые знания программирования (рекомендуется TypeScript или Python)
- Учетная запись KiwiClaw с активным агентом для тестирования
- Знакомство с архитектурой OpenClaw
Пошаговые инструкции
Шаг 1. Изучите формат навыка
Навык OpenClaw — это MCP-сервер, предоставляющий один или несколько инструментов. Каждый инструмент имеет имя, описание, схему ввода и функцию-обработчик. Агент обнаруживает доступные инструменты и решает, когда их вызывать, на основе контекста разговора.
Шаг 2. Настройте среду разработки
Создайте новый каталог проекта. Если используете TypeScript, инициализируйте с помощью npm init и установите MCP SDK. Если используете Python, настройте виртуальную среду и установите пакет MCP Python.
Шаг 3. Создайте манифест навыка
Определите метаданные своего навыка: имя, версию, описание, автора и список предоставляемых им инструментов. Этот манифест сообщает OpenClaw, что может делать ваш навык.
Шаг 4. Напишите обработчики инструментов
Реализуйте функции для каждого инструмента. Обработчик инструмента получает входные параметры и возвращает результат. Например, навык погоды может принимать название города и возвращать текущий прогноз, вызывая API погоды.
Шаг 5. Протестируйте локально
Запустите свой навык локально и протестируйте его на своем агенте KiwiClaw. Установите навык с помощью страницы навыков на панели управления, указав на свой локальный сервер. Убедитесь, что каждый инструмент работает правильно.
Шаг 6. Опубликуйте в магазине
Когда ваш навык будет готов, отправьте его в магазин навыков KiwiClaw. Наша команда проверяет заявки на безопасность и качество. После одобрения другие пользователи смогут установить ваш навык. Вы можете установить его как бесплатный или платный.
Советы профессионалов
- Начните с Создателя навыков — Этот мета-навык помогает вашему агенту создавать другие навыки, генерируя шаблонный код для вас.
- Сосредоточьтесь на инструментах — Каждый инструмент должен хорошо выполнять одно действие. Несколько небольших инструментов лучше, чем один сложный инструмент.
- Обрабатывайте ошибки корректно — Возвращайте информативные сообщения об ошибках, чтобы агент мог объяснить пользователю, что пошло не так.
- Добавьте хорошие описания — Агент использует описания инструментов, чтобы решить, когда их вызывать. Четкие, конкретные описания приводят к лучшему выбору инструментов.
Часто задаваемые вопросы
Какой язык программирования я могу использовать для навыков OpenClaw?
Навыки OpenClaw — это MCP-серверы, поэтому вы можете использовать любой язык, поддерживающий протокол MCP. Большинство навыков написаны на TypeScript или Python, но Go, Rust и другие языки тоже работают.
Могу ли я монетизировать свой навык OpenClaw?
Да. Опубликуйте свой навык в магазине KiwiClaw и установите цену. KiwiClaw занимается платежами, распространением и проверками. Вы получаете доход каждый раз, когда кто-то устанавливает ваш платный навык. См. наше руководство по публикации для получения подробной информации.
Как навыки проверяются на безопасность?
Все заявки в магазин проходят процесс проверки KiwiClaw. Мы проверяем исходный код, ищем вредоносное поведение, проверяем разрешения и тестируем функциональность, прежде чем одобрить навык для магазина.