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

Правила общения в 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.