> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # LINE 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw plugins install @openclaw/line ``` Lokaler Checkout (wenn aus einem Git-Repo ausgeführt): ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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/](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): ``` 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..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 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { line: { enabled: true, channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN", channelSecret: "LINE_CHANNEL_SECRET", dmPolicy: "pairing", }, }, } ``` Öffentliche DM-Konfiguration: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw pairing list line openclaw pairing approve line ``` 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..allowFrom` * Statische Absender-Zugriffsgruppen können aus `allowFrom`, `groupAllowFrom` und gruppenspezifischem `allowFrom` mit `accessGroup:` 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 (Agent Communication Protocol)-Konversationsbindungen: * `/acp spawn --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](/de/tools/acp-agents). ## 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 * [Kanalübersicht](/de/channels) — alle unterstützten Kanäle * [Pairing](/de/channels/pairing) — DM-Authentifizierung und Pairing-Ablauf * [Gruppen](/de/channels/groups) — Gruppenchat-Verhalten und Mention-Gating * [Kanalrouting](/de/channels/channel-routing) — Sitzungsrouting für Nachrichten * [Sicherheit](/de/gateway/security) — Zugriffsmodell und Härtung