Install
$
openclaw plugins install clawhub:openclaw-vkbots-pluginOpenClaw VK bots plugin
Community VK Bots channel plugin for OpenClaw.
Install
From npm:
openclaw plugins install openclaw-vkbots-plugin
From a local checkout:
openclaw plugins install /path/to/openclaw-vkbots-plugin
Configure
After installing the plugin:
openclaw channels add vk
The setup flow supports a VK group token from:
- an environment variable such as
VK_GROUP_TOKEN - direct config input
- a token file reference
What it supports
- VK direct messages through the VK Long Poll API
- direct-message allowlists and pairing
- outbound text replies
Current scope boundary:
- direct messages only
- no VK group-chat inbound handling
Local development
pnpm install
pnpm test
pnpm check
To test against a local OpenClaw checkout:
openclaw plugins install /path/to/openclaw-vkbots-plugin
openclaw channels add vk
openclaw gateway run --force
Publish
This package is intended to be published to npm so it can be installed with:
openclaw plugins install openclaw-vkbots-plugin
Versioning
This plugin uses calendar-style versions:
- stable:
YYYY.M.K - beta:
YYYY.M.K-beta.N
Examples:
2026.3.12026.3.2-beta.1
Release tags should use:
vYYYY.M.KvYYYY.M.K-beta.N
Changelog and Releases
This repo uses Changesets for changelog entries and release notes.
For user-visible changes:
pnpm changeset
When preparing a release locally:
pnpm version-packages
That updates package versions and CHANGELOG.md.
Publishing is handled by the GitHub release workflow after merge to main.
After publish, submit it for listing on the OpenClaw community plugins page: