> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Synology Chat Synology Chat подключается к OpenClaw через пару вебхуков: исходящий вебхук Synology Chat отправляет входящие личные сообщения в Gateway, а ответы возвращаются через входящий вебхук Synology Chat. Статус: официальный плагин, устанавливаемый отдельно. Поддерживаются только личные сообщения; поддерживается отправка текста и файлов по URL. ## Установка ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins install @openclaw/synology-chat ``` Локальная рабочая копия (при запуске из git-репозитория): ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins install ./path/to/local/synology-chat-plugin ``` Подробнее: [Плагины](https://docs2.openclaw.ai/ru/tools/plugin.md) ## Быстрая настройка 1. Установите плагин (см. выше). 2. В интеграциях Synology Chat: * Создайте входящий вебхук и скопируйте его URL. * Создайте исходящий вебхук с вашим секретным токеном. 3. Укажите для исходящего вебхука URL вашего Gateway OpenClaw: * `https://gateway-host/webhook/synology` по умолчанию. * Либо ваш собственный `channels.synology-chat.webhookPath`. 4. Завершите настройку в OpenClaw. Synology Chat отображается в одном и том же списке настройки каналов в обоих сценариях: * Пошаговый: `openclaw onboard` или `openclaw channels add` * Прямой: `openclaw channels add --channel synology-chat --token --url ` 5. Перезапустите Gateway и отправьте личное сообщение боту Synology Chat. Сведения об аутентификации вебхука: * OpenClaw принимает токен исходящего вебхука сначала из `body.token`, затем из `?token=...`, а затем из заголовков. * Допустимые варианты заголовков: * `x-synology-token` * `x-webhook-token` * `x-openclaw-token` * `Authorization: Bearer ` * При пустом или отсутствующем токене запрос отклоняется. * Полезная нагрузка может иметь формат `application/x-www-form-urlencoded` или `application/json`; обязательны `token`, `user_id` и `text`. Минимальная конфигурация: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { "synology-chat": { enabled: true, token: "synology-outgoing-token", incomingUrl: "https://nas.example.com/webapi/entry.cgi?api=SYNO.Chat.External&method=incoming&version=2&token=...", webhookPath: "/webhook/synology", dmPolicy: "allowlist", allowedUserIds: ["123456"], rateLimitPerMinute: 30, allowInsecureSsl: false, }, }, } ``` ## Переменные среды Для учётной записи по умолчанию можно использовать переменные среды: * `SYNOLOGY_CHAT_TOKEN` * `SYNOLOGY_CHAT_INCOMING_URL` * `SYNOLOGY_NAS_HOST` * `SYNOLOGY_ALLOWED_USER_IDS` (через запятую) * `SYNOLOGY_RATE_LIMIT` * `OPENCLAW_BOT_NAME` Значения конфигурации переопределяют переменные среды. `SYNOLOGY_CHAT_INCOMING_URL` и `SYNOLOGY_NAS_HOST` нельзя задать из файла `.env` рабочей области; см. [Файлы `.env` рабочей области](https://docs2.openclaw.ai/ru/gateway/security#workspace-env-files). ## Политика личных сообщений и управление доступом * Поддерживаемые значения `dmPolicy`: `allowlist` (по умолчанию), `open` и `disabled`. В Synology Chat нет процедуры сопряжения; разрешите отправителей, добавив их числовые идентификаторы пользователей Synology в `allowedUserIds`. * `allowedUserIds` принимает список (или строку со значениями через запятую) идентификаторов пользователей Synology. * В режиме `allowlist` пустой список `allowedUserIds` считается ошибкой конфигурации, и маршрут вебхука не запускается. * `dmPolicy: "open"` разрешает общедоступные личные сообщения, только если `allowedUserIds` содержит `"*"`; при наличии ограничивающих записей общаться могут только соответствующие им пользователи. При `open` с пустым списком `allowedUserIds` маршрут также не запускается. * `dmPolicy: "disabled"` блокирует личные сообщения. * По умолчанию получатель ответа привязывается к стабильному числовому `user_id`. `channels.synology-chat.dangerouslyAllowNameMatching: true` — аварийный режим совместимости, который повторно включает поиск по изменяемому имени пользователя или псевдониму для доставки ответов. ## Исходящая доставка Используйте в качестве адресатов числовые идентификаторы пользователей Synology Chat. Поддерживаются префиксы `synology-chat:`, `synology_chat:` и `synology:`. Примеры: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw message send --channel synology-chat --target 123456 --message "Hello from OpenClaw" openclaw message send --channel synology-chat --target synology-chat:123456 --message "Hello again" openclaw message send --channel synology-chat --target synology:123456 --message "Short prefix" ``` Исходящий текст разбивается на фрагменты по 2000 символов. Отправка медиафайлов поддерживается посредством доставки файлов по URL: NAS загружает и прикрепляет файл (не более 32 МБ). URL исходящих файлов должны использовать `http` или `https`, а частные или иным образом заблокированные сетевые адресаты отклоняются до того, как OpenClaw передаст URL вебхуку NAS. ## Несколько учётных записей В `channels.synology-chat.accounts` поддерживается несколько учётных записей Synology Chat. Каждая учётная запись может переопределять токен, URL входящего вебхука, путь вебхука, политику личных сообщений и ограничения. Сеансы личных сообщений изолированы по учётным записям и пользователям, поэтому один и тот же числовой `user_id` в двух разных учётных записях Synology не использует общее состояние истории сообщений. Назначьте каждой включённой учётной записи уникальный `webhookPath`. OpenClaw отклоняет полностью совпадающие пути и не запускает именованные учётные записи, которые в конфигурациях с несколькими учётными записями лишь наследуют общий путь вебхука. Если для именованной учётной записи намеренно требуется устаревшее наследование, задайте `dangerouslyAllowInheritedWebhookPath: true` в этой учётной записи или в `channels.synology-chat`, однако полностью совпадающие пути по-прежнему отклоняются. Предпочтительно явно задавать отдельные пути для каждой учётной записи. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { "synology-chat": { enabled: true, accounts: { default: { token: "token-a", incomingUrl: "https://nas-a.example.com/...token=...", }, alerts: { token: "token-b", incomingUrl: "https://nas-b.example.com/...token=...", webhookPath: "/webhook/synology-alerts", dmPolicy: "allowlist", allowedUserIds: ["987654"], }, }, }, }, } ``` ## Примечания по безопасности * Храните `token` в секрете и смените его в случае утечки. * Не изменяйте `allowInsecureSsl: false`, если только вы явно не доверяете самоподписанному сертификату локального NAS. * Запросы входящего вебхука проверяются по токену, а их частота ограничивается отдельно для каждого отправителя (`rateLimitPerMinute`, по умолчанию 30). * Проверки недействительных токенов используют сравнение секретов за постоянное время и отклоняют запросы; повторные попытки с недействительным токеном временно блокируют исходный IP-адрес. * Текст входящих сообщений очищается от известных шаблонов инъекций в промпты и обрезается до 4000 символов. * Для рабочей среды предпочтительно использовать `dmPolicy: "allowlist"`. * Не включайте `dangerouslyAllowNameMatching`, если вам явно не требуется устаревшая доставка ответов по имени пользователя. * Не включайте `dangerouslyAllowInheritedWebhookPath`, если вы явно не принимаете риск маршрутизации по общему пути в конфигурации с несколькими учётными записями. ## Устранение неполадок * `Missing required fields (token, user_id, text)`: * в полезной нагрузке исходящего вебхука отсутствует одно из обязательных полей * если Synology отправляет токен в заголовках, убедитесь, что Gateway или прокси сохраняет эти заголовки * `Invalid token`: * секрет исходящего вебхука не соответствует `channels.synology-chat.token` * запрос поступает на неверный путь учётной записи или вебхука * обратный прокси удалил заголовок токена до того, как запрос достиг OpenClaw * `Rate limit exceeded`: * слишком много попыток с недействительным токеном из одного источника могут временно заблокировать этот источник * для аутентифицированных отправителей также действует отдельное ограничение частоты сообщений для каждого пользователя * `Allowlist is empty. Configure allowedUserIds or use dmPolicy=open with allowedUserIds=["*"].`: * `dmPolicy="allowlist"` включён, но пользователи не настроены * `User not authorized`: * числовой `user_id` отправителя отсутствует в `allowedUserIds` ## Связанные материалы * [Обзор каналов](https://docs2.openclaw.ai/ru/channels.md) — все поддерживаемые каналы * [Группы](https://docs2.openclaw.ai/ru/channels/groups.md) — поведение групповых чатов и фильтрация по упоминаниям * [Маршрутизация каналов](https://docs2.openclaw.ai/ru/channels/channel-routing.md) — маршрутизация сеансов для сообщений * [Безопасность](https://docs2.openclaw.ai/ru/gateway/security.md) — модель доступа и усиление защиты