РЯДОК

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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

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 на endpoint вашого Gateway (потрібен HTTPS):

https://gateway-host/line/webhook

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

​

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

{
  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 user IDs для DM; dmPolicy: "open" потребує ["*"]
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: дозволені LINE user IDs для груп
• Перевизначення для окремих груп: 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 cards.
• Потокові відповіді буферизуються; LINE отримує повні частини з анімацією завантаження, доки агент працює.
• Завантаження медіа обмежені channels.line.mediaMaxMb (за замовчуванням 10).
• Вхідні медіа зберігаються в ~/.openclaw/media/inbound/ перед передаванням агенту, відповідно до спільного сховища медіа, яке використовують інші вбудовані channel 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 з автоматичною генерацією попереднього перегляду.
• Відео: надсилаються з явною обробкою попереднього перегляду та content-type.
• Аудіо: надсилаються як аудіоповідомлення LINE.

​

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

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

​

Пов’язане

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