LINE

LINE (complemento)

LINE se conecta a OpenClaw a través de la API de mensajería de LINE. El complemento se ejecuta como un receptor de webhook en la puerta de enlace y utiliza su token de acceso al canal + secreto del canal para la autenticación.

Estado: compatible a través del complemento. Se admiten mensajes directos, chats grupales, medios, ubicaciones, mensajes Flex, mensajes de plantilla y respuestas rápidas. Las reacciones y los hilos no son compatibles.

Complemento requerido

Instale el complemento LINE:

openclaw plugins install @openclaw/line

Desprotección local (cuando se ejecuta desde un repositorio de git):

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

Configuración

Cree una cuenta de desarrollador de LINE y abra la Consola: https://developers.line.biz/console/
Cree (o seleccione) un proveedor y añada un canal de API de mensajería.
Copie el token de acceso al canal y el secreto del canal desde la configuración del canal.
Habilite Usar webhook en la configuración de la API de mensajería.
Establezca la URL del webhook en su punto final de puerta de enlace (se requiere HTTPS):

https://gateway-host/line/webhook

La puerta de enlace responde a la verificación del webhook de LINE (GET) y a los eventos entrantes (POST). Si necesita una ruta personalizada, configure channels.line.webhookPath o channels.line.accounts.<id>.webhookPath y actualice la URL en consecuencia.

Nota de seguridad:

La verificación de la firma de LINE depende del cuerpo (HMAC sobre el cuerpo sin procesar), por lo que OpenClaw aplica límites estrictos de cuerpo previo a la autenticación y tiempo de espera antes de la verificación.
OpenClaw procesa eventos de webhook desde los bytes de la solicitud cruda verificados. Los valores req.body transformados por middleware ascendente se ignoran por seguridad de integridad de firma.

Configurar

Configuración mínima:

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

Variables de entorno (solo cuenta predeterminada):

LINE_CHANNEL_ACCESS_TOKEN
LINE_CHANNEL_SECRET

Archivos de token/secreto:

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

tokenFile y secretFile deben apuntar a archivos regulares. Los enlaces simbólicos son rechazados.

Múltiples cuentas:

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

Control de acceso

Los mensajes directos de forma predeterminada requieren emparejamiento. Los remitentes desconocidos reciben un código de emparejamiento y sus mensajes se ignoran hasta que sean aprobados.

openclaw pairing list line
openclaw pairing approve line <CODE>

Listas de permitidos y políticas:

channels.line.dmPolicy: pairing | allowlist | open | disabled
channels.line.allowFrom: IDs de usuario de LINE permitidos para MDs
channels.line.groupPolicy: allowlist | open | disabled
channels.line.groupAllowFrom: IDs de usuario de LINE permitidos para grupos
Anulaciones por grupo: channels.line.groups.<groupId>.allowFrom
Nota de ejecución: si channels.line falta completamente, la ejecución vuelve a groupPolicy="allowlist" para las comprobaciones de grupo (incluso si channels.defaults.groupPolicy está configurado).

Los IDs de LINE distinguen entre mayúsculas y minúsculas. Los IDs válidos tienen el siguiente aspecto:

Usuario: U + 32 caracteres hexadecimales
Grupo: C + 32 caracteres hexadecimales
Sala: R + 32 caracteres hexadecimales

Comportamiento del mensaje

El texto se divide en fragmentos de 5000 caracteres.
El formato Markdown se elimina; los bloques de código y las tablas se convierten en tarjetas Flex cuando es posible.
Las respuestas en streaming se almacenan en búfer; LINE recibe fragmentos completos con una animación de carga mientras el agente trabaja.
Las descargas de medios están limitadas por channels.line.mediaMaxMb (predeterminado 10).

Datos del canal (mensajes enriquecidos)

Use channelData.line para enviar respuestas rápidas, ubicaciones, tarjetas Flex o mensajes de plantilla.

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

El complemento LINE también incluye un comando /card para preajustes de mensajes Flex:

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

Soporte de ACP

LINE admite enlaces de conversación ACP (Protocolo de comunicación de agente):

/acp spawn <agent> --bind here vincula el chat actual de LINE a una sesión ACP sin crear un hilo secundario.
Los enlaces de ACP configurados y las sesiones de ACP activas vinculadas a conversaciones funcionan en LINE como en otros canales de conversación.

Consulte Agentes ACP para obtener más detalles.

Medios salientes

El complemento de LINE admite el envío de imágenes, videos y archivos de audio a través de la herramienta de mensajes del agente. Los medios se envían a través de la ruta de entrega específica de LINE con el manejo de vista previa y seguimiento apropiado:

Imágenes: se envían como mensajes de imagen de LINE con generación automática de vista previa.
Videos: se envían con manejo explícito de vista previa y tipo de contenido.
Audio: se envía como mensajes de audio de LINE.

Los envíos de medios genéricos vuelven a la ruta existente solo para imágenes cuando no hay disponible una ruta específica de LINE.

Solución de problemas

Error en la verificación del webhook: asegúrese de que la URL del webhook sea HTTPS y que channelSecret coincida con la consola de LINE.
Sin eventos entrantes: confirme que la ruta del webhook coincida con channels.line.webhookPath y que la puerta de enlace sea accesible desde LINE.
Errores de descarga de medios: genere channels.line.mediaMaxMb si los medios exceden el límite predeterminado.

Relacionado

Descripción general de canales — todos los canales admitidos
Emparejamiento — flujo de autenticación y emparejamiento DM
Grupos — comportamiento del chat de grupo y filtrado de menciones
Enrutamiento de canales — enrutamiento de sesiones para mensajes
Seguridad — modelo de acceso y fortalecimiento