LINE

​

Installation

openclaw plugins install @openclaw/line

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

​

Configuration initiale

1. Créez un compte LINE Developers et ouvrez la Console : https://developers.line.biz/console/
2. Créez (ou sélectionnez) un Provider et ajoutez un canal Messaging API.
3. Copiez le Channel access token et le Channel secret depuis les paramètres du canal.
4. Activez Use webhook dans les paramètres de Messaging API.
5. Définissez l’URL du Webhook sur le point de terminaison de votre Gateway (HTTPS requis) :

https://gateway-host/line/webhook

• La vérification de la signature LINE dépend du corps (HMAC calculé sur le corps brut) ; OpenClaw applique donc une limite stricte du corps avant authentification (64 KB) et un délai d’expiration de lecture avant la vérification.
• OpenClaw traite les événements du Webhook à partir des octets bruts de la requête vérifiée. Les valeurs req.body transformées par un middleware en amont sont ignorées afin de préserver l’intégrité de la signature.

​

Configuration

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

​

Contrôle d’accès

openclaw pairing list line
openclaw pairing approve line <CODE>

• channels.line.dmPolicy : pairing | allowlist | open | disabled (valeur par défaut : pairing)
• channels.line.allowFrom : identifiants utilisateur LINE autorisés pour les messages directs ; dmPolicy: "open" nécessite ["*"]
• channels.line.groupPolicy : allowlist | open | disabled (valeur par défaut : allowlist)
• channels.line.groupAllowFrom : identifiants utilisateur LINE autorisés pour les groupes ; les entrées allowFrom des messages directs n’autorisent pas les expéditeurs de groupe
• Remplacements par groupe : channels.line.groups.<groupId>.allowFrom (ainsi que enabled, requireMention, systemPrompt, skills). Avec groupPolicy: "allowlist", définissez groupAllowFrom ou la valeur allowFrom propre au groupe ; une liste d’autorisation de groupe vide bloque les messages de groupe même lorsque les messages directs sont ouverts.
• Les groupes d’accès statiques d’expéditeurs peuvent être référencés depuis allowFrom, groupAllowFrom et la valeur allowFrom propre au groupe avec accessGroup:<name> ; consultez Groupes d’accès.
• Remarque sur l’exécution : si channels.line est entièrement absent, l’exécution utilise groupPolicy="allowlist" comme solution de repli pour les vérifications de groupe (même si channels.defaults.groupPolicy est défini).

• Utilisateur : U + 32 caractères hexadécimaux
• Groupe : C + 32 caractères hexadécimaux
• Salon : R + 32 caractères hexadécimaux

​

Comportement des messages

• Le texte est découpé en segments de 5000 caractères.
• La mise en forme Markdown est supprimée ; les blocs de code et les tableaux sont convertis en cartes Flex lorsque cela est possible.
• Les réponses diffusées en continu sont mises en mémoire tampon ; LINE reçoit des segments complets avec une animation de chargement pendant que l’agent travaille.
• La taille des téléchargements de médias est limitée par channels.line.mediaMaxMb (valeur par défaut : 10).
• Les médias entrants sont enregistrés sous ~/.openclaw/media/inbound/ avant d’être transmis à l’agent, conformément au stockage de médias partagé utilisé par les autres plugins de canal.

​

Données du canal (messages enrichis)

{
  text: "Voici",
  channelData: {
    line: {
      quickReplies: ["État", "Aide"],
      location: {
        title: "Bureau",
        address: "123 Main St",
        latitude: 35.681236,
        longitude: 139.767125,
      },
      flexMessage: {
        altText: "Carte d’état",
        contents: {/* Charge utile Flex */},
      },
      templateMessage: {
        type: "confirm",
        text: "Continuer ?",
        confirmLabel: "Oui",
        confirmData: "yes",
        cancelLabel: "Non",
        cancelData: "no",
      },
    },
  },
}

/card info "Bienvenue" "Merci de nous avoir rejoints !"

​

Prise en charge d’ACP

• /acp spawn <agent> --bind here lie la discussion LINE actuelle à une session ACP sans créer de fil enfant.
• Les liaisons ACP configurées et les sessions ACP actives liées à une conversation fonctionnent sur LINE comme sur les autres canaux de conversation.

​

Médias sortants

• Images : envoyées sous forme de messages image LINE ; l’image d’aperçu utilise par défaut l’URL du média.
• Vidéos : nécessitent une image d’aperçu ; définissez channelData.line.previewImageUrl sur une URL d’image.
• Audio : envoyé sous forme de messages audio LINE ; la durée est de 60 secondes par défaut, sauf si channelData.line.durationMs est défini.

​

Dépannage

• Échec de la vérification du Webhook : vérifiez que l’URL du Webhook utilise HTTPS et que channelSecret correspond à la Console LINE.
• Aucun événement entrant : vérifiez que le chemin du Webhook correspond à channels.line.webhookPath et que le Gateway est accessible depuis LINE.
• Erreurs de téléchargement des médias : augmentez channels.line.mediaMaxMb si les médias dépassent la limite par défaut.

​

Voir aussi

• Vue d’ensemble des canaux — tous les canaux pris en charge
• Appairage — authentification des messages directs et processus d’appairage
• Groupes — comportement des discussions de groupe et filtrage par mention
• Routage des canaux — routage des sessions pour les messages
• Sécurité — modèle d’accès et renforcement de la sécurité