LINE

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 y el secreto del canal para la autenticación.

Estado: complemento descargable. 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.

Instalar

Instale LINE antes de configurar el canal:

openclaw plugins install @openclaw/line

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

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

Configuración

Cree una cuenta de desarrolladores 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 endpoint 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 reconoce los eventos entrantes firmados (POST) inmediatamente después de la validación de la firma y el payload; el procesamiento del agente continúa de forma asincrónica. Si necesitas una ruta personalizada, establece channels.line.webhookPath o channels.line.accounts.<id>.webhookPath y actualiza 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 y tiempo de espera previos a la autenticación antes de la verificación.
OpenClaw procesa los eventos del webhook a partir de los bytes de la solicitud sin procesar verificada. Los valores req.body transformados por el middleware ascendente se ignoran por seguridad de integridad de la firma.

Configurar

Configuración mínima:

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

Configuración de MD pública:

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

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. Se rechazan los enlaces simbólicos.

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 MD; dmPolicy: "open" requiere ["*"]
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
Los grupos de acceso de remitente estáticos se pueden referenciar desde allowFrom, groupAllowFrom y allowFrom por grupo con accessGroup:<name>.
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á establecido).

Los ID de LINE distinguen mayúsculas y minúsculas. Los ID 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).
Los medios entrantes se guardan en ~/.openclaw/media/inbound/ antes de pasarse al agente, coincidiendo con el almacenamiento de medios compartido que utilizan otros complementos de canal incluidos.

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 ACP

LINE admite enlaces de conversación ACP (Protocolo de Comunicación del Agente):

/acp spawn <agent> --bind here vincula el chat LINE actual a una sesión ACP sin crear un hilo secundario.
Los enlaces ACP configurados y las sesiones 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 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 apropiado de vista previa y seguimiento:

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.

Las URL de medios salientes deben ser URL HTTPS públicas. OpenClaw valida el nombre de host de destino antes de entregar la URL a LINE y rechaza los objetivos de bucle invertido, de enlace local y de red privada.

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

Solución de problemas

La verificación del webhook falla: asegúrese de que la URL del webhook sea HTTPS y que channelSecret coincida con la consola de LINE.
No hay 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: aumente channels.line.mediaMaxMb si los medios exceden el límite predeterminado.

Relacionado

Descripción general de canales — todos los canales compatibles
Emparejamiento — autenticación por MD y flujo de emparejamiento
Grupos — comportamiento del chat grupal y filtrado de menciones
Enrutamiento de canales — enrutamiento de sesiones para mensajes
Seguridad — modelo de acceso y endurecimiento