--- read_when: - Chcesz połączyć OpenClaw z LINE - Potrzebujesz konfiguracji webhooka LINE i poświadczeń - Chcesz opcji wiadomości specyficznych dla LINE summary: Instalacja, konfiguracja i użycie Plugin LINE Messaging API title: WIERSZ x-i18n: generated_at: "2026-05-10T19:22:25Z" model: gpt-5.5 provider: openai source_hash: 7a11edbadda1ec99452eadc19a4557bb594f8b69ebb92314e2c3a0be325ab89d source_path: channels/line.md workflow: 16 --- LINE łączy się z OpenClaw przez LINE Messaging API. Plugin działa jako odbiornik webhooków na Gateway i używa tokenu dostępu kanału oraz sekretu kanału do uwierzytelniania. Status: Plugin do pobrania. Obsługiwane są wiadomości bezpośrednie, czaty grupowe, multimedia, lokalizacje, wiadomości Flex, wiadomości szablonowe i szybkie odpowiedzi. Reakcje i wątki nie są obsługiwane. ## Instalacja Zainstaluj LINE przed skonfigurowaniem kanału: ```bash openclaw plugins install @openclaw/line ``` Lokalny checkout (podczas uruchamiania z repozytorium git): ```bash openclaw plugins install ./path/to/local/line-plugin ``` ## Konfiguracja 1. Utwórz konto LINE Developers i otwórz Console: [https://developers.line.biz/console/](https://developers.line.biz/console/) 2. Utwórz (lub wybierz) Provider i dodaj kanał **Messaging API**. 3. Skopiuj **token dostępu kanału** i **sekret kanału** z ustawień kanału. 4. Włącz **Użyj webhooka** w ustawieniach Messaging API. 5. Ustaw URL webhooka na punkt końcowy Gateway (wymagany HTTPS): ``` https://gateway-host/line/webhook ``` Gateway odpowiada na weryfikację webhooka LINE (GET) i zdarzenia przychodzące (POST). Jeśli potrzebujesz niestandardowej ścieżki, ustaw `channels.line.webhookPath` lub `channels.line.accounts..webhookPath` i odpowiednio zaktualizuj URL. Uwaga dotycząca bezpieczeństwa: - Weryfikacja podpisu LINE zależy od treści żądania (HMAC na surowej treści), więc OpenClaw stosuje ścisłe limity treści przed uwierzytelnieniem oraz limit czasu przed weryfikacją. - OpenClaw przetwarza zdarzenia webhooka ze zweryfikowanych surowych bajtów żądania. Wartości `req.body` przekształcone przez middleware wyższego poziomu są ignorowane dla bezpieczeństwa integralności podpisu. ## Konfigurowanie Minimalna konfiguracja: ```json5 { channels: { line: { enabled: true, channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN", channelSecret: "LINE_CHANNEL_SECRET", dmPolicy: "pairing", }, }, } ``` Publiczna konfiguracja wiadomości DM: ```json5 { channels: { line: { enabled: true, channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN", channelSecret: "LINE_CHANNEL_SECRET", dmPolicy: "open", allowFrom: ["*"], }, }, } ``` Zmienne środowiskowe (tylko konto domyślne): - `LINE_CHANNEL_ACCESS_TOKEN` - `LINE_CHANNEL_SECRET` Pliki tokenu/sekretu: ```json5 { channels: { line: { tokenFile: "/path/to/line-token.txt", secretFile: "/path/to/line-secret.txt", }, }, } ``` `tokenFile` i `secretFile` muszą wskazywać zwykłe pliki. Dowiązania symboliczne są odrzucane. Wiele kont: ```json5 { channels: { line: { accounts: { marketing: { channelAccessToken: "...", channelSecret: "...", webhookPath: "/line/marketing", }, }, }, }, } ``` ## Kontrola dostępu Wiadomości bezpośrednie domyślnie używają parowania. Nieznani nadawcy otrzymują kod parowania, a ich wiadomości są ignorowane do czasu zatwierdzenia. ```bash openclaw pairing list line openclaw pairing approve line ``` Listy dozwolonych i zasady: - `channels.line.dmPolicy`: `pairing | allowlist | open | disabled` - `channels.line.allowFrom`: dozwolone identyfikatory użytkowników LINE dla wiadomości DM; `dmPolicy: "open"` wymaga `["*"]` - `channels.line.groupPolicy`: `allowlist | open | disabled` - `channels.line.groupAllowFrom`: dozwolone identyfikatory użytkowników LINE dla grup - Nadpisania dla grup: `channels.line.groups..allowFrom` - Statyczne grupy dostępu nadawców można wskazywać z `allowFrom`, `groupAllowFrom` i grupowego `allowFrom` za pomocą `accessGroup:`. - Uwaga dotycząca działania: jeśli `channels.line` całkowicie brakuje, środowisko uruchomieniowe cofa się do `groupPolicy="allowlist"` dla sprawdzeń grup (nawet jeśli ustawiono `channels.defaults.groupPolicy`). Identyfikatory LINE uwzględniają wielkość liter. Poprawne identyfikatory wyglądają tak: - Użytkownik: `U` + 32 znaki szesnastkowe - Grupa: `C` + 32 znaki szesnastkowe - Pokój: `R` + 32 znaki szesnastkowe ## Zachowanie wiadomości - Tekst jest dzielony na fragmenty po 5000 znaków. - Formatowanie Markdown jest usuwane; bloki kodu i tabele są konwertowane na karty Flex, gdy to możliwe. - Odpowiedzi strumieniowe są buforowane; LINE otrzymuje pełne fragmenty z animacją ładowania, gdy agent pracuje. - Pobieranie multimediów jest ograniczone przez `channels.line.mediaMaxMb` (domyślnie 10). - Multimedia przychodzące są zapisywane w `~/.openclaw/media/inbound/`, zanim zostaną przekazane do agenta, zgodnie ze wspólnym magazynem multimediów używanym przez inne dołączone pluginy kanałów. ## Dane kanału (wiadomości rozszerzone) Użyj `channelData.line`, aby wysyłać szybkie odpowiedzi, lokalizacje, karty Flex lub wiadomości szablonowe. ```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 zawiera również polecenie `/card` dla presetów wiadomości Flex: ``` /card info "Welcome" "Thanks for joining!" ``` ## Obsługa ACP LINE obsługuje powiązania konwersacji ACP (Agent Communication Protocol): - `/acp spawn --bind here` wiąże bieżący czat LINE z sesją ACP bez tworzenia wątku potomnego. - Skonfigurowane powiązania ACP i aktywne sesje ACP powiązane z konwersacją działają w LINE tak jak w innych kanałach konwersacji. Szczegóły znajdziesz w [agentach ACP](/pl/tools/acp-agents). ## Multimedia wychodzące Plugin LINE obsługuje wysyłanie obrazów, filmów i plików audio przez narzędzie wiadomości agenta. Multimedia są wysyłane przez ścieżkę dostarczania właściwą dla LINE z odpowiednią obsługą podglądu i śledzenia: - **Obrazy**: wysyłane jako wiadomości obrazów LINE z automatycznym generowaniem podglądu. - **Filmy**: wysyłane z jawną obsługą podglądu i typu zawartości. - **Audio**: wysyłane jako wiadomości audio LINE. Adresy URL multimediów wychodzących muszą być publicznymi adresami HTTPS. OpenClaw weryfikuje docelową nazwę hosta przed przekazaniem URL do LINE i odrzuca cele local loopback, link-local oraz sieci prywatnych. Ogólne wysyłanie multimediów cofa się do istniejącej ścieżki tylko dla obrazów, gdy ścieżka właściwa dla LINE nie jest dostępna. ## Rozwiązywanie problemów - **Weryfikacja webhooka kończy się niepowodzeniem:** upewnij się, że URL webhooka używa HTTPS, a `channelSecret` odpowiada wartości w konsoli LINE. - **Brak zdarzeń przychodzących:** potwierdź, że ścieżka webhooka odpowiada `channels.line.webhookPath` i że Gateway jest osiągalny z LINE. - **Błędy pobierania multimediów:** zwiększ `channels.line.mediaMaxMb`, jeśli multimedia przekraczają domyślny limit. ## Powiązane - [Przegląd kanałów](/pl/channels) — wszystkie obsługiwane kanały - [Parowanie](/pl/channels/pairing) — uwierzytelnianie wiadomości DM i przepływ parowania - [Grupy](/pl/channels/groups) — zachowanie czatu grupowego i bramkowanie wzmianek - [Routing kanałów](/pl/channels/channel-routing) — routing sesji dla wiadomości - [Bezpieczeństwo](/pl/gateway/security) — model dostępu i utwardzanie