OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Regional platforms

LINE

Status: offizielles Plugin, separat installiert. Direktnachrichten, Gruppenchats, Medien,

LINE stellt über die LINE Messaging API eine Verbindung zu OpenClaw her. Das Plugin wird als Webhook- Empfänger auf dem Gateway ausgeführt und verwendet Ihr Channel Access Token und Ihr Channel Secret zur Authentifizierung.

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

Installation

Installieren Sie LINE, bevor Sie den Kanal konfigurieren:

bash
openclaw plugins install @openclaw/line

Lokaler Checkout (bei Ausführung aus einem Git-Repository):

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 Channel access token und Channel secret aus den Kanaleinstellungen.
  4. Aktivieren Sie Use webhook in den Messaging-API-Einstellungen.
  5. Legen Sie die Webhook-URL auf Ihren Gateway-Endpunkt fest (HTTPS erforderlich):
text
https://gateway-host/line/webhook

Das Gateway beantwortet die Webhook-Verifizierung von LINE (GET). Bei signierten eingehenden Ereignissen (POST) schreibt es jedes Ereignis in die persistente Eingangswarteschlange, bevor es 200 zurückgibt; die Verarbeitung durch den Agenten wird asynchron fortgesetzt. Fehlgeschlagene Zustellungen werden aus der Warteschlange erneut versucht, auch nach einem Neustart des Gateways, und problematische Ereignisse werden nach einer begrenzten Anzahl von Wiederholungsversuchen zu fehlgeschlagenen Warteschlangeneinträgen. Wenn die persistente Speicherung fehlschlägt, gibt die Anfrage 500 zurück, statt ein möglicherweise verlorenes Ereignis zu bestätigen. Die Zustellung über die Grenze zwischen Warteschlange und Agent erfolgt mindestens einmal: Wird das Gateway während einer aktiven Zustellung heruntergefahren oder stürzt ab, kann der Durchlauf wiederholt werden. Nachrichtenereignisse werden anhand der LINE-Nachrichten-ID dedupliziert; andere Ereignistypen verwenden webhookEventId. Aufbewahrte Abschlussdatensätze unterdrücken gewöhnliche doppelte Webhooks, Handler mit externen Nebeneffekten sollten jedoch weiterhin idempotent sein. Wenn Sie einen benutzerdefinierten Pfad benötigen, legen Sie channels.line.webhookPath oder channels.line.accounts.<id>.webhookPath fest und aktualisieren Sie die URL entsprechend.

Sicherheitshinweise:

  • Die Signaturverifizierung von LINE hängt vom Body ab (HMAC über den unveränderten Body). Daher wendet OpenClaw vor der Authentifizierung ein striktes Body-Limit (64 KB) und ein Lese-Timeout an.
  • OpenClaw verarbeitet Webhook-Ereignisse anhand der verifizierten unveränderten Anfragebytes. Durch vorgeschaltete Middleware veränderte req.body-Werte werden zum Schutz der Signaturintegrität ignoriert.

Konfiguration

Minimale Konfiguration:

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

Konfiguration für öffentliche Direktnachrichten:

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. Symbolische Links werden abgelehnt. Direkte Konfigurationswerte haben Vorrang vor Dateien; Umgebungsvariablen sind der letzte Rückgriff für das Standardkonto.

Mehrere Konten:

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

Zugriffskontrolle

Direktnachrichten verwenden standardmäßig die Kopplung. Unbekannte Absender erhalten einen Kopplungscode und ihre Nachrichten werden ignoriert, bis sie genehmigt wurden:

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

