Regional platforms

ZEILE

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, Vorlagennachrichten und Schnellantworten werden unterstützt. Reaktionen und Threads werden nicht unterstützt.

Installation

Installieren Sie LINE, bevor Sie den Kanal konfigurieren:

openclaw plugins install @openclaw/line

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

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

Einrichtung

Erstellen Sie ein LINE Developers-Konto und öffnen Sie die Konsole: https://developers.line.biz/console/
Erstellen (oder wählen) Sie einen Provider und fügen Sie einen Messaging API-Kanal hinzu.
Kopieren Sie das Channel access token und das Channel secret aus den Kanaleinstellungen.
Aktivieren Sie Use webhook in den Messaging API-Einstellungen.
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 Signaturverifizierung von LINE hängt vom Body ab (HMAC über den Roh-Body), daher wendet OpenClaw vor der Verifizierung strikte Body-Limits vor der Authentifizierung und ein Timeout an.
OpenClaw verarbeitet Webhook-Ereignisse aus den verifizierten Roh-Request-Bytes. Von vorgelagerter Middleware transformierte req.body-Werte werden zur Sicherheit der Signaturintegrität ignoriert.

Konfiguration

Minimale Konfiguration:

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

Konfiguration für öffentliche Direktnachrichten:

{
  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 line
openclaw pairing approve line &lt;CODE&gt;

Allowlisten und Richtlinien:

channels.line.dmPolicy: pairing | allowlist | open | disabled
channels.line.allowFrom: allowlistete LINE-Benutzer-IDs für Direktnachrichten; dmPolicy: "open" erfordert ["*"]
channels.line.groupPolicy: allowlist | open | disabled
channels.line.groupAllowFrom: allowlistete LINE-Benutzer-IDs für Gruppen
Gruppenbezogene Überschreibungen: channels.line.groups.<groupId>.allowFrom
Laufzeithinweis: Wenn channels.line vollständig fehlt, fällt die Laufzeit 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 Teile 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 Teile 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. 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 Vorlagennachrichten 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 in 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 Nachrichten-Tool des Agents. Medien werden über den LINE-spezifischen Zustellpfad mit entsprechender Vorschau- und Tracking-Verarbeitung gesendet:

Bilder: werden als LINE-Bildnachrichten mit automatischer Vorschaugenerierung gesendet.
Videos: werden mit expliziter Vorschau- und Content-Type-Verarbeitung 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 local loopback-, link-local- und private Netzwerkziele ab.

Generische Mediensendungen 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 channelSecret mit der LINE-Konsole übereinstimmt.
Keine eingehenden Ereignisse: Bestätigen Sie, dass der Webhook-Pfad channels.line.webhookPath entspricht und dass das Gateway von LINE erreichbar ist.
Fehler beim Mediendownload: Erhöhen Sie channels.line.mediaMaxMb, wenn Medien das Standardlimit überschreiten.

ZEILE

Installation

Einrichtung

Konfiguration

Zugriffskontrolle

Nachrichtenverhalten

Kanaldaten (Rich Messages)

ACP-Unterstützung

Ausgehende Medien

Fehlerbehebung

Verwandte Themen

Ask OpenClaw

# Installation

# Einrichtung

# Konfiguration

# Zugriffskontrolle

# Nachrichtenverhalten

# Kanaldaten (Rich Messages)

# ACP-Unterstützung

# Ausgehende Medien

# Fehlerbehebung

# Verwandte Themen

Installation

Einrichtung

Konfiguration

Zugriffskontrolle

Nachrichtenverhalten

Kanaldaten (Rich Messages)

ACP-Unterstützung

Ausgehende Medien

Fehlerbehebung

Verwandte Themen