OpenClaw LINE Kanal
Verbinden Sie OpenClaw mit LINE ueber die offizielle Messaging API. Diese plugin-basierte Integration ermoeglicht es Ihrem KI-Assistenten, Nachrichten auf LINE zu senden und zu empfangen — einer der beliebtesten Messaging-Plattformen in Japan, Taiwan, Thailand und Suedostasien. OpenClaw empfaengt Ereignisse ueber Webhook und antwortet ueber die Messaging API, wobei reichhaltige Nachrichtentypen einschliesslich Flex Messages, Vorlagennachrichten, Schnellantworten und Medienfreigabe unterstuetzt werden.
LINE Unterstützte Funktionen
Textnachrichten
Unterstützt
Medien & Dateien
Unterstützt
Reaktionen
Nicht unterstützt
Threads
Nicht unterstützt
Sprachnachrichten
Nicht unterstützt
Gruppenchat
Unterstützt
LINE Voraussetzungen
- Ein LINE Developers-Konto (kostenlos unter developers.line.biz)
- Ein Provider und ein Messaging API-Kanal, erstellt in der LINE Developers Console
- Kanal-Zugriffstoken und Kanalgeheimnis aus Ihren Messaging API-Kanaleinstellungen
- OpenClaw Gateway laeuft und ist ueber eine oeffentliche HTTPS-URL erreichbar (erforderlich fuer Webhook)
- Das LINE-Plugin installiert: openclaw plugins install @openclaw/line
LINE Schnelleinrichtung
LINE Messaging API-Kanal erstellen
Melden Sie sich bei der LINE Developers Console an, erstellen Sie einen Provider (oder waehlen Sie einen bestehenden) und erstellen Sie dann einen neuen Messaging API-Kanal. Notieren Sie sich Ihre Kanal-ID, Ihr Kanalgeheimnis und stellen Sie ein Kanal-Zugriffstoken auf der Kanaleinstellungsseite aus.
LINE-Plugin installieren und Konfiguration hinzufuegen
Fuehren Sie 'openclaw plugins install @openclaw/line' aus, um das LINE-Plugin zu installieren. Fuegen Sie dann die LINE-Kanalkonfiguration zu ~/.openclaw/openclaw.json mit Ihrem channelAccessToken und channelSecret hinzu. Sie koennen auch die Umgebungsvariablen LINE_CHANNEL_ACCESS_TOKEN und LINE_CHANNEL_SECRET verwenden.
Webhook-URL konfigurieren
Navigieren Sie in der LINE Developers Console zum Messaging API-Tab Ihres Kanals. Setzen Sie die Webhook-URL auf 'https://<ihr-gateway-host>/line/webhook' und aktivieren Sie 'Use webhook'. Klicken Sie auf Verify, um zu bestaetigten, dass der Endpunkt erreichbar ist. Deaktivieren Sie automatische Antworten und Begrüssungsnachrichten im LINE Official Account Manager, um doppelte Antworten zu vermeiden.
Testnachricht senden
Fuegen Sie Ihren LINE-Bot als Freund hinzu, indem Sie seinen QR-Code scannen (zu finden in der Console). Senden Sie eine Nachricht an den Bot. Bei Verwendung der Standard-Pairing-Richtlinie genehmigen Sie den Absender ueber 'openclaw pairing approve line <code>' in Ihrem Terminal.
LINE Konfigurationsbeispiel
{
"channels": {
"line": {
"enabled": true,
"channelAccessToken": "YOUR_CHANNEL_ACCESS_TOKEN",
"channelSecret": "YOUR_CHANNEL_SECRET",
"dmPolicy": "pairing"
}
}
}LINE Detaillierte Dokumentation
Architekturuebersicht
LINE Developers Console-Einrichtung
{
"channels": {
"line": {
"channelAccessToken": "YOUR_TOKEN",
"channelSecret": "YOUR_SECRET"
}
}
}Kanal-Zugriffstoken
DM-Richtlinien
{
"channels": {
"line": {
"dmPolicy": "allowlist",
"allowFrom": ["U1234567890abcdef1234567890abcdef"]
}
}
}Gruppenchat-Verwaltung
{
"channels": {
"line": {
"groupPolicy": "open",
"historyLimit": 50
}
}
}Rich Messages: Flex & Vorlagen
Medien & Anhaenge
{
"channels": {
"line": {
"mediaMaxMb": 10
}
}
}Webhook-Sicherheit
Ladeindikatoren & Zustellung
{
"channels": {
"line": {
"textChunkLimit": 5000,
"chunkMode": "newline"
}
}
}Multi-Account-Einrichtung
{
"channels": {
"line": {
"accounts": {
"main": {
"channelAccessToken": "TOKEN_1",
"channelSecret": "SECRET_1",
"webhookPath": "/line/main/webhook"
},
"support": {
"channelAccessToken": "TOKEN_2",
"channelSecret": "SECRET_2",
"webhookPath": "/line/support/webhook"
}
}
}
}
}LINE Konfigurationsreferenz
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | LINE-Kanal aktivieren oder deaktivieren |
| channelAccessToken | string | "" | LINE Messaging API Kanal-Zugriffstoken. Kann auch die Umgebungsvariable LINE_CHANNEL_ACCESS_TOKEN verwenden |
| channelSecret | string | "" | LINE-Kanalgeheimnis fuer Webhook-Signaturverifizierung. Kann auch die Umgebungsvariable LINE_CHANNEL_SECRET verwenden |
| tokenFile | string | "" | Pfad zu einer Datei mit dem Kanal-Zugriffstoken (Alternative zur Inline-Konfiguration) |
| secretFile | string | "" | Pfad zu einer Datei mit dem Kanalgeheimnis (Alternative zur Inline-Konfiguration) |
| dmPolicy | string | "pairing" | Steuert, wer dem Bot DMs senden kann. Optionen: pairing, allowlist, open, disabled |
| allowFrom | string[] | [] | LINE-Benutzer-IDs (U + 32 Hex), die dem Bot Nachrichten senden duerfen, wenn dmPolicy auf allowlist steht |
| dmHistoryLimit | number | 50 | Anzahl der letzten DM-Nachrichten, die als KI-Kontext pro Konversation einbezogen werden |
| groupPolicy | string | "disabled" | Gruppenchat-Richtlinie. Optionen: disabled, allowlist, open |
| groupAllowFrom | string[] | [] | LINE-Benutzer-IDs, die den Bot in Gruppen ausloesen duerfen (wenn groupPolicy auf allowlist steht) |
| historyLimit | number | 50 | Maximale Gruppennachrichten, die als KI-Kontext einbezogen werden. Auf 0 setzen zum Deaktivieren |
| textChunkLimit | number | 5000 | Maximale Zeichen pro ausgehender Nachricht vor der Aufteilung |
| chunkMode | string | "length" | Text-Aufteilungsmodus. Optionen: length (harte Aufteilung), newline (absatzorientiert) |
| mediaMaxMb | number | 10 | Maximale eingehende Mediendateigroesse in Megabyte |
| webhookPath | string | "/line/webhook" | Benutzerdefinierter Webhook-Pfad fuer dieses Konto (nuetzlich bei Multi-Account-Setups) |
| accounts.<id>.channelAccessToken | string | "" | Pro-Konto Kanal-Zugriffstoken fuer Multi-Account-Setups |
| accounts.<id>.channelSecret | string | "" | Pro-Konto Kanalgeheimnis fuer Multi-Account-Setups |
| accounts.<id>.webhookPath | string | "/line/<id>/webhook" | Pro-Konto Webhook-Pfad fuer Multi-Account-Setups |
| configWrites | boolean | true | /config-Befehle zur Laufzeitaenderung von Kanaleinstellungen erlauben |
LINE-Kanal aktivieren oder deaktivieren
LINE Messaging API Kanal-Zugriffstoken. Kann auch die Umgebungsvariable LINE_CHANNEL_ACCESS_TOKEN verwenden
LINE-Kanalgeheimnis fuer Webhook-Signaturverifizierung. Kann auch die Umgebungsvariable LINE_CHANNEL_SECRET verwenden
Pfad zu einer Datei mit dem Kanal-Zugriffstoken (Alternative zur Inline-Konfiguration)
Pfad zu einer Datei mit dem Kanalgeheimnis (Alternative zur Inline-Konfiguration)
Steuert, wer dem Bot DMs senden kann. Optionen: pairing, allowlist, open, disabled
LINE-Benutzer-IDs (U + 32 Hex), die dem Bot Nachrichten senden duerfen, wenn dmPolicy auf allowlist steht
Anzahl der letzten DM-Nachrichten, die als KI-Kontext pro Konversation einbezogen werden
Gruppenchat-Richtlinie. Optionen: disabled, allowlist, open
LINE-Benutzer-IDs, die den Bot in Gruppen ausloesen duerfen (wenn groupPolicy auf allowlist steht)
Maximale Gruppennachrichten, die als KI-Kontext einbezogen werden. Auf 0 setzen zum Deaktivieren
Maximale Zeichen pro ausgehender Nachricht vor der Aufteilung
Text-Aufteilungsmodus. Optionen: length (harte Aufteilung), newline (absatzorientiert)
Maximale eingehende Mediendateigroesse in Megabyte
Benutzerdefinierter Webhook-Pfad fuer dieses Konto (nuetzlich bei Multi-Account-Setups)
Pro-Konto Kanal-Zugriffstoken fuer Multi-Account-Setups
Pro-Konto Kanalgeheimnis fuer Multi-Account-Setups
Pro-Konto Webhook-Pfad fuer Multi-Account-Setups
/config-Befehle zur Laufzeitaenderung von Kanaleinstellungen erlauben
LINE Häufig gestellte Fragen
LINE Fehlerbehebung
Das Gateway ist nicht aus dem Internet erreichbar, die URL ist falsch oder es gibt SSL-Zertifikatsprobleme.
Webhook ist in der Console nicht aktiviert, automatische Antwort stoert oder der Absender wurde nicht ueber die Pairing-Richtlinie genehmigt.
Das Kanal-Zugriffstoken ist ungueltig, abgelaufen oder widerrufen.
LINE-Antwort-Tokens laufen 1 Minute nach dem Senden des Webhook-Ereignisses ab. Wenn die KI-Verarbeitung laenger dauert, wird das Token ungueltig.
Das channelSecret in Ihrer Konfiguration stimmt nicht mit dem Kanalgeheimnis in der LINE Developers Console ueberein, oder ein Reverse Proxy aendert den Anfragekörper.