LINE

LINE si connette a OpenClaw tramite la LINE Messaging API. Il Plugin viene eseguito come ricevitore Webhook sul Gateway e usa il token di accesso al canale + il segreto del canale per l'autenticazione.

Stato: Plugin scaricabile. Sono supportati messaggi diretti, chat di gruppo, contenuti multimediali, posizioni, messaggi Flex, messaggi template e risposte rapide. Reazioni e thread non sono supportati.

Installazione

Installa LINE prima di configurare il canale:

openclaw plugins install @openclaw/line

Checkout locale (quando esegui da un repo git):

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

Configurazione iniziale

1. Crea un account LINE Developers e apri la Console: https://developers.line.biz/console/
2. Crea (o scegli) un Provider e aggiungi un canale Messaging API.
3. Copia il Channel access token e il Channel secret dalle impostazioni del canale.
4. Abilita Use webhook nelle impostazioni della Messaging API.
5. Imposta l'URL del Webhook sull'endpoint del Gateway (HTTPS obbligatorio):

https://gateway-host/line/webhook

Il Gateway risponde alla verifica Webhook di LINE (GET) e conferma gli eventi in ingresso firmati (POST) subito dopo la convalida della firma e del payload; l'elaborazione dell'agente continua in modo asincrono. Se ti serve un percorso personalizzato, imposta channels.line.webhookPath o channels.line.accounts.<id>.webhookPath e aggiorna l'URL di conseguenza.

Nota di sicurezza:

• La verifica della firma LINE dipende dal body (HMAC sul body grezzo), quindi OpenClaw applica limiti pre-autenticazione rigorosi sul body e un timeout prima della verifica.
• OpenClaw elabora gli eventi Webhook dai byte grezzi verificati della richiesta. I valori req.body trasformati dal middleware a monte vengono ignorati per garantire l'integrità della firma.

Configurare

Configurazione minima:

{  channels: {    line: {      enabled: true,      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",      channelSecret: "LINE_CHANNEL_SECRET",      dmPolicy: "pairing",    },  },}

Configurazione DM pubblica:

{  channels: {    line: {      enabled: true,      channelAccessToken: "LINE_CHANNEL_ACCESS_TOKEN",      channelSecret: "LINE_CHANNEL_SECRET",      dmPolicy: "open",      allowFrom: ["*"],    },  },}

Variabili d'ambiente (solo account predefinito):

• LINE_CHANNEL_ACCESS_TOKEN
• LINE_CHANNEL_SECRET

File di token/segreto:

{  channels: {    line: {      tokenFile: "/path/to/line-token.txt",      secretFile: "/path/to/line-secret.txt",    },  },}

tokenFile e secretFile devono puntare a file regolari. I symlink vengono rifiutati.

Account multipli:

{  channels: {    line: {      accounts: {        marketing: {          channelAccessToken: "...",          channelSecret: "...",          webhookPath: "/line/marketing",        },      },    },  },}

Controllo degli accessi

I messaggi diretti usano per impostazione predefinita l'abbinamento. I mittenti sconosciuti ricevono un codice di abbinamento e i loro messaggi vengono ignorati finché non vengono approvati.

openclaw pairing list lineopenclaw pairing approve line <CODE>

Allowlist e policy:

• channels.line.dmPolicy: pairing | allowlist | open | disabled
• channels.line.allowFrom: ID utente LINE consentiti per i DM; dmPolicy: "open" richiede ["*"]
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: ID utente LINE consentiti per i gruppi
• Override per gruppo: channels.line.groups.<groupId>.allowFrom
• I gruppi di accesso mittente statici possono essere referenziati da allowFrom, groupAllowFrom e da allowFrom per gruppo con accessGroup:<name>.
• Nota di runtime: se channels.line è completamente assente, il runtime ripiega su groupPolicy="allowlist" per i controlli di gruppo (anche se channels.defaults.groupPolicy è impostato).

Gli ID LINE distinguono tra maiuscole e minuscole. Gli ID validi hanno questo aspetto:

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

Comportamento dei messaggi

• Il testo viene suddiviso in blocchi da 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 bufferizzate; LINE riceve blocchi completi con un'animazione di caricamento mentre l'agente lavora.
• I download dei contenuti multimediali sono limitati da channels.line.mediaMaxMb (predefinito 10).
• I contenuti multimediali in ingresso vengono salvati in ~/.openclaw/media/inbound/ prima di essere passati all'agente, in linea con l'archivio multimediale condiviso usato dagli altri Plugin di canale inclusi.

Dati del canale (messaggi avanzati)

Usa channelData.line per inviare risposte rapide, posizioni, schede Flex o messaggi template.

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

Il Plugin LINE include anche un comando /card per preset di messaggi Flex:

/card info "Welcome" "Thanks for joining!"

Supporto ACP

LINE supporta i binding di conversazione ACP (Agent Communication Protocol):

• /acp spawn <agent> --bind here collega la chat LINE corrente a una sessione ACP senza creare un thread figlio.
• I binding ACP configurati e le sessioni ACP attive legate alla conversazione funzionano su LINE come sugli altri canali di conversazione.

Vedi agenti ACP per i dettagli.

Contenuti multimediali in uscita

Il Plugin LINE supporta l'invio di immagini, video e file audio tramite lo strumento messaggi dell'agente. I contenuti multimediali vengono inviati tramite il percorso di recapito specifico di LINE con gestione appropriata di anteprima e tracciamento:

• Immagini: inviate come messaggi immagine LINE con generazione automatica dell'anteprima.
• Video: inviati con gestione esplicita di anteprima e tipo di contenuto.
• Audio: inviati come messaggi audio LINE.

Gli URL dei contenuti multimediali in uscita devono essere URL HTTPS pubblici. OpenClaw convalida l'hostname di destinazione prima di passare l'URL a LINE e rifiuta destinazioni local loopback, link-local e di rete privata.

Gli invii multimediali generici ripiegano sul percorso esistente solo immagini quando non è disponibile un percorso specifico di LINE.

Risoluzione dei problemi

• La verifica del Webhook non riesce: assicurati che l'URL del Webhook sia HTTPS e che il channelSecret corrisponda alla console LINE.
• Nessun evento in ingresso: conferma che il percorso del Webhook corrisponda a channels.line.webhookPath e che il Gateway sia raggiungibile da LINE.
• Errori di download dei contenuti multimediali: aumenta channels.line.mediaMaxMb se il contenuto multimediale supera il limite predefinito.

Correlati

• Panoramica dei canali — tutti i canali supportati
• Abbinamento — autenticazione DM e flusso di abbinamento
• Gruppi — comportamento delle chat di gruppo e gating delle menzioni
• Instradamento dei canali — instradamento delle sessioni per i messaggi
• Sicurezza — modello di accesso e hardening