chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
6107e016e3
commit
703638b05d
@ -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.<id>.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 <CODE>
|
||||
```
|
||||
|
||||
Списки дозволених і політики:
|
||||
Списки дозволу та політики:
|
||||
|
||||
- `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.<groupId>.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 <agent> --bind here` прив’язує поточний чат LINE до сесії ACP без створення дочірнього ланцюжка.
|
||||
- `/acp spawn <agent> --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) — модель доступу та посилення захисту
|
||||
|
||||
Loading…
Reference in New Issue
Block a user