Hermes VK Messenger Plugin
Плагин ВКонтакте для Hermes Agent: бот группы принимает личные сообщения и беседы по Long Poll API, агент отвечает от имени сообщества
- 1 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Плагин читает переписку сообщества и отвечает от его имени по токену группы
- При политике `open` бот отвечает любому написавшему, а нагрузка и расходы на модель ложатся на вас
Установка
- Сервисы
Ручная установка
cp -r hermes-vk-plugin ~/.hermes/plugins/vk && hermes plugins enable vkИз каталога с клоном репозитория. Сначала установите aiohttp в окружение Hermes.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Плагин читает переписку сообщества и отвечает от его имени по токену группы
- При политике `open` бот отвечает любому написавшему, а нагрузка и расходы на модель ложатся на вас
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин подключает Hermes Agent к ВКонтакте как еще одну платформу сообщений. Он использует Bots Long Poll API сообщества: адаптер запрашивает сервер Long Poll через `groups.getLongPollServer`, запускает бесконечный цикл опроса и получает события `message_new`. Каждое входящее сообщение превращается в событие Hermes, а ответ агента уходит методом `messages.send` от имени группы. Работают личные сообщения и беседы, поддерживается формат событий Callback API. Платформа регистрируется автоматически через `_missing_()`, поэтому исходный код Hermes править не нужно. Доступ регулируют политики `open`, `allowlist` и `disabled` отдельно для личных сообщений и бесед, а список разрешенных пользователей задает `VK_ALLOWED_USERS`. В репозитории всего четыре файла: `plugin.yaml` с метаданными, `__init__.py` с регистрацией платформы, `adapter.py` с классом `VKAdapter` и README. Коннектор принудительно использует IPv4, так как в WSL ВКонтакте не отвечает по IPv6.
Для кого. Владельцам сообществ ВКонтакте и пользователям Hermes Agent, которые хотят дать агенту канал общения с подписчиками через сообщения группы.
Подходит, если
- Сообщество ВКонтакте получает вопросы в личку, и на них отвечает агент Hermes
- Агент должен работать в беседе сообщества и видеть новые сообщения в реальном времени
- Доступ надо ограничить списком пользователей, чтобы бот не отвечал посторонним
- Уведомления по расписанию отправляются в заданный канал через `VK_HOME_CHANNEL`
- Hermes работает в WSL, где обычные соединения ВКонтакте по IPv6 не проходят
Не подходит, если
- Агент работает не на Hermes: плагин пишется под его реестр платформ и класс адаптера
- Нужен личный профиль, а не сообщество: Long Poll бота доступен только сообществу с токеном группы
- Требуются публикации на стене, рекламные кабинеты и аналитика: плагин читает и отправляет сообщения, остального в нем нет
- Hermes не поддерживает `Platform._missing_()` в вашей версии: плагин на этом механизме построен
Пример запроса к агенту
Пусть агент отвечает на вопросы подписчиков в сообщениях группы, а новым участникам объясняет, как пользоваться сервисом.Ограничения
Нужны Hermes Agent с поддержкой `Platform._missing_()`, Python 3.11, пакет aiohttp и токен сообщества ВКонтакте с правами на сообщения. Токен и идентификатор группы задают в `.env` как `VK_GROUP_TOKEN` и `VK_GROUP_ID`.
Перед запуском `hermes gateway run` нужно остановить старые процессы командой `pkill -f 'hermes gateway'`, иначе защитный механизм блокирует старт. В классе `connect()` добавлен параметр `is_reconnect` для совместимости с шлюзом.
Плагин небольшой и написан одним автором. Тестов и файла лицензии в репозитории нет, но в README указана лицензия MIT. Токен группы открывает переписку сообщества, поэтому хранить его нужно только в окружении.
Как отключить. Выключите плагин командой `hermes plugins disable vk` или удалите папку `~/.hermes/plugins/vk`. Токен группы отзовите в настройках сообщества ВКонтакте.
Частые вопросы
Как подключить ВКонтакте к Hermes Agent?
Скопируйте плагин командой `cp -r hermes-vk-plugin ~/.hermes/plugins/vk`, установите aiohttp и включите плагин: `hermes plugins enable vk`. В `.env` задайте `VK_GROUP_TOKEN` и `VK_GROUP_ID`, затем запустите `hermes gateway run --verbose`.
Какой токен нужен ВКонтакте?
Токен сообщества с правами на сообщения. Он выдается в настройках группы, и от ее имени агент отвечает пользователям.
Как ограничить, кому отвечает бот?
Политики `dm_policy` и `group_policy` принимают значения `open`, `allowlist` и `disabled`. Список пользователей задает `VK_ALLOWED_USERS`, а `VK_ALLOW_ALL_USERS=true` разрешает всех.
Почему плагин принудительно использует IPv4?
В WSL ВКонтакте не отвечает по IPv6, поэтому коннектор выбирает только IPv4. Это сделано для окружений без рабочего IPv6.
Что делать, если шлюз Hermes не стартует?
Остановите старые процессы командой `pkill -f 'hermes gateway'` и запустите шлюз заново. Защитный механизм блокирует второй экземпляр, пока первый не завершен.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ВКонтакте — все инструментыHermes VK Adapter
hermes-vk-adapter
Плагин подключает личные сообщения сообщества ВКонтакте к Hermes Agent через Bots Long Poll без публичного адреса и вебхука
hermes-vk (TemArt90)
hermes-vk
Канал ВКонтакте для Hermes Agent: Long Poll, кнопки и выбор модели в диалоге, голосовые, картинки, доставка cron-отчетов и парное подтверждение
Плагин-канал Claude Code: переписка с сессией агента через сообщество ВКонтакте с мобильного или веба
vk-mcp (alexfisenkov)
vk-mcp
Удаленный MCP-сервер для сообществ ВКонтакте: 50 инструментов, посты, комментарии, диалоги, фото, видео и товары, запись выключена по умолчанию
MCP-мост из VK в Telegram
vk-tg-bridge
MCP-сервер на 4 инструмента: забирает посты со стены VK, фильтрует по правилам и публикует в Telegram через Bot API
VK MCP Server (ORAMAN)
VK-MCP-Server
Локальный MCP-сервер для VK API: поиск людей и городов, профили, фото и видео с HTML-галереей, пул токенов и кэш SQLite
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Hermes VK Messenger Plugin (эта карточка) | нет | 1 | |
| MAX-шлюз для Hermes Agent | нет | 17 | шлюз Hermes для мессенджера MAX, а не для ВКонтакте |
| Alice Voice для Hermes | нет | 11 | голосовой плагин для Алисы, без сообщений сообщества |
Коротко о README
README коротко описывает возможности, шаги установки, настройки `.env` и `config.yaml`, запуск шлюза, принцип работы адаптера и известные особенности. Автор указан как Арнис, лицензия MIT.