--- read_when: - Вы хотите подключить OpenClaw к LINE - Вам нужно настроить Webhook LINE и учетные данные - Вам нужны параметры сообщений, специфичные для LINE summary: Настройка, конфигурация и использование Plugin LINE Messaging API title: LINE x-i18n: generated_at: "2026-06-28T18:21:12Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: c27572d1db71d1f46b4e6ee68aa03bdbec8f90ed7fb0884f0185ea4aa877468a 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 и быстрые ответы. Реакции и треды не поддерживаются. ## Установка Установите 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 для вашей конечной точки 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`, преобразованные промежуточным ПО выше по цепочке, игнорируются для сохранения целостности подписи. ## Конфигурация Минимальная конфигурация: ```json5 { channels: { line: { enabled: true, channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN", channelSecret: "LINE_CHANNEL_SECRET", dmPolicy: "pairing", }, }, } ``` Конфигурация открытых личных сообщений: ```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`: разрешенные ID пользователей LINE для личных сообщений; `dmPolicy: "open"` требует `["*"]` - `channels.line.groupPolicy`: `allowlist | open | disabled` - `channels.line.groupAllowFrom`: разрешенные ID пользователей LINE для групп - Переопределения для отдельных групп: `channels.line.groups..allowFrom` - Статические группы доступа отправителей можно ссылочно указывать из `allowFrom`, `groupAllowFrom` и группового `allowFrom` через `accessGroup:`. - Примечание о runtime: если `channels.line` полностью отсутствует, runtime возвращается к `groupPolicy="allowlist"` для проверок групп (даже если задано `channels.defaults.groupPolicy`). ID LINE чувствительны к регистру. Допустимые ID выглядят так: - Пользователь: `U` + 32 шестнадцатеричных символа - Группа: `C` + 32 шестнадцатеричных символа - Комната: `R` + 32 шестнадцатеричных символа ## Поведение сообщений - Текст разбивается на фрагменты по 5000 символов. - Форматирование Markdown удаляется; блоки кода и таблицы по возможности преобразуются в Flex cards. - Потоковые ответы буферизуются; LINE получает полные фрагменты с анимацией загрузки, пока агент работает. - Скачивание медиа ограничено `channels.line.mediaMaxMb` (по умолчанию 10). - Входящие медиа сохраняются в `~/.openclaw/media/inbound/` перед передачей агенту, что соответствует общему хранилищу медиа, используемому другими встроенными Plugin каналов. ## Данные канала (расширенные сообщения) Используйте `channelData.line` для отправки быстрых ответов, местоположений, 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", }, }, }, } ``` Plugin LINE также поставляется с командой `/card` для пресетов Flex messages: ``` /card info "Welcome" "Thanks for joining!" ``` ## Поддержка ACP LINE поддерживает привязки бесед ACP (Agent Communication Protocol): - `/acp spawn --bind here` привязывает текущий чат LINE к сессии ACP без создания дочернего треда. - Настроенные привязки ACP и активные сессии ACP, привязанные к беседе, работают в LINE так же, как и в других каналах бесед. См. [агенты ACP](/tools/acp-agents) для подробностей. ## Исходящие медиа Plugin LINE поддерживает отправку изображений, видео и аудиофайлов через инструмент сообщений агента. Медиа отправляется через специфичный для LINE путь доставки с соответствующей обработкой предпросмотра и отслеживания: - **Изображения**: отправляются как сообщения с изображениями LINE с автоматической генерацией предпросмотра. - **Видео**: отправляются с явной обработкой предпросмотра и типа содержимого. - **Аудио**: отправляется как аудиосообщения LINE. URL исходящих медиа должны быть публичными HTTPS URL. OpenClaw проверяет целевое имя хоста перед передачей URL в LINE и отклоняет local loopback, link-local и цели в частных сетях. Общие отправки медиа возвращаются к существующему маршруту только для изображений, когда специфичный для LINE путь недоступен. ## Устранение неполадок - **Проверка webhook не проходит:** убедитесь, что URL webhook использует HTTPS и `channelSecret` совпадает с LINE console. - **Нет входящих событий:** подтвердите, что путь webhook совпадает с `channels.line.webhookPath` и что gateway доступен из LINE. - **Ошибки скачивания медиа:** увеличьте `channels.line.mediaMaxMb`, если медиа превышает лимит по умолчанию. ## См. также - [Обзор каналов](/channels) — все поддерживаемые каналы - [Сопряжение](/channels/pairing) — аутентификация личных сообщений и поток сопряжения - [Группы](/channels/groups) — поведение групповых чатов и ограничение по упоминаниям - [Маршрутизация каналов](/channels/channel-routing) — маршрутизация сессий для сообщений - [Безопасность](/gateway/security) — модель доступа и усиление защиты