hermes-vk (TemArt90) plugin
hermes-vk
A VK channel for Hermes Agent: Long Poll, buttons and model choice in the dialog, voice, images, cron report delivery and pairing approval
- 0 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The community token opens subscriber correspondence and allows sending messages as the community
- The Hermes agent runs commands from the chat and dangerous actions are confirmed with buttons
Install
- Services
Manual install
git clone https://github.com/TemArt90/hermes-vk ~/.hermes/plugins/platforms/vkThen `hermes plugins enable vk-platform` and `hermes gateway restart`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The community token opens subscriber correspondence and allows sending messages as the community
- The Hermes agent runs commands from the chat and dangerous actions are confirmed with buttons
This is third-party code. Review the repository files before installing.
What it does
A Python adapter plugin connects Hermes Agent to a VK community. Incoming messages go through the Bots Long Poll API and outgoing ones through `messages.send`, so no domain, webhook or public address is needed. The implementation is independent, written to the Hermes platform plugin contract, with the flow and formats checked against the openclaw-vk plugin. The plugin converts Markdown into VK `format_data` with bold, italics and links, turns tables into a heading with items, cuts text to the 4000 character limit and sends images, files and Ogg Opus voice via `ffmpeg`. An inline keyboard with `message_event` serves agent questions and confirmation of dangerous commands, and `/model`, `/reasoning` and `/fast` are chosen with buttons. The `vk_checklist` tool draws a list where a tap crosses an item out and state is stored in `vk_widgets.json`. Access is limited by the `VK_ALLOWED_USERS` list or pairing approval with a code. Scheduled reports go to `VK_HOME_CHANNEL`. The personal key `VK_USER_TOKEN` is needed only for native video sending. The license is Apache-2.0.
Who it is for. Those who run Hermes Agent on a server and want a full chat with it in VK: with buttons, voice, images and scheduled reports.
Good fit when
- A morning scheduled report reaches the owner agent right in VK private messages
- The Hermes model or reasoning mode is changed with buttons in the dialog without typing a command
- The agent sends photos and files and voice goes out as Ogg Opus messages
- A shopping list is kept in a message with buttons where a tap crosses an item out
- In a group chat the bot answers only when mentioned
Not a fit when
- Hermes Agent is not installed: the plugin is written to its platform contract
- Incoming video has to be downloaded: VK does not give it with any key
- The community cannot be switched to chatbot mode: without it VK errors on keyboards
Example request
Send me a scheduled summary in VK private messages every morning at eight and show buttons for which model to use.Limitations
Hermes Agent with its Python environment, a community access key with the "community messages" and "community management" permissions and Long Poll enabled with the "Incoming messages" and "Message action" events are required. For buttons the "Chatbot" mode is turned on, otherwise VK errors with 912 and the adapter degrades to numbered text.
Voice cannot be converted without `ffmpeg`: the file goes out as a document. A VK inline keyboard is limited to ten buttons and an album of several images takes no more than ten attachments. Native video sending needs a personal token with the "Video" right. After installation restart the gateway with `hermes gateway restart` in a separate terminal.
How to disable. Run `hermes plugins disable vk-platform`, delete the `~/.hermes/plugins/platforms/vk` directory and remove `VK_TOKEN` from `~/.hermes/.env`.
FAQ
How do I install hermes-vk?
Run `git clone https://github.com/TemArt90/hermes-vk ~/.hermes/plugins/platforms/vk` and `hermes plugins enable vk-platform`, then restart the gateway in a separate terminal.
Is a webhook or domain needed?
No. Long Poll works as an outbound long connection, so the channel lives even where inbound connections are unavailable.
Why is a personal token needed?
Only for native video sending: the `video.save` method is user level and a community key gets error 5 from VK.
How do I limit the user circle?
Set `VK_ALLOWED_USERS` to a list of VK ids or leave it empty and approve new users with a pairing code.
How does the bot behave in group chats?
By default it answers everything, and `VK_REQUIRE_MENTION=true` makes it answer only when mentioned. Individual chats have `VK_REQUIRE_MENTION_BY_PEER`.
Discussion
No questions or reviews yet.
Related
All VK toolsA VKontakte plugin for Hermes Agent: a community bot receives direct and group messages over Long Poll API and the agent replies as the community
Hermes VK Adapter
hermes-vk-adapter
A plugin that connects VK community private messages to Hermes Agent through Bots Long Poll with no public address or webhook
Claude Code channel plugin: chat with an agent session through a VK community from mobile or web
VK MCP Server (ORAMAN)
VK-MCP-Server
Local MCP server for the VK API: search for people and cities, profiles, photos and video with an HTML gallery, a token pool and a SQLite cache
vk-mcp (alexfisenkov)
vk-mcp
Remote MCP server for VK communities: 50 tools, posts, comments, dialogs, photos, video and products, with writing off by default
VK to Telegram bridge MCP
vk-tg-bridge
A 4-tool MCP server that pulls VK wall posts, filters them by rules and publishes them to Telegram via the Bot API
README in short
The README describes in detail the feature table, installation, community setup, the variable table, getting a personal token with a script, measured VK limits and development, with a short English summary at the start.