ZEILE

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

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

Installieren

Installieren Sie LINE, bevor Sie den Kanal konfigurieren:

openclaw plugins install @openclaw/line

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

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 Sie einen Provider (oder wählen Sie einen aus) und fügen Sie einen Messaging API-Kanal hinzu.
3. Kopieren Sie den 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):

https://gateway-host/line/webhook

Das Gateway beantwortet die Webhook-Verifizierung (GET) und eingehende Ereignisse (POST) von LINE. 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 rohen Body), daher wendet OpenClaw vor der Verifizierung strenge Body-Limits und ein Timeout vor der Authentifizierung an.
• OpenClaw verarbeitet Webhook-Ereignisse aus den verifizierten rohen Request-Bytes. Durch vorgeschaltete Middleware transformierte req.body-Werte werden aus Gründen der Signaturintegrität ignoriert.

Konfigurieren

Minimale Konfiguration:

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

Öffentliche DM-Konfiguration:

{  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:

{  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:

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

openclaw pairing list lineopenclaw pairing approve line <CODE>

Allowlist und Richtlinien:

• channels.line.dmPolicy: pairing | allowlist | open | disabled
• channels.line.allowFrom: allowlistete LINE-Benutzer-IDs für DMs; dmPolicy: "open" erfordert ["*"]
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: allowlistete LINE-Benutzer-IDs für Gruppen
• Gruppenbezogene Overrides: channels.line.groups.<groupId>.allowFrom
• Statische Sender-Zugriffsgruppen können aus allowFrom, groupAllowFrom und gruppenbezogenem allowFrom mit accessGroup:<name> referenziert werden.
• Laufzeithinweis: 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).

LINE-IDs unterscheiden Groß- und Kleinschreibung. 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 aufgeteilt.
• Markdown-Formatierung wird entfernt; Codeblöcke und Tabellen werden nach Möglichkeit in Flex- Karten konvertiert.
• Streaming-Antworten werden gepuffert; LINE erhält vollständige Blöcke mit einer Ladeanimation, während der Agent arbeitet.
• Mediendownloads werden durch channels.line.mediaMaxMb begrenzt (Standard: 10).
• Eingehende Medien werden unter ~/.openclaw/media/inbound/ gespeichert, bevor sie an den Agent übergeben werden, passend zum gemeinsam genutzten Medienspeicher, der von anderen gebündelten Kanal- Plugins verwendet wird.

Kanaldaten (Rich Messages)

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

{  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:

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

ACP-Unterstützung

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

• /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 in 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-Nachrichtentool. 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.

Ausgehende Medien-URLs 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 Mediendsendungen fallen auf die bestehende 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 dass das Gateway von LINE erreichbar ist.
• Mediendownload-Fehler: Erhöhen Sie channels.line.mediaMaxMb, wenn Medien das Standardlimit überschreiten.

Verwandte Themen

• Kanalübersicht — alle unterstützten Kanäle
• Pairing — DM-Authentifizierung und Pairing-Ablauf
• Gruppen — Gruppenchat-Verhalten und Erwähnungs-Gating
• Kanal-Routing — Sitzungs-Routing für Nachrichten
• Sicherheit — Zugriffsmodell und Härtung