From 703638b05db9302e6dbeeb06816965e0412d27f6 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Wed, 22 Apr 2026 00:50:50 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/channels/line.md | 107 ++++++++++++++++++++++----------------- 1 file changed, 61 insertions(+), 46 deletions(-) diff --git a/docs/uk/channels/line.md b/docs/uk/channels/line.md index 70fac8512..53f4f3d5f 100644 --- a/docs/uk/channels/line.md +++ b/docs/uk/channels/line.md @@ -1,30 +1,36 @@ --- read_when: - Ви хочете підключити OpenClaw до LINE - - Вам потрібно налаштувати вебхук і облікові дані LINE - - Вам потрібні специфічні для LINE параметри повідомлень -summary: Налаштування, конфігурація та використання плагіна LINE Messaging API + - Вам потрібно налаштувати Webhook LINE і облікові дані + - Вам потрібні параметри повідомлень, специфічні для LINE +summary: Налаштування, конфігурація та використання Plugin LINE Messaging API title: LINE x-i18n: - generated_at: "2026-04-05T17:58:10Z" + generated_at: "2026-04-22T00:50:27Z" model: gpt-5.4 provider: openai - source_hash: b4782b2aa3e8654505d7f1fd6fc112adf125b5010fc84d655d033688ded37414 + source_hash: c6a64c18e47d22d0629ec4956f88746620923e72faae6c01f7ab353eede7345d source_path: channels/line.md workflow: 15 --- # LINE -LINE підключається до OpenClaw через LINE Messaging API. Плагін працює як приймач вебхуків на gateway і використовує ваш channel access token та channel secret для автентифікації. +LINE підключається до OpenClaw через LINE Messaging API. Plugin працює як отримувач webhook +на Gateway і використовує ваш токен доступу каналу та секрет каналу для +автентифікації. -Статус: вбудований плагін. Підтримуються прямі повідомлення, групові чати, медіа, локації, Flex messages, template messages і quick replies. Реакції та ланцюжки не підтримуються. +Статус: вбудований plugin. Підтримуються особисті повідомлення, групові чати, медіа, локації, Flex +повідомлення, шаблонні повідомлення та швидкі відповіді. Реакції та треди +не підтримуються. -## Вбудований плагін +## Вбудований plugin -LINE постачається як вбудований плагін у поточних випусках OpenClaw, тому звичайним пакетним збіркам не потрібне окреме встановлення. +LINE постачається як вбудований plugin у поточних релізах OpenClaw, тому звичайні +пакетовані збірки не потребують окремого встановлення. -Якщо ви використовуєте старішу збірку або власне встановлення без LINE, установіть його вручну: +Якщо ви використовуєте старішу збірку або спеціальне встановлення, яке не включає LINE, встановіть його +вручну: ```bash openclaw plugins install @openclaw/line @@ -43,20 +49,20 @@ openclaw plugins install ./path/to/local/line-plugin 2. Створіть (або виберіть) Provider і додайте канал **Messaging API**. 3. Скопіюйте **Channel access token** і **Channel secret** з налаштувань каналу. 4. Увімкніть **Use webhook** у налаштуваннях Messaging API. -5. Установіть URL вебхука на кінцеву точку вашого gateway (потрібен HTTPS): +5. Встановіть URL webhook на endpoint вашого Gateway (потрібен HTTPS): ``` https://gateway-host/line/webhook ``` -Gateway відповідає на перевірку вебхука LINE (GET) і вхідні події (POST). +Gateway відповідає на перевірку webhook LINE (GET) і вхідні події (POST). Якщо вам потрібен власний шлях, установіть `channels.line.webhookPath` або `channels.line.accounts..webhookPath` і відповідно оновіть URL. Примітка щодо безпеки: -- Перевірка підпису LINE залежить від тіла запиту (HMAC від сирого тіла), тому OpenClaw застосовує суворі ліміти тіла до автентифікації та тайм-аут перед перевіркою. -- OpenClaw обробляє події вебхука з перевірених сирих байтів запиту. Значення `req.body`, змінені проміжним middleware, ігноруються задля безпеки цілісності підпису. +- Перевірка підпису LINE залежить від тіла запиту (HMAC для сирого тіла), тому OpenClaw застосовує суворі обмеження розміру тіла до автентифікації та тайм-аут перед перевіркою. +- OpenClaw обробляє події webhook із перевірених сирих байтів запиту. Значення `req.body`, змінені upstream middleware, ігноруються задля безпеки цілісності підпису. ## Конфігурація @@ -75,12 +81,12 @@ Gateway відповідає на перевірку вебхука LINE (GET) } ``` -Змінні середовища (лише для типового облікового запису): +Змінні середовища (лише обліковий запис за замовчуванням): - `LINE_CHANNEL_ACCESS_TOKEN` - `LINE_CHANNEL_SECRET` -Файли token/secret: +Файли токена/секрету: ```json5 { @@ -93,7 +99,7 @@ Gateway відповідає на перевірку вебхука LINE (GET) } ``` -`tokenFile` і `secretFile` мають указувати на звичайні файли. Символічні посилання відхиляються. +`tokenFile` і `secretFile` мають вказувати на звичайні файли. Символічні посилання не допускаються. Кілька облікових записів: @@ -115,38 +121,42 @@ Gateway відповідає на перевірку вебхука LINE (GET) ## Керування доступом -Для прямих повідомлень типовим є парування. Невідомі відправники отримують код парування, а їхні повідомлення ігноруються до схвалення. +Для особистих повідомлень за замовчуванням використовується pairing. Невідомі відправники отримують код pairing, а їхні +повідомлення ігноруються, доки їх не буде схвалено. ```bash openclaw pairing list line openclaw pairing approve line ``` -Списки дозволених і політики: +Списки дозволу та політики: - `channels.line.dmPolicy`: `pairing | allowlist | open | disabled` -- `channels.line.allowFrom`: дозволені LINE user ID для DM +- `channels.line.allowFrom`: LINE user ID у списку дозволених для особистих повідомлень - `channels.line.groupPolicy`: `allowlist | open | disabled` -- `channels.line.groupAllowFrom`: дозволені LINE user ID для груп +- `channels.line.groupAllowFrom`: LINE user ID у списку дозволених для груп - Перевизначення для окремих груп: `channels.line.groups..allowFrom` -- Примітка щодо runtime: якщо `channels.line` повністю відсутній, runtime для перевірок груп повертається до `groupPolicy="allowlist"` (навіть якщо задано `channels.defaults.groupPolicy`). +- Примітка щодо runtime: якщо `channels.line` повністю відсутній, runtime використовує `groupPolicy="allowlist"` для перевірок груп (навіть якщо встановлено `channels.defaults.groupPolicy`). -ID LINE чутливі до регістру. Приклади коректних ID: +LINE ID чутливі до регістру. Коректні ID мають такий вигляд: -- Користувач: `U` + 32 hex chars -- Група: `C` + 32 hex chars -- Room: `R` + 32 hex chars +- Користувач: `U` + 32 hex-символи +- Група: `C` + 32 hex-символи +- Кімната: `R` + 32 hex-символи ## Поведінка повідомлень - Текст розбивається на частини по 5000 символів. -- Форматування Markdown видаляється; блоки коду й таблиці за можливості перетворюються на Flex cards. -- Потокові відповіді буферизуються; LINE отримує повні частини з анімацією завантаження, поки агент працює. -- Завантаження медіа обмежуються `channels.line.mediaMaxMb` (типово 10). +- Форматування Markdown прибирається; блоки коду та таблиці за можливості перетворюються на Flex + картки. +- Потокові відповіді буферизуються; LINE отримує повні фрагменти з анімацією + завантаження, поки агент працює. +- Завантаження медіа обмежуються параметром `channels.line.mediaMaxMb` (типове значення — 10). -## Дані каналу (розширені повідомлення) +## Дані каналу (насичені повідомлення) -Використовуйте `channelData.line`, щоб надсилати quick replies, локації, Flex cards або template messages. +Використовуйте `channelData.line`, щоб надсилати швидкі відповіді, локації, Flex-картки або шаблонні +повідомлення. ```json5 { @@ -179,7 +189,7 @@ ID LINE чутливі до регістру. Приклади коректни } ``` -Плагін LINE також постачається з командою `/card` для попередньо налаштованих Flex messages: +Plugin LINE також постачається з командою `/card` для preset-ів Flex повідомлень: ``` /card info "Welcome" "Thanks for joining!" @@ -189,31 +199,36 @@ ID LINE чутливі до регістру. Приклади коректни LINE підтримує прив’язки розмов ACP (Agent Communication Protocol): -- `/acp spawn --bind here` прив’язує поточний чат LINE до сесії ACP без створення дочірнього ланцюжка. +- `/acp spawn --bind here` прив’язує поточний чат LINE до сесії ACP без створення дочірнього треду. - Налаштовані прив’язки ACP і активні ACP-сесії, прив’язані до розмов, працюють у LINE так само, як і в інших каналах розмов. -Докладніше див. у [ACP agents](/tools/acp-agents). +Докладніше див. у [ACP agents](/uk/tools/acp-agents). ## Вихідні медіа -Плагін LINE підтримує надсилання зображень, відео та аудіофайлів через інструмент повідомлень агента. Медіа надсилаються через специфічний для LINE шлях доставки з належною обробкою попереднього перегляду та відстеження: +Plugin LINE підтримує надсилання зображень, відео та аудіофайлів через інструмент повідомлень агента. Медіа надсилаються через специфічний для LINE шлях доставки з належною обробкою preview і відстеження: -- **Зображення**: надсилаються як повідомлення-зображення LINE з автоматичним створенням попереднього перегляду. -- **Відео**: надсилаються з явною обробкою попереднього перегляду й content-type. +- **Зображення**: надсилаються як повідомлення-зображення LINE з автоматичним створенням preview. +- **Відео**: надсилаються з явною обробкою preview і content-type. - **Аудіо**: надсилаються як аудіоповідомлення LINE. -Загальні надсилання медіа повертаються до наявного маршруту лише для зображень, якщо специфічний для LINE шлях недоступний. +URL вихідних медіа мають бути публічними HTTPS URL. OpenClaw перевіряє цільове ім’я хоста перед передачею URL до LINE і відхиляє цілі local loopback, link-local та приватної мережі. + +Загальне надсилання медіа повертається до наявного маршруту лише для зображень, якщо специфічний для LINE шлях недоступний. ## Усунення проблем -- **Перевірка вебхука не проходить:** переконайтеся, що URL вебхука використовує HTTPS і що `channelSecret` збігається з налаштуваннями в консолі LINE. -- **Немає вхідних подій:** переконайтеся, що шлях вебхука збігається з `channels.line.webhookPath` і що gateway доступний для LINE. -- **Помилки завантаження медіа:** збільште `channels.line.mediaMaxMb`, якщо медіа перевищує типове обмеження. +- **Не вдається пройти перевірку webhook:** переконайтеся, що URL webhook використовує HTTPS і + `channelSecret` збігається з налаштуванням у LINE console. +- **Немає вхідних подій:** переконайтеся, що шлях webhook збігається з `channels.line.webhookPath` + і що Gateway доступний з LINE. +- **Помилки завантаження медіа:** збільште `channels.line.mediaMaxMb`, якщо медіа перевищує + типове обмеження. ## Пов’язане -- [Огляд каналів](/channels) — усі підтримувані канали -- [Парування](/channels/pairing) — автентифікація DM і потік парування -- [Групи](/channels/groups) — поведінка групового чату й перевірка згадки -- [Маршрутизація каналів](/channels/channel-routing) — маршрутизація сесій для повідомлень -- [Безпека](/gateway/security) — модель доступу та зміцнення безпеки +- [Огляд каналів](/uk/channels) — усі підтримувані канали +- [Pairing](/uk/channels/pairing) — автентифікація особистих повідомлень і процес pairing +- [Групи](/uk/channels/groups) — поведінка групових чатів і обмеження згадок +- [Маршрутизація каналів](/uk/channels/channel-routing) — маршрутизація сесій для повідомлень +- [Безпека](/uk/gateway/security) — модель доступу та посилення захисту