hermes-vk (TemArt90) — плагин
hermes-vk
Канал ВКонтакте для Hermes Agent: Long Poll, кнопки и выбор модели в диалоге, голосовые, картинки, доставка cron-отчетов и парное подтверждение
- 0 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Токен сообщества открывает переписку подписчиков и позволяет отправлять сообщения от имени сообщества
- Агент Hermes выполняет команды из чата, а подтверждение опасных действий идет кнопками
Установка
- Сервисы
Ручная установка
git clone https://github.com/TemArt90/hermes-vk ~/.hermes/plugins/platforms/vkЗатем `hermes plugins enable vk-platform` и `hermes gateway restart`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Токен сообщества открывает переписку подписчиков и позволяет отправлять сообщения от имени сообщества
- Агент Hermes выполняет команды из чата, а подтверждение опасных действий идет кнопками
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин-адаптер на Python подключает Hermes Agent к сообществу ВКонтакте. Входящие сообщения идут через Bots Long Poll API, исходящие через `messages.send`, поэтому домен, вебхук и публичный адрес не нужны. Реализация независимая, под контракт платформенных плагинов Hermes, поток и форматы сверены с плагином openclaw-vk. Плагин переводит Markdown в VK `format_data` с жирным, курсивом и ссылками, превращает таблицы в заголовок с пунктами, режет текст под лимит 4000 символов и отправляет картинки, файлы и голосовые Ogg Opus через `ffmpeg`. Inline-клавиатура с `message_event` служит для вопросов агента и подтверждения опасных команд, а `/model`, `/reasoning` и `/fast` выбираются кнопками. Инструмент `vk_checklist` рисует список, где тап вычеркивает пункт, а состояние хранится в `vk_widgets.json`. Доступ ограничивают списком `VK_ALLOWED_USERS` или парным подтверждением по коду. Отчеты по расписанию уходят в `VK_HOME_CHANNEL`. Личный ключ `VK_USER_TOKEN` нужен только для нативной отправки видео. Лицензия Apache-2.0.
Для кого. Тем, кто держит Hermes Agent на сервере и хочет полноценный чат с ним в ВКонтакте: с кнопками, голосом, картинками и отчетами по расписанию.
Подходит, если
- Утренний отчет по расписанию приходит агенту владельца прямо в личные сообщения VK
- Модель или режим рассуждений Hermes меняют кнопками в диалоге, не вводя команду
- Агент присылает фото и файлы, а голосовые уходят как сообщения Ogg Opus
- Список покупок ведется в сообщении с кнопками, где тап вычеркивает пункт
- В беседе бот отвечает только при упоминании
Не подходит, если
- Hermes Agent не установлен: плагин написан под его платформенный контракт
- Входящее видео надо скачать: VK не отдает его ни с одним ключом
- Сообщество нельзя перевести в режим чат-бота: без него VK отвечает ошибкой на клавиатуры
Пример запроса к агенту
Присылай мне в личку VK сводку по расписанию каждое утро в восемь и покажи кнопками, какую модель использовать.Ограничения
Нужны Hermes Agent с Python-окружением, ключ доступа сообщества с правами «Сообщения сообщества» и «Управление сообществом» и включенный Long Poll с событиями «Входящие сообщения» и «Действие с сообщением». Для кнопок включают режим «Чат-бот», иначе VK отвечает ошибкой 912 и адаптер деградирует до нумерованного текста.
Свернуть голосовые без `ffmpeg` нельзя: файл уходит документом. Inline-клавиатура VK ограничена десятью кнопками, альбом из нескольких картинок принимает не больше десяти вложений. Нативная отправка видео требует личного токена с правом «Видео». После установки перезапустите шлюз командой `hermes gateway restart` в отдельном терминале.
Как отключить. Выполните `hermes plugins disable vk-platform`, удалите каталог `~/.hermes/plugins/platforms/vk` и уберите `VK_TOKEN` из `~/.hermes/.env`.
Частые вопросы
Как поставить hermes-vk?
Выполните `git clone https://github.com/TemArt90/hermes-vk ~/.hermes/plugins/platforms/vk` и `hermes plugins enable vk-platform`, затем перезапустите шлюз в отдельном терминале.
Нужен ли вебхук или домен?
Нет. Long Poll работает как исходящее длинное соединение, поэтому канал живет и там, где входящие подключения недоступны.
Зачем нужен личный токен?
Только для нативной отправки видео: метод `video.save` относится к пользовательскому уровню, и ключ сообщества получает от VK ошибку 5.
Как ограничить круг пользователей?
Задайте `VK_ALLOWED_USERS` списком VK id или оставьте его пустым и подтверждайте новых пользователей парным кодом.
Как бот ведет себя в беседах?
По умолчанию отвечает на все, а `VK_REQUIRE_MENTION=true` включает ответ только на упоминание бота. Для отдельных бесед есть `VK_REQUIRE_MENTION_BY_PEER`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ВКонтакте — все инструментыПлагин ВКонтакте для Hermes Agent: бот группы принимает личные сообщения и беседы по Long Poll API, агент отвечает от имени сообщества
Hermes VK Adapter
hermes-vk-adapter
Плагин подключает личные сообщения сообщества ВКонтакте к Hermes Agent через Bots Long Poll без публичного адреса и вебхука
Плагин-канал Claude Code: переписка с сессией агента через сообщество ВКонтакте с мобильного или веба
VK MCP Server (ORAMAN)
VK-MCP-Server
Локальный MCP-сервер для VK API: поиск людей и городов, профили, фото и видео с HTML-галереей, пул токенов и кэш SQLite
vk-mcp (alexfisenkov)
vk-mcp
Удаленный MCP-сервер для сообществ ВКонтакте: 50 инструментов, посты, комментарии, диалоги, фото, видео и товары, запись выключена по умолчанию
MCP-мост из VK в Telegram
vk-tg-bridge
MCP-сервер на 4 инструмента: забирает посты со стены VK, фильтрует по правилам и публикует в Telegram через Bot API
Коротко о README
README подробно описывает таблицу возможностей, установку, настройку сообщества, таблицу переменных, получение личного токена скриптом, замеры ограничений VK и разработку; в начале есть краткое английское резюме.