LINE

​

Installer

openclaw plugins install @openclaw/line

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

​

Configuration

1. Créez un compte LINE Developers et ouvrez la Console : https://developers.line.biz/console/
2. Créez (ou choisissez) 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 votre point de terminaison Gateway (HTTPS requis) :

https://gateway-host/line/webhook

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

​

Configurer

{
  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
• channels.line.allowFrom : IDs utilisateur LINE autorisés pour les DM ; dmPolicy: "open" nécessite ["*"]
• channels.line.groupPolicy : allowlist | open | disabled
• channels.line.groupAllowFrom : IDs utilisateur LINE autorisés pour les groupes
• Remplacements par groupe : channels.line.groups.<groupId>.allowFrom
• Les groupes d’accès d’expéditeur statiques peuvent être référencés depuis allowFrom, groupAllowFrom et le allowFrom par groupe avec accessGroup:<name>.
• Note d’exécution : si channels.line est complètement absent, l’exécution revient à groupPolicy="allowlist" 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 morceaux 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 c’est possible.
• Les réponses en streaming sont mises en tampon ; LINE reçoit des morceaux complets avec une animation de chargement pendant que l’agent travaille.
• Les téléchargements de médias sont plafonnés par channels.line.mediaMaxMb (10 par défaut).
• Les médias entrants sont enregistrés sous ~/.openclaw/media/inbound/ avant d’être transmis à l’agent, conformément au magasin de médias partagé utilisé par les autres Plugins de canal groupés.

​

Données de canal (messages enrichis)

{
  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!"

​

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 comme messages image LINE avec génération automatique d’aperçu.
• Vidéos : envoyées avec gestion explicite de l’aperçu et du type de contenu.
• Audio : envoyé comme messages audio LINE.

​

Dépannage

• La vérification du Webhook échoue : assurez-vous que l’URL du Webhook utilise HTTPS et que le 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 joignable depuis LINE.
• Erreurs de téléchargement de médias : augmentez channels.line.mediaMaxMb si les médias dépassent la limite par défaut.

​

Connexe

• Vue d’ensemble des canaux — tous les canaux pris en charge
• Appairage — authentification DM et flux d’appairage
• Groupes — comportement des discussions de groupe et filtrage des mentions
• Routage des canaux — routage des sessions pour les messages
• Sécurité — modèle d’accès et durcissement