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 konsolę: 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 URL webhooka na punkt końcowy Gateway (wymagane HTTPS):

https://gateway-host/line/webhook

• Weryfikacja podpisu LINE zależy od treści żądania (HMAC po surowej treści), dlatego 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żej w stosie są ignorowane w celu zachowania 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
• channels.line.allowFrom: dozwolone identyfikatory użytkowników LINE dla 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.<groupId>.allowFrom
• Statyczne grupy dostępu nadawców mogą być przywoływane z allowFrom, groupAllowFrom i grupowego allowFrom za pomocą accessGroup:<name>.
• Uwaga dotycząca działania: jeśli całkowicie brakuje channels.line, środowisko uruchomieniowe wraca do groupPolicy="allowlist" dla 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

​

Zachowanie 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 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 agentowi, zgodnie ze wspólnym magazynem multimediów używanym przez inne dołączone Pluginy kanałów.

​

Dane kanału (bogate wiadomości)

{
  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!"

​

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 jak w innych kanałach konwersacji.

​

Multimedia wychodzące

• 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.

​

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 — wszystkie obsługiwane kanały
• Parowanie — uwierzytelnianie DM i przepływ parowania
• Grupy — zachowanie czatów grupowych i bramkowanie wzmianek
• Routing kanałów — routing sesji dla wiadomości
• Bezpieczeństwo — model dostępu i utwardzanie