LINE

​

Installieren

openclaw plugins install @openclaw/line

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

• 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

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

{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",
      channelSecret: "LINE_CHANNEL_SECRET",
      dmPolicy: "open",
      allowFrom: ["*"],
    },
  },
}

• LINE_CHANNEL_ACCESS_TOKEN
• LINE_CHANNEL_SECRET

{
  channels: {
    line: {
      tokenFile: "/path/to/line-token.txt",
      secretFile: "/path/to/line-secret.txt",
    },
  },
}

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

​

Zugriffskontrolle

openclaw pairing list line
openclaw pairing approve line <CODE>

• 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.<groupId>.allowFrom
• Statische Absender-Zugriffsgruppen können aus allowFrom, groupAllowFrom und gruppenspezifischem allowFrom mit accessGroup:<name> 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).

• 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)

{
  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",
      },
    },
  },
}

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

​

ACP-Unterstützung

• /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 bei anderen Konversationskanälen.

​

Ausgehende Medien

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

​

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 — alle unterstützten Kanäle
• Pairing — DM-Authentifizierung und Pairing-Ablauf
• Gruppen — Gruppenchat-Verhalten und Mention-Gating
• Kanalrouting — Sitzungsrouting für Nachrichten
• Sicherheit — Zugriffsmodell und Härtung