LINE

​

Встановлення

openclaw plugins install @openclaw/line

openclaw plugins install ./path/to/local/line-plugin

​

Налаштування

1. Створіть обліковий запис LINE Developers і відкрийте Console: https://developers.line.biz/console/
2. Створіть (або виберіть) Provider і додайте канал Messaging API.
3. Скопіюйте Channel access token і Channel secret з налаштувань каналу.
4. Увімкніть Use webhook у налаштуваннях Messaging API.
5. Укажіть як URL-адресу Webhook кінцеву точку вашого Gateway (потрібен HTTPS):

https://gateway-host/line/webhook

• Перевірка підпису LINE залежить від тіла запиту (HMAC над необробленим тілом), тому OpenClaw застосовує суворе обмеження розміру тіла до автентифікації (64 КБ) і тайм-аут читання перед перевіркою.
• OpenClaw обробляє події Webhook із перевірених необроблених байтів запиту. Значення req.body, перетворені проміжним ПЗ вище за потоком, ігноруються задля збереження цілісності підпису.

​

Конфігурація

{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",
      channelSecret: "LINE_CHANNEL_SECRET",
      dmPolicy: "pairing",
    },
  },
}

{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",
      channelSecret: "LINE_CHANNEL_SECRET",
      dmPolicy: "open",
      allowFrom: ["*"],
    },
  },
}

• LINE_CHANNEL_ACCESS_TOKEN
• LINE_CHANNEL_SECRET

{
  channels: {
    line: {
      tokenFile: "/path/to/line-token.txt",
      secretFile: "/path/to/line-secret.txt",
    },
  },
}

{
  channels: {
    line: {
      accounts: {
        marketing: {
          channelAccessToken: "...",
          channelSecret: "...",
          webhookPath: "/line/marketing",
        },
      },
    },
  },
}

​

Керування доступом

openclaw pairing list line
openclaw pairing approve line <CODE>

• channels.line.dmPolicy: pairing | allowlist | open | disabled (типове значення — pairing)
• channels.line.allowFrom: дозволені ідентифікатори користувачів LINE для особистих повідомлень; dmPolicy: "open" потребує ["*"]
• channels.line.groupPolicy: allowlist | open | disabled (типове значення — allowlist)
• channels.line.groupAllowFrom: дозволені ідентифікатори користувачів LINE для груп; записи особистих повідомлень allowFrom не надають доступу відправникам у групах
• Перевизначення для окремих груп: channels.line.groups.<groupId>.allowFrom (а також enabled, requireMention, systemPrompt, skills). З groupPolicy: "allowlist" задайте groupAllowFrom або груповий параметр allowFrom; порожній список дозволених для групи блокує групові повідомлення, навіть якщо особисті повідомлення відкриті.
• На статичні групи доступу відправників можна посилатися з allowFrom, groupAllowFrom і групового параметра allowFrom за допомогою accessGroup:<name>; див. Групи доступу.
• Примітка щодо середовища виконання: якщо channels.line повністю відсутній, середовище виконання використовує groupPolicy="allowlist" як резервний варіант для перевірок груп (навіть якщо задано channels.defaults.groupPolicy).

• Користувач: U + 32 шістнадцяткові символи
• Група: C + 32 шістнадцяткові символи
• Кімната: R + 32 шістнадцяткові символи

​

Поведінка повідомлень

• Текст розбивається на частини по 5000 символів.
• Форматування Markdown вилучається; блоки коду й таблиці за можливості перетворюються на картки Flex.
• Потокові відповіді буферизуються; LINE отримує повні частини з анімацією завантаження, доки агент працює.
• Розмір завантажуваних медіафайлів обмежено параметром channels.line.mediaMaxMb (типове значення — 10).
• Вхідні медіафайли зберігаються в ~/.openclaw/media/inbound/, перш ніж передаватися агенту, відповідно до спільного сховища медіафайлів, яке використовують інші Plugin каналів.

​

Дані каналу (форматовані повідомлення)

{
  text: "Ось, будь ласка",
  channelData: {
    line: {
      quickReplies: ["Статус", "Довідка"],
      location: {
        title: "Офіс",
        address: "123 Main St",
        latitude: 35.681236,
        longitude: 139.767125,
      },
      flexMessage: {
        altText: "Картка статусу",
        contents: {/* Корисне навантаження Flex */},
      },
      templateMessage: {
        type: "confirm",
        text: "Продовжити?",
        confirmLabel: "Так",
        confirmData: "yes",
        cancelLabel: "Ні",
        cancelData: "no",
      },
    },
  },
}

/card info "Вітаємо" "Дякуємо, що приєдналися!"

​

Підтримка ACP

• /acp spawn <agent> --bind here прив’язує поточний чат LINE до сеансу ACP без створення дочірньої гілки.
• Налаштовані прив’язування ACP й активні сеанси ACP, прив’язані до розмови, працюють у LINE так само, як в інших каналах розмов.

​

Вихідні медіафайли

• Зображення: надсилаються як повідомлення із зображеннями LINE; типовим зображенням попереднього перегляду є URL-адреса медіафайлу.
• Відео: потребують зображення попереднього перегляду; задайте для channelData.line.previewImageUrl URL-адресу зображення.
• Аудіо: надсилається як аудіоповідомлення LINE; типова тривалість становить 60 секунд, якщо не задано channelData.line.durationMs.

​

Усунення несправностей

• Не вдається перевірити Webhook: переконайтеся, що URL-адреса Webhook використовує HTTPS, а channelSecret відповідає значенню в консолі LINE.
• Немає вхідних подій: переконайтеся, що шлях Webhook відповідає channels.line.webhookPath і що Gateway доступний із LINE.
• Помилки завантаження медіафайлів: збільште channels.line.mediaMaxMb, якщо розмір медіафайлів перевищує типове обмеження.

​

Пов’язані матеріали

• Огляд каналів — усі підтримувані канали
• Спарювання — автентифікація особистих повідомлень і процес спарювання
• Групи — поведінка групових чатів і обмеження за згадуваннями
• Маршрутизація каналів — маршрутизація сеансів для повідомлень
• Безпека — модель доступу й посилення захисту