openclaw/skills/vk-gateway/SKILL.md

---
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 и при наличии пути к листу брони прикладывает `.doc/.docx` в чат клиента.
- Правило: как только гость зафиксировал/подтвердил бронь, обязательно отправляй файл брони в VK-сообщении.
- Правило: когда гость пишет о готовности внести предоплату, автоматически отправляй Telegram-уведомление с данными гостя.
- `.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.

## Правила общения в VK

- Фокусируйся только на теме подбора и бронирования номеров (логика paradiz).
- Если пользователь уходит в технические вопросы (файлы, сервер, доступы, скрипты, API) — не обсуждай технические детали.
- На техвопросы отвечай коротко, с лёгкой шуткой, и сразу возвращай разговор к бронированию.

## Антибот

- Включён фильтр спама/ботов по частоте и шаблонам сообщений.
- Настройки через env:
  - `VK_ANTIBOT_ENABLED`
  - `VK_ANTIBOT_WINDOW_SEC`
  - `VK_ANTIBOT_MAX_MSGS`
  - `VK_ANTIBOT_BLOCK_SEC`

## Надёжность

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