openclaw/public-release/vk-gateway/SKILL.md

name, description

name	description
vk-gateway	Локальный VK gateway в одной папке: приём сообщений из VK через Bots Long Poll API, проксирование в OpenClaw /v1/responses и отправка ответов обратно в VK. Использовать, когда нужно быстро поднять рабочий VK-канал с настройкой group id и токена сообщества.

VK Gateway (single-folder)

Используй содержимое только этой папки skills/vk-gateway.

Состав

• vk-endpoint.mjs — локальный HTTP endpoint /vk/inbound, вызывает OpenClaw /v1/responses.
• vk-longpoll.mjs — Long Poll worker, получает message_new и отправляет ответы в VK.
• .env.example — все настройки (включая VK_GROUP_ID и VK_TOKEN) в одном месте.

Быстрый старт

1. Скопируй конфиг рядом с файлами:
   • cp skills/vk-gateway/.env.example skills/vk-gateway/.env
2. Заполни минимум:
   • VK_GROUP_ID
   • VK_TOKEN
   • OPENCLAW_GATEWAY_TOKEN
3. Запусти endpoint:
   • node skills/vk-gateway/vk-endpoint.mjs --env skills/vk-gateway/.env
4. Запусти longpoll worker:
   • node skills/vk-gateway/vk-longpoll.mjs --env skills/vk-gateway/.env

Что настраивается

• VK_GROUP_ID — ID сообщества VK.
• VK_TOKEN — токен сообщества VK.
• OPENCLAW_RESPONSES_URL — URL OpenClaw endpoint /v1/responses.
• OPENCLAW_GATEWAY_TOKEN — токен gateway.

Надёжность

• failed=1 → обновляй ts.
• failed=2|3 → повторно запрашивай server/key/ts через groups.getLongPollServer.
• Обрабатывай только входящие сообщения и только события из VK_ALLOWED_EVENTS.