LINE

​

Instalacja

openclaw plugins install @openclaw/line

openclaw plugins install ./path/to/local/line-plugin

​

Konfiguracja początkowa

1. Utwórz konto LINE Developers i otwórz Console: https://developers.line.biz/console/
2. Utwórz (lub wybierz) Provider i dodaj kanał Messaging API.
3. Skopiuj Channel access token i Channel secret z ustawień kanału.
4. Włącz Use webhook w ustawieniach Messaging API.
5. Ustaw adres URL webhooka na punkt końcowy Gateway (wymagany HTTPS):

https://gateway-host/line/webhook

• Weryfikacja podpisu LINE zależy od treści żądania (HMAC obliczany na podstawie nieprzetworzonej treści), dlatego OpenClaw przed uwierzytelnieniem stosuje ścisły limit rozmiaru treści (64 KB) i limit czasu odczytu.
• OpenClaw przetwarza zdarzenia webhooka na podstawie zweryfikowanych, nieprzetworzonych bajtów żądania. Wartości req.body przekształcone przez nadrzędne oprogramowanie pośredniczące są ignorowane w celu zapewnienia integralności podpisu.

​

Konfiguracja

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

​

Kontrola dostępu

openclaw pairing list line
openclaw pairing approve line <CODE>

• channels.line.dmPolicy: pairing | allowlist | open | disabled (domyślnie pairing)
• channels.line.allowFrom: dozwolone identyfikatory użytkowników LINE dla wiadomości bezpośrednich; dmPolicy: "open" wymaga ["*"]
• channels.line.groupPolicy: allowlist | open | disabled (domyślnie allowlist)
• channels.line.groupAllowFrom: dozwolone identyfikatory użytkowników LINE dla grup; wpisy allowFrom dotyczące wiadomości bezpośrednich nie dopuszczają nadawców grupowych
• Nadpisania dla poszczególnych grup: channels.line.groups.<groupId>.allowFrom (oraz enabled, requireMention, systemPrompt, skills). W przypadku groupPolicy: "allowlist" ustaw groupAllowFrom lub allowFrom dla danej grupy; pusta lista dozwolonych nadawców grupy blokuje wiadomości grupowe nawet wtedy, gdy wiadomości bezpośrednie są otwarte.
• Do statycznych grup dostępu nadawców można odwoływać się z poziomu allowFrom, groupAllowFrom oraz allowFrom dla poszczególnych grup za pomocą accessGroup:<name>; zobacz Grupy dostępu.
• Uwaga dotycząca środowiska uruchomieniowego: jeśli całkowicie brakuje channels.line, środowisko uruchomieniowe używa zastępczo groupPolicy="allowlist" do sprawdzania grup (nawet jeśli ustawiono channels.defaults.groupPolicy).

• Użytkownik: U + 32 znaki szesnastkowe
• Grupa: C + 32 znaki szesnastkowe
• Pokój: R + 32 znaki szesnastkowe

​

Obsługa wiadomości

• Tekst jest dzielony na fragmenty po 5000 znaków.
• Formatowanie Markdown jest usuwane; bloki kodu i tabele są w miarę możliwości konwertowane na karty Flex.
• Odpowiedzi strumieniowe są buforowane; LINE otrzymuje pełne fragmenty wraz z animacją ładowania podczas pracy agenta.
• Rozmiar pobieranych multimediów jest ograniczony przez channels.line.mediaMaxMb (domyślnie 10).
• Przychodzące multimedia są zapisywane w ~/.openclaw/media/inbound/ przed przekazaniem ich agentowi, zgodnie ze współdzielonym magazynem multimediów używanym przez inne Pluginy kanałów.

​

Dane kanału (wiadomości rozszerzone)

{
  text: "Proszę bardzo",
  channelData: {
    line: {
      quickReplies: ["Status", "Pomoc"],
      location: {
        title: "Biuro",
        address: "123 Main St",
        latitude: 35.681236,
        longitude: 139.767125,
      },
      flexMessage: {
        altText: "Karta statusu",
        contents: {/* Ładunek Flex */},
      },
      templateMessage: {
        type: "confirm",
        text: "Kontynuować?",
        confirmLabel: "Tak",
        confirmData: "yes",
        cancelLabel: "Nie",
        cancelData: "no",
      },
    },
  },
}

/card info "Witamy" "Dziękujemy za dołączenie!"

​

Obsługa ACP

• /acp spawn <agent> --bind here wiąże bieżący czat LINE z sesją ACP bez tworzenia wątku podrzędnego.
• Skonfigurowane powiązania ACP i aktywne sesje ACP powiązane z konwersacją działają w LINE tak samo jak w innych kanałach konwersacji.

​

Multimedia wychodzące

• Obrazy: wysyłane jako wiadomości graficzne LINE; obraz podglądu domyślnie używa adresu URL multimediów.
• Filmy: wymagają obrazu podglądu; ustaw channelData.line.previewImageUrl na adres URL obrazu.
• Dźwięk: wysyłany jako wiadomości dźwiękowe LINE; czas trwania domyślnie wynosi 60 sekund, chyba że ustawiono channelData.line.durationMs.

​

Rozwiązywanie problemów

• Weryfikacja webhooka nie powiodła się: upewnij się, że adres URL webhooka używa HTTPS, a channelSecret odpowiada wartości w LINE Console.
• Brak zdarzeń przychodzących: potwierdź, że ścieżka webhooka odpowiada channels.line.webhookPath i że Gateway jest dostępny z LINE.
• Błędy pobierania multimediów: zwiększ channels.line.mediaMaxMb, jeśli multimedia przekraczają domyślny limit.

​

Powiązane materiały

• Przegląd kanałów — wszystkie obsługiwane kanały
• Parowanie — uwierzytelnianie wiadomości bezpośrednich i proces parowania
• Grupy — obsługa czatów grupowych i wymóg wzmianki
• Routing kanałów — routing sesji dla wiadomości
• Bezpieczeństwo — model dostępu i wzmacnianie zabezpieczeń