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 над raw body), тому OpenClaw застосовує суворі ліміти тіла до автентифікації та timeout перед перевіркою.
• OpenClaw обробляє події Webhook з перевірених raw bytes запиту. Значення req.body, перетворені upstream middleware, ігноруються для безпеки цілісності підпису.

​

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

{
  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
• channels.line.allowFrom: дозволені ідентифікатори користувачів LINE для приватних повідомлень; dmPolicy: "open" вимагає ["*"]
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: дозволені ідентифікатори користувачів LINE для груп
• Перевизначення для окремих груп: channels.line.groups.<groupId>.allowFrom
• Статичні групи доступу відправників можна посилатися з allowFrom, groupAllowFrom і групового allowFrom через accessGroup:<name>.
• Примітка щодо runtime: якщо channels.line повністю відсутній, runtime повертається до groupPolicy="allowlist" для перевірок груп (навіть якщо задано channels.defaults.groupPolicy).

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

​

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

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

​

Дані каналу (розширені повідомлення)

{
  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",
      },
    },
  },
}

/card info "Welcome" "Thanks for joining!"

​

Підтримка ACP

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

​

Вихідні медіа

• Зображення: надсилаються як повідомлення із зображеннями LINE з автоматичним створенням попереднього перегляду.
• Відео: надсилаються з явною обробкою попереднього перегляду й типу вмісту.
• Аудіо: надсилаються як аудіоповідомлення LINE.

​

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

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

​

Пов’язане

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