English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Regional platforms

LINE

Status: herunterladbares Plugin. Direktnachrichten, Gruppenchats, Medien, Standorte, Flex-

LINE verbindet sich über die LINE Messaging API mit OpenClaw. Das Plugin läuft als Webhook- Empfänger auf dem Gateway und verwendet Ihr Channel access token + Channel secret für die Authentifizierung.

Status: herunterladbares Plugin. Direktnachrichten, Gruppenchats, Medien, Standorte, Flex- Nachrichten, Template-Nachrichten und Schnellantworten werden unterstützt. Reaktionen und Threads werden nicht unterstützt.

Installieren

Installieren Sie LINE, bevor Sie den Kanal konfigurieren:

bash
openclaw plugins install @openclaw/line

Lokaler Checkout (wenn aus einem Git-Repo ausgeführt):

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

Einrichtung

  1. Erstellen Sie ein LINE Developers-Konto und öffnen Sie die Console: https://developers.line.biz/console/
  2. Erstellen (oder wählen) Sie einen Provider und fügen Sie einen Messaging API-Kanal hinzu.
  3. Kopieren Sie das Channel access token und das Channel secret aus den Kanaleinstellungen.
  4. Aktivieren Sie Use webhook in den Messaging API-Einstellungen.
  5. Setzen Sie die Webhook-URL auf Ihren Gateway-Endpunkt (HTTPS erforderlich):
Code
https://gateway-host/line/webhook

Das Gateway antwortet auf die Webhook-Verifizierung (GET) von LINE und bestätigt signierte eingehende Ereignisse (POST) unmittelbar nach Signatur- und Payload-Validierung; die Agent- Verarbeitung wird asynchron fortgesetzt. Wenn Sie einen benutzerdefinierten Pfad benötigen, setzen Sie channels.line.webhookPath oder channels.line.accounts.<id>.webhookPath und aktualisieren Sie die URL entsprechend.

Sicherheitshinweis:

  • Die LINE-Signaturverifizierung hängt vom Body ab (HMAC über den Raw Body), daher wendet OpenClaw vor der Verifizierung strenge Pre-Auth-Body-Limits und Timeouts an.
  • OpenClaw verarbeitet Webhook-Ereignisse aus den verifizierten Raw-Request-Bytes. Durch Upstream-Middleware transformierte req.body-Werte werden zur Wahrung der Signaturintegrität ignoriert.

Konfigurieren

Minimale Konfiguration:

