LINE

​

Installazione

openclaw plugins install @openclaw/line

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

​

Configurazione iniziale

1. Creare un account LINE Developers e aprire la Console: https://developers.line.biz/console/
2. Creare (o selezionare) un Provider e aggiungere un canale Messaging API.
3. Copiare Channel access token e Channel secret dalle impostazioni del canale.
4. Abilitare Use webhook nelle impostazioni della Messaging API.
5. Impostare l’URL del webhook sull’endpoint del gateway (HTTPS obbligatorio):

https://gateway-host/line/webhook

• La verifica della firma LINE dipende dal corpo (HMAC sul corpo non elaborato), quindi OpenClaw applica un limite rigoroso al corpo prima dell’autenticazione (64 KB) e un timeout di lettura prima della verifica.
• OpenClaw elabora gli eventi webhook dai byte verificati della richiesta non elaborata. I valori req.body trasformati dal middleware a monte vengono ignorati per garantire l’integrità della firma.

​

Configurazione

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

​

Controllo degli accessi

openclaw pairing list line
openclaw pairing approve line <CODE>

• channels.line.dmPolicy: pairing | allowlist | open | disabled (valore predefinito pairing)
• channels.line.allowFrom: ID utente LINE consentiti per i messaggi diretti; dmPolicy: "open" richiede ["*"]
• channels.line.groupPolicy: allowlist | open | disabled (valore predefinito allowlist)
• channels.line.groupAllowFrom: ID utente LINE consentiti per i gruppi; le voci allowFrom dei messaggi diretti non ammettono i mittenti dei gruppi
• Override per gruppo: channels.line.groups.<groupId>.allowFrom (oltre a enabled, requireMention, systemPrompt, skills). Con groupPolicy: "allowlist", impostare groupAllowFrom o il valore per gruppo allowFrom; un elenco consentito del gruppo vuoto blocca i messaggi del gruppo anche quando i messaggi diretti sono aperti.
• È possibile fare riferimento ai gruppi statici di accesso dei mittenti da allowFrom, groupAllowFrom e dal valore per gruppo allowFrom con accessGroup:<name>; vedere Gruppi di accesso.
• Nota sull’esecuzione: se channels.line è completamente assente, in fase di esecuzione viene usato groupPolicy="allowlist" come alternativa per i controlli dei gruppi (anche se channels.defaults.groupPolicy è impostato).

• Utente: U + 32 caratteri esadecimali
• Gruppo: C + 32 caratteri esadecimali
• Stanza: R + 32 caratteri esadecimali

​

Comportamento dei messaggi

• Il testo viene suddiviso in blocchi di 5000 caratteri.
• La formattazione Markdown viene rimossa; i blocchi di codice e le tabelle vengono convertiti in schede Flex quando possibile.
• Le risposte in streaming vengono memorizzate nel buffer; LINE riceve blocchi completi con un’animazione di caricamento mentre l’agente lavora.
• I download dei contenuti multimediali sono limitati da channels.line.mediaMaxMb (valore predefinito 10).
• I contenuti multimediali in entrata vengono salvati in ~/.openclaw/media/inbound/ prima di essere passati all’agente, in linea con l’archivio multimediale condiviso utilizzato dagli altri plugin di canale.

​

Dati del canale (messaggi avanzati)

{
  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 "Benvenuto" "Grazie per esserti unito!"

​

Supporto ACP

• /acp spawn <agent> --bind here associa la chat LINE corrente a una sessione ACP senza creare un thread secondario.
• Le associazioni ACP configurate e le sessioni ACP attive associate alla conversazione funzionano su LINE come sugli altri canali di conversazione.

​

Contenuti multimediali in uscita

• Immagini: inviate come messaggi immagine LINE; per impostazione predefinita, l’immagine di anteprima corrisponde all’URL del contenuto multimediale.
• Video: richiedono un’immagine di anteprima; impostare channelData.line.previewImageUrl su un URL di immagine.
• Audio: inviato come messaggi audio LINE; la durata predefinita è di 60 secondi, a meno che non sia impostato channelData.line.durationMs.

​

Risoluzione dei problemi

• La verifica del webhook non riesce: assicurarsi che l’URL del webhook utilizzi HTTPS e che channelSecret corrisponda alla console LINE.
• Nessun evento in entrata: verificare che il percorso del webhook corrisponda a channels.line.webhookPath e che il gateway sia raggiungibile da LINE.
• Errori di download dei contenuti multimediali: aumentare channels.line.mediaMaxMb se i contenuti multimediali superano il limite predefinito.

​

Contenuti correlati

• Panoramica dei canali — tutti i canali supportati
• Associazione — autenticazione dei messaggi diretti e flusso di associazione
• Gruppi — comportamento delle chat di gruppo e controllo delle menzioni
• Instradamento dei canali — instradamento delle sessioni per i messaggi
• Sicurezza — modello di accesso e rafforzamento