Zulassungslisten und Richtlinien:

  • channels.line.dmPolicy: pairing | allowlist | open | disabled (Standard: pairing)
  • channels.line.allowFrom: zugelassene LINE-Benutzer-IDs für Direktnachrichten; dmPolicy: "open" erfordert ["*"]
  • channels.line.groupPolicy: allowlist | open | disabled (Standard: allowlist)
  • channels.line.groupAllowFrom: zugelassene LINE-Benutzer-IDs für Gruppen; Direktnachrichten-Einträge in allowFrom lassen keine Gruppenabsender zu
  • Gruppenspezifische Überschreibungen: channels.line.groups.<groupId>.allowFrom (sowie enabled, requireMention, systemPrompt, skills). Legen Sie bei groupPolicy: "allowlist" groupAllowFrom oder das gruppenspezifische allowFrom fest; eine leere Gruppenzulassungsliste blockiert Gruppennachrichten selbst dann, wenn Direktnachrichten offen sind.
  • Statische Absender-Zugriffsgruppen können aus allowFrom, groupAllowFrom und dem gruppenspezifischen allowFrom mit accessGroup:<name> referenziert werden; siehe Zugriffsgruppen.
  • Laufzeithinweis: Wenn channels.line vollständig fehlt, greift die Laufzeit bei Gruppenprüfungen auf groupPolicy="allowlist" zurück (selbst wenn channels.defaults.groupPolicy festgelegt ist).

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

  • Benutzer: U + 32 Hexadezimalzeichen
  • Gruppe: C + 32 Hexadezimalzeichen
  • Raum: R + 32 Hexadezimalzeichen

Nachrichtenverhalten

  • Text wird in Abschnitte von jeweils 5000 Zeichen aufgeteilt.
  • Markdown-Formatierungen werden entfernt; Codeblöcke und Tabellen werden nach Möglichkeit in Flex- Karten umgewandelt.
  • Streaming-Antworten werden gepuffert; LINE erhält vollständige Abschnitte 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 Agenten übergeben werden. Dies entspricht dem gemeinsamen Medienspeicher anderer Kanal-Plugins.

Kanaldaten (Rich Messages)

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

json5
{  text: "Hier ist es",  channelData: {    line: {      quickReplies: ["Status", "Hilfe"],      location: {        title: "Büro",        address: "123 Main St",        latitude: 35.681236,        longitude: 139.767125,      },      flexMessage: {        altText: "Statuskarte",        contents: {/* Flex-Nutzlast */},      },      templateMessage: {        type: "confirm",        text: "Fortfahren?",        confirmLabel: "Ja",        confirmData: "yes",        cancelLabel: "Nein",        cancelData: "no",      },    },  },}

Das LINE-Plugin enthält außerdem einen /card-Befehl für Flex-Nachrichtenvorlagen:

text
/card info "Willkommen" "Vielen Dank für Ihre Teilnahme!"

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, an Konversationen gebundene ACP-Sitzungen funktionieren in LINE wie in anderen Konversationskanälen.

Weitere Einzelheiten finden Sie unter ACP-Agenten.

Ausgehende Medien

Das LINE-Plugin sendet Bilder, Videos und Audio über das Nachrichtenwerkzeug des Agenten:

  • Bilder: werden als LINE-Bildnachrichten gesendet; für das Vorschaubild wird standardmäßig die Medien-URL verwendet.
  • Videos: erfordern ein Vorschaubild; legen Sie channelData.line.previewImageUrl auf eine Bild-URL fest.
  • Audio: wird als LINE-Audionachricht gesendet; die Dauer beträgt standardmäßig 60 Sekunden, sofern channelData.line.durationMs nicht festgelegt ist.

Der Medientyp wird aus channelData.line.mediaKind übernommen, wenn dieser Wert festgelegt ist. Andernfalls wird er aus den anderen LINE-Optionen oder der Dateiendung der URL abgeleitet, wobei Bilder als Rückgriff dienen.

URLs ausgehender Medien müssen öffentliche HTTPS-URLs mit höchstens 2000 Zeichen sein. OpenClaw validiert den Zielhostnamen, bevor die URL an LINE übergeben wird, und lehnt Loopback-, Link-Local- und private Netzwerkziele ab.

Generische Medienübertragungen ohne LINE-spezifische Optionen verwenden die Bildroute.

Fehlerbehebung

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

Verwandte Themen

  • Kanalübersicht — alle unterstützten Kanäle
  • Kopplung — Authentifizierung von Direktnachrichten und Kopplungsablauf
  • Gruppen — Verhalten von Gruppenchats und Erwähnungssteuerung
  • Kanal-Routing — Sitzungs-Routing für Nachrichten
  • Sicherheit — Zugriffsmodell und Härtung
Was this useful?
On this page

On this page