LINE

​

Installeren

openclaw plugins install @openclaw/line

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

​

Instellen

1. Maak een LINE Developers-account aan en open de Console: https://developers.line.biz/console/
2. Maak (of kies) een Provider en voeg een Messaging API-kanaal toe.
3. Kopieer de Channel access token en Channel secret uit de kanaalinstellingen.
4. Schakel Use webhook in de Messaging API-instellingen in.
5. Stel de Webhook-URL in op je Gateway-eindpunt (HTTPS vereist):

https://gateway-host/line/webhook

• LINE-handtekeningverificatie is afhankelijk van de body (HMAC over de ruwe body), dus OpenClaw past strikte bodylimieten en een timeout vóór authenticatie toe voordat verificatie plaatsvindt.
• OpenClaw verwerkt Webhook-events vanuit de geverifieerde ruwe aanvraagbytes. Door upstream middleware getransformeerde req.body-waarden worden genegeerd voor de veiligheid van handtekeningintegriteit.

​

Configureren

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

​

Toegangscontrole

openclaw pairing list line
openclaw pairing approve line <CODE>

• channels.line.dmPolicy: pairing | allowlist | open | disabled
• channels.line.allowFrom: toegestane LINE-gebruikers-ID’s voor DM’s; dmPolicy: "open" vereist ["*"]
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: toegestane LINE-gebruikers-ID’s voor groepen
• Overrides per groep: channels.line.groups.<groupId>.allowFrom
• Statische afzendertoegangsgroepen kunnen worden verwezen vanuit allowFrom, groupAllowFrom en per-groep allowFrom met accessGroup:<name>.
• Runtime-opmerking: als channels.line volledig ontbreekt, valt de runtime terug op groupPolicy="allowlist" voor groepscontroles (zelfs als channels.defaults.groupPolicy is ingesteld).

• Gebruiker: U + 32 hextekens
• Groep: C + 32 hextekens
• Room: R + 32 hextekens

​

Berichtgedrag

• Tekst wordt opgesplitst op 5000 tekens.
• Markdown-opmaak wordt verwijderd; codeblokken en tabellen worden waar mogelijk omgezet naar Flex cards.
• Streamingreacties worden gebufferd; LINE ontvangt volledige chunks met een laadanimatie terwijl de agent werkt.
• Mediadownloads worden begrensd door channels.line.mediaMaxMb (standaard 10).
• Inkomende media worden opgeslagen onder ~/.openclaw/media/inbound/ voordat ze worden doorgegeven aan de agent, overeenkomstig de gedeelde mediaopslag die door andere gebundelde kanaal-Plugins wordt gebruikt.

​

Kanaalgegevens (rijke berichten)

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

• /acp spawn <agent> --bind here bindt de huidige LINE-chat aan een ACP-sessie zonder een child thread te maken.
• Geconfigureerde ACP-bindingen en actieve conversatiegebonden ACP-sessies werken op LINE zoals op andere conversatiekanalen.

​

Uitgaande media

• Afbeeldingen: verzonden als LINE-afbeeldingsberichten met automatische previewgeneratie.
• Video’s: verzonden met expliciete afhandeling van preview en contenttype.
• Audio: verzonden als LINE-audioberichten.

​

Probleemoplossing

• Webhook-verificatie mislukt: zorg dat de Webhook-URL HTTPS gebruikt en dat channelSecret overeenkomt met de LINE-console.
• Geen inkomende events: controleer of het Webhook-pad overeenkomt met channels.line.webhookPath en of de Gateway bereikbaar is vanaf LINE.
• Mediadownloadfouten: verhoog channels.line.mediaMaxMb als media de standaardlimiet overschrijden.

​

Gerelateerd

• Kanalenoverzicht — alle ondersteunde kanalen
• Pairing — DM-authenticatie en pairingflow
• Groepen — gedrag van groepschats en mention gating
• Kanaalroutering — sessieroutering voor berichten
• Beveiliging — toegangsmodel en hardening