LIGNE

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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 fournisseur et ajoutez un canal Messaging API.
3. Copiez le jeton d’accès de canal et le secret de canal depuis les paramètres du canal.
4. Activez Utiliser le 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), OpenClaw applique donc 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 le middleware en amont sont ignorées pour garantir 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 expéditeur statiques peuvent être référencés depuis allowFrom, groupAllowFrom et 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
• Salle : R + 32 caractères hexadécimaux

​

Comportement des messages

• Le texte est découpé en blocs 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 mémoire tampon ; LINE reçoit des blocs 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 : confirmez que le chemin du Webhook correspond à channels.line.webhookPath et que le Gateway est accessible depuis LINE.
• Erreurs de téléchargement de médias : augmentez channels.line.mediaMaxMb si le média dépasse la limite par défaut.

​

Connexe

• Vue d’ensemble des canaux — tous les canaux pris en charge
• Appariement — authentification DM et flux d’appariement
• Groupes — comportement des discussions de groupe et contrôle des mentions
• Routage de canal — routage de session pour les messages
• Sécurité — modèle d’accès et durcissement