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 применяет строгие ограничения размера тела и тайм-аут до аутентификации перед проверкой.
• 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
• channels.line.allowFrom: разрешенные ID пользователей LINE для личных сообщений; dmPolicy: "open" требует ["*"]
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: разрешенные ID пользователей 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 cards.
• Потоковые ответы буферизуются; LINE получает полные фрагменты с анимацией загрузки, пока агент работает.
• Скачивание медиа ограничено channels.line.mediaMaxMb (по умолчанию 10).
• Входящие медиа сохраняются в ~/.openclaw/media/inbound/ перед передачей агенту, что соответствует общему хранилищу медиа, используемому другими встроенными Plugin каналов.

​

Данные канала (расширенные сообщения)

{
  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 console.
• Нет входящих событий: подтвердите, что путь webhook совпадает с channels.line.webhookPath и что gateway доступен из LINE.
• Ошибки скачивания медиа: увеличьте channels.line.mediaMaxMb, если медиа превышает лимит по умолчанию.

​

См. также

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