--- read_when: - Ви хочете підключити OpenClaw до LINE - Потрібне налаштування LINE Webhook + облікових даних - Вам потрібні параметри повідомлень, специфічні для LINE summary: Налаштування, конфігурація та використання Plugin LINE Messaging API title: РЯДОК x-i18n: generated_at: "2026-05-10T19:22:07Z" model: gpt-5.5 provider: openai source_hash: 7a11edbadda1ec99452eadc19a4557bb594f8b69ebb92314e2c3a0be325ab89d source_path: channels/line.md workflow: 16 --- LINE підключається до OpenClaw через LINE Messaging API. Plugin працює як отримувач Webhook на Gateway і використовує ваш channel access token + channel secret для автентифікації. Статус: завантажуваний Plugin. Підтримуються особисті повідомлення, групові чати, медіа, локації, Flex messages, template messages і quick replies. Реакції та потоки не підтримуються. ## Установлення Установіть LINE перед налаштуванням каналу: ```bash openclaw plugins install @openclaw/line ``` Локальна копія (під час запуску з git-репозиторію): ```bash openclaw plugins install ./path/to/local/line-plugin ``` ## Налаштування 1. Створіть обліковий запис LINE Developers і відкрийте Console: [https://developers.line.biz/console/](https://developers.line.biz/console/) 2. Створіть (або виберіть) Provider і додайте канал **Messaging API**. 3. Скопіюйте **Channel access token** і **Channel secret** з налаштувань каналу. 4. Увімкніть **Use webhook** у налаштуваннях Messaging API. 5. Установіть URL Webhook на endpoint вашого Gateway (потрібен HTTPS): ``` https://gateway-host/line/webhook ``` Gateway відповідає на перевірку Webhook від LINE (GET) і вхідні події (POST). Якщо вам потрібен власний шлях, установіть `channels.line.webhookPath` або `channels.line.accounts..webhookPath` і відповідно оновіть URL. Примітка щодо безпеки: - Перевірка підпису LINE залежить від тіла (HMAC над сирим тілом), тому OpenClaw застосовує строгі ліміти тіла до автентифікації та тайм-аут перед перевіркою. - OpenClaw обробляє події Webhook з перевірених сирих байтів запиту. Значення `req.body`, перетворені проміжним ПЗ upstream, ігноруються для безпеки цілісності підпису. ## Конфігурація Мінімальна конфігурація: ```json5 { channels: { line: { enabled: true, channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN", channelSecret: "LINE_CHANNEL_SECRET", dmPolicy: "pairing", }, }, } ``` Публічна конфігурація DM: ```json5 { channels: { line: { enabled: true, channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN", channelSecret: "LINE_CHANNEL_SECRET", dmPolicy: "open", allowFrom: ["*"], }, }, } ``` Змінні середовища (лише стандартний обліковий запис): - `LINE_CHANNEL_ACCESS_TOKEN` - `LINE_CHANNEL_SECRET` Файли токена/секрету: ```json5 { channels: { line: { tokenFile: "/path/to/line-token.txt", secretFile: "/path/to/line-secret.txt", }, }, } ``` `tokenFile` і `secretFile` мають указувати на звичайні файли. Символічні посилання відхиляються. Кілька облікових записів: ```json5 { channels: { line: { accounts: { marketing: { channelAccessToken: "...", channelSecret: "...", webhookPath: "/line/marketing", }, }, }, }, } ``` ## Керування доступом Для особистих повідомлень за замовчуванням використовується спарювання. Невідомі відправники отримують код спарювання, а їхні повідомлення ігноруються, доки їх не буде схвалено. ```bash openclaw pairing list line openclaw pairing approve line ``` Списки дозволених і політики: - `channels.line.dmPolicy`: `pairing | allowlist | open | disabled` - `channels.line.allowFrom`: дозволені LINE user IDs для DM; `dmPolicy: "open"` потребує `["*"]` - `channels.line.groupPolicy`: `allowlist | open | disabled` - `channels.line.groupAllowFrom`: дозволені LINE user IDs для груп - Перевизначення для окремих груп: `channels.line.groups..allowFrom` - Статичні групи доступу відправників можна посилатися з `allowFrom`, `groupAllowFrom` і групового `allowFrom` за допомогою `accessGroup:`. - Примітка щодо runtime: якщо `channels.line` повністю відсутній, runtime повертається до `groupPolicy="allowlist"` для перевірок груп (навіть якщо встановлено `channels.defaults.groupPolicy`). LINE IDs чутливі до регістру. Дійсні IDs мають такий вигляд: - Користувач: `U` + 32 шістнадцяткові символи - Група: `C` + 32 шістнадцяткові символи - Кімната: `R` + 32 шістнадцяткові символи ## Поведінка повідомлень - Текст розбивається на частини по 5000 символів. - Форматування Markdown вилучається; блоки коду й таблиці за можливості перетворюються на Flex cards. - Потокові відповіді буферизуються; LINE отримує повні частини з анімацією завантаження, доки агент працює. - Завантаження медіа обмежені `channels.line.mediaMaxMb` (за замовчуванням 10). - Вхідні медіа зберігаються в `~/.openclaw/media/inbound/` перед передаванням агенту, відповідно до спільного сховища медіа, яке використовують інші вбудовані channel plugins. ## Дані каналу (насичені повідомлення) Використовуйте `channelData.line`, щоб надсилати quick replies, локації, Flex cards або template messages. ```json5 { text: "Here you go", channelData: { line: { quickReplies: ["Status", "Help"], location: { title: "Office", address: "123 Main St", latitude: 35.681236, longitude: 139.767125, }, flexMessage: { altText: "Status card", contents: { /* Flex payload */ }, }, templateMessage: { type: "confirm", text: "Proceed?", confirmLabel: "Yes", confirmData: "yes", cancelLabel: "No", cancelData: "no", }, }, }, } ``` LINE Plugin також постачається з командою `/card` для шаблонів Flex message: ``` /card info "Welcome" "Thanks for joining!" ``` ## Підтримка ACP LINE підтримує прив’язки розмов ACP (Agent Communication Protocol): - `/acp spawn --bind here` прив’язує поточний чат LINE до сесії ACP без створення дочірнього потоку. - Налаштовані прив’язки ACP і активні сесії ACP, прив’язані до розмови, працюють у LINE так само, як в інших каналах розмов. Докладніше див. [Агенти ACP](/uk/tools/acp-agents). ## Вихідні медіа LINE Plugin підтримує надсилання зображень, відео й аудіофайлів через інструмент повідомлень агента. Медіа надсилаються через специфічний для LINE шлях доставки з належною обробкою попереднього перегляду та відстеження: - **Зображення**: надсилаються як повідомлення із зображеннями LINE з автоматичною генерацією попереднього перегляду. - **Відео**: надсилаються з явною обробкою попереднього перегляду та content-type. - **Аудіо**: надсилаються як аудіоповідомлення LINE. URL-адреси вихідних медіа мають бути публічними HTTPS URL. OpenClaw перевіряє цільове ім’я хоста перед передаванням URL до LINE і відхиляє цілі loopback, link-local і приватної мережі. Загальні надсилання медіа повертаються до наявного маршруту лише для зображень, коли специфічний для LINE шлях недоступний. ## Усунення несправностей - **Помилка перевірки Webhook:** переконайтеся, що URL Webhook використовує HTTPS, а `channelSecret` відповідає консолі LINE. - **Немає вхідних подій:** підтвердьте, що шлях Webhook відповідає `channels.line.webhookPath` і що Gateway доступний з LINE. - **Помилки завантаження медіа:** збільште `channels.line.mediaMaxMb`, якщо медіа перевищує стандартний ліміт. ## Пов’язане - [Огляд каналів](/uk/channels) — усі підтримувані канали - [Спарювання](/uk/channels/pairing) — автентифікація DM і процес спарювання - [Групи](/uk/channels/groups) — поведінка групового чату та обмеження згадками - [Маршрутизація каналів](/uk/channels/channel-routing) — маршрутизація сесій для повідомлень - [Безпека](/uk/gateway/security) — модель доступу та посилення захисту