58 lines
3.3 KiB
Markdown
58 lines
3.3 KiB
Markdown
|
---
|
|||
|
|
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`.
|