Zaileys — скилл
Скилл учит агента писать, чинить и выкладывать ботов WhatsApp на библиотеке zaileys, в Web-режиме и через Cloud API.
- 81 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Бот отправляет сообщения от имени вашего номера WhatsApp, а при неофициальном соединении аккаунт может заблокировать WhatsApp.
- Сценарий `doctor.mjs` читает файлы проекта и с флагом `--online` обращается к сети.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/zaileysОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Бот отправляет сообщения от имени вашего номера WhatsApp, а при неофициальном соединении аккаунт может заблокировать WhatsApp.
- Сценарий `doctor.mjs` читает файлы проекта и с флагом `--online` обращается к сети.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл `zaileys` сопровождает работу над ботами WhatsApp на TypeScript. Агент начинает проект, добавляет функции, разбирает ошибки и проверяет бота перед выкладкой. Для каждой задачи есть сценарий: новый бот, новая функция, отладка, обзор перед продакшеном, обновление и деплой. Скилл покрывает оба способа связи, которые библиотека прячет за одним клиентом: WhatsApp Web через QR-код или код сопряжения и официальный Cloud API от Meta с вебхуками и шаблонами. Рядом лежат справочники по отправке и приему сообщений, группам, сессиям, кодам ошибок, плюс шаблоны проектов и сценарий `doctor.mjs`, который только читает проект и сообщает о проблемах.
Для кого. Node.js-разработчикам, которые делают бота WhatsApp и просят агента написать код без выдуманных методов старой версии.
Подходит, если
- Нужен бот с автоответами и командами, и вы начинаете проект с нуля.
- Бот перестал отвечать, а в логе цикл входа или код ошибки.
- Рассылка и отложенные сообщения добавляются к уже работающему боту.
- Сервис переносят с неофициального соединения на Cloud API с шаблонами сообщений.
Не подходит, если
- Код написан на whatsapp-web.js, голом Baileys или Twilio, и менять библиотеку не планируется.
- Нужен бот для другого мессенджера.
- Версия zaileys ниже четвертой: скилл рассчитан на v4.
Пример запроса к агенту
Сделай бота WhatsApp на zaileys с командой `/menu`, ответом картинкой и запуском через Cloud API, затем проверь его на готовность к продакшену.Ограничения
Скилл рассчитан на Node.js 20 и новее и на четвертую версию библиотеки. Соединение через WhatsApp Web неофициальное, поэтому аккаунт могут заблокировать. У официального Cloud API такой угрозы нет, зато в нем нет групп, каналов, опросов, команд, плагинов и рассылок. Писать первыми пользователям, которые не обращались, можно только по одобренным шаблонам. Сам скилл нужно ставить отдельной командой, а не вместе с библиотекой.
Как отключить. Удалите плагин `zaileys-official` через менеджер плагинов или папку скилла, добавленную командой `npx skills`. Сессии и ключи бота храните и очищайте отдельно.
Частые вопросы
Как поставить скилл в Claude Code?
Выполните `/plugin marketplace add zeative/zaileys`, затем `/plugin install zaileys-official@zeative`. Для Codex, Cursor, OpenCode и других подойдет `npx skills add zeative/zaileys`, с флагом `-g` для глобальной установки.
Чем Web-режим отличается от Cloud API?
Web входит по QR-коду как обычное связанное устройство и умеет группы, каналы и рассылки, но аккаунт может получить бан. Cloud API использует постоянный токен и шаблоны, зато без групп и команд.
Что делает doctor.mjs?
Сценарий только читает проект и сообщает о проблемах: `node scripts/doctor.mjs <проект>`. Флаги `--json` и `--online` дают машинный вывод и проверку по сети.
Почему агенту нельзя писать код по памяти?
Код версии 3 и привычки голого Baileys в четвертой версии не компилируются. Поэтому скилл велит сверяться с установленным пакетом и файлом типов `dist/index.d.ts`.
Помогает ли скилл с обновлением?
Да, для обновления внутри четвертой версии и деплоя есть отдельный сценарий и справочник по миграции.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыClaude Code берет интервью о вашем бизнесе и сам пишет, тестирует и выкладывает бота для WhatsApp с памятью клиентов
Четыре скилла подключают агента к WhatsApp через Kapso: интеграция, автоматизация, звонки и разбор логов доставки.
Скилл chat-sdk от Vercel: агент пишет ботов для Slack, Teams, Discord и Telegram на одном коде и подбирает нужные адаптеры.
Плагин со скиллом zapier-sdk: агент пишет код для более 9000 приложений Zapier, а ключи действий берет из живого каталога
WeChat Automation API
wechat-automation-api
Скилл для агентов на Windows: отправляет текст, картинки и файлы через уже запущенный десктопный WeChat, также есть HTTP API с очередью
Плагин Claude Code с каналом WhatsApp: сессия отвечает на сообщения и пишет с вашего номера или через официальный Cloud API
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Zaileys (эта карточка) | нет | 81 | ||
| WhatsApp AgentKit | нет | 562 | workflow для сборки агента в WhatsApp; здесь скилл по коду ботов на конкретной библиотеке | |
| WhatsApp MCP Server | нет | не нужна | 6 866 | MCP-сервер, через который агент сам читает и пишет в WhatsApp; Zaileys помогает писать код бота |
Коротко о README
README библиотеки сравнивает два способа подключения к WhatsApp в таблице, показывает код клиента и отдельным разделом описывает скилл для агентов. Установка скилла описана двумя способами.
Бейдж для README
Исходный SKILL.md
--- name: zaileys description: >- Builds, extends, debugs, reviews, upgrades, and deploys WhatsApp bots written with zaileys, the TypeScript WhatsApp library for WhatsApp Web (QR or pairing-code login) and the official Meta Cloud API (webhooks, templates). license: MIT compatibility: Node.js 20 or newer; zaileys v4 --- # zaileys zaileys (npm `zaileys`, docs https://zaileys.kejaa.id) wraps two ways of talking to WhatsApp behind one `Client`: WhatsApp Web (`provider: 'baileys'`, the default, a linked device of a normal account) and the Cloud API (`provider: 'cloud'`, Meta's official API for business numbers).