Add single-folder vk-gateway skill with configurable group/token

skills/vk-gateway/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: vk-gateway
+description: "Локальный 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`.