json5
{  channels: {    line: {      enabled: true,      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",      channelSecret: "LINE_CHANNEL_SECRET",      dmPolicy: "pairing",    },  },}

Öffentliche DM-Konfiguration:

json5
{  channels: {    line: {      enabled: true,      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",      channelSecret: "LINE_CHANNEL_SECRET",      dmPolicy: "open",      allowFrom: ["*"],    },  },}

Umgebungsvariablen (nur Standardkonto):

  • LINE_CHANNEL_ACCESS_TOKEN
  • LINE_CHANNEL_SECRET

Token-/Secret-Dateien:

json5
{  channels: {    line: {      tokenFile: "/path/to/line-token.txt",      secretFile: "/path/to/line-secret.txt",    },  },}

tokenFile und secretFile müssen auf reguläre Dateien verweisen. Symlinks werden abgelehnt.

Mehrere Konten:

json5
{  channels: {    line: {      accounts: {        marketing: {          channelAccessToken: "...",          channelSecret: "...",          webhookPath: "/line/marketing",        },      },    },  },}

Zugriffskontrolle

Direktnachrichten verwenden standardmäßig Pairing. Unbekannte Absender erhalten einen Pairing-Code, und ihre Nachrichten werden ignoriert, bis sie genehmigt wurden.

bash
openclaw pairing list lineopenclaw pairing approve line &lt;CODE&gt;

Allowlist und Richtlinien:

  • channels.line.dmPolicy: pairing | allowlist | open | disabled
  • channels.line.allowFrom: allowgelistete LINE-Benutzer-IDs für DMs; dmPolicy: "open" erfordert ["*"]
  • channels.line.groupPolicy: allowlist | open | disabled
  • channels.line.groupAllowFrom: allowgelistete LINE-Benutzer-IDs für Gruppen
  • Überschreibungen pro Gruppe: channels.line.groups.<groupId>.allowFrom
  • Statische Absender-Zugriffsgruppen können aus allowFrom, groupAllowFrom und gruppenspezifischem allowFrom mit accessGroup:<name> referenziert werden.
  • Runtime-Hinweis: Wenn channels.line vollständig fehlt, fällt die Runtime für Gruppenprüfungen auf groupPolicy="allowlist" zurück (auch wenn channels.defaults.groupPolicy gesetzt ist).

Bei LINE-IDs wird zwischen Groß- und Kleinschreibung unterschieden. Gültige IDs sehen so aus:

  • Benutzer: U + 32 Hex-Zeichen
  • Gruppe: C + 32 Hex-Zeichen
  • Raum: R + 32 Hex-Zeichen

Nachrichtenverhalten

  • Text wird bei 5000 Zeichen in Blöcke aufgeteilt.
  • Markdown-Formatierung wird entfernt; Codeblöcke und Tabellen werden, wenn möglich, in Flex- Karten umgewandelt.
  • Streaming-Antworten werden gepuffert; LINE erhält vollständige Blöcke mit einer Ladeanimation, während der Agent arbeitet.
  • Mediendownloads sind durch channels.line.mediaMaxMb begrenzt (Standard 10).
  • Eingehende Medien werden unter ~/.openclaw/media/inbound/ gespeichert, bevor sie an den Agent übergeben werden. Dies entspricht dem gemeinsamen Medienspeicher, der von anderen gebündelten Kanal- Plugins verwendet wird.

Kanaldaten (Rich Messages)

Verwenden Sie channelData.line, um Schnellantworten, Standorte, Flex-Karten oder Template- Nachrichten zu senden.

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

Das LINE-Plugin liefert außerdem einen /card-Befehl für Flex-Nachrichten-Presets mit:

Code
/card info "Welcome" "Thanks for joining!"

ACP-Unterstützung

LINE unterstützt ACP (Agent Communication Protocol)-Konversationsbindungen:

  • /acp spawn <agent> --bind here bindet den aktuellen LINE-Chat an eine ACP-Sitzung, ohne einen untergeordneten Thread zu erstellen.
  • Konfigurierte ACP-Bindungen und aktive konversationsgebundene ACP-Sitzungen funktionieren auf LINE wie bei anderen Konversationskanälen.

Details finden Sie unter ACP-Agenten.

Ausgehende Medien

Das LINE-Plugin unterstützt das Senden von Bildern, Videos und Audiodateien über das Agent-Nachrichtenwerkzeug. Medien werden über den LINE-spezifischen Zustellpfad mit geeigneter Vorschau- und Tracking-Behandlung gesendet:

  • Bilder: werden als LINE-Bildnachrichten mit automatischer Vorschaugenerierung gesendet.
  • Videos: werden mit expliziter Vorschau- und Content-Type-Behandlung gesendet.
  • Audio: wird als LINE-Audionachrichten gesendet.

URLs für ausgehende Medien müssen öffentliche HTTPS-URLs sein. OpenClaw validiert den Ziel-Hostnamen, bevor die URL an LINE übergeben wird, und lehnt loopback-, link-local- und private Netzwerkziele ab.

Generische Mediendaten-Sends fallen auf die vorhandene reine Bildroute zurück, wenn kein LINE-spezifischer Pfad verfügbar ist.

Fehlerbehebung

  • Webhook-Verifizierung schlägt fehl: Stellen Sie sicher, dass die Webhook-URL HTTPS verwendet und das channelSecret mit der LINE Console übereinstimmt.
  • Keine eingehenden Ereignisse: Bestätigen Sie, dass der Webhook-Pfad mit channels.line.webhookPath übereinstimmt und das Gateway von LINE aus erreichbar ist.
  • Fehler beim Mediendownload: Erhöhen Sie channels.line.mediaMaxMb, wenn Medien das Standardlimit überschreiten.

Verwandte Themen

Was this useful?
On this page

On this page