LINE (plugin)

LINE se conecta a OpenClaw a través de la LINE Messaging API. El plugin funciona como un receptor de webhook en el gateway y usa tu token de acceso del canal + secreto del canal para la autenticación.

Estado: compatible vía plugin. Mensajes directos, chats grupales, multimedia, ubicaciones, mensajes Flex, mensajes de plantilla y respuestas rápidas son compatibles. Reacciones e hilos no son compatibles.

Plugin requerido

Instala el plugin de LINE:

openclaw plugins install @openclaw/line

Checkout local (cuando se ejecuta desde un repositorio git):

openclaw plugins install ./extensions/line

Configuración

1. Crea una cuenta de LINE Developers y abre la Consola: https://developers.line.biz/console/
2. Crea (o selecciona) un Proveedor y añade un canal de Messaging API.
3. Copia el Token de acceso del canal y el Secreto del canal desde la configuración del canal.
4. Habilita Usar webhook en la configuración de Messaging API.
5. Establece la URL del webhook a tu endpoint del gateway (se requiere HTTPS):

https://gateway-host/line/webhook

El gateway responde a la verificación de webhook de LINE (GET) y a los eventos entrantes (POST). Si necesitas una ruta personalizada, configura channels.line.webhookPath o channels.line.accounts.<id>.webhookPath y actualiza la URL en consecuencia.

Nota de seguridad:

• La verificación de firma de LINE depende del cuerpo (HMAC sobre el cuerpo crudo), por lo que OpenClaw aplica límites estrictos de pre-autenticación del cuerpo y timeout antes de la verificación.

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 symlinks se rechazan.

Múltiples cuentas:

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

Control de acceso

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

openclaw pairing list line
openclaw pairing approve line <CODE>

Listas de acceso y políticas:

• channels.line.dmPolicy: pairing | allowlist | open | disabled
• channels.line.allowFrom: IDs de usuario LINE permitidos para DMs
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: IDs de usuario LINE permitidos para grupos
• Anulaciones por grupo: channels.line.groups.<groupId>.allowFrom
• Nota de ejecución: si channels.line no existe en absoluto, el runtime recurre a groupPolicy="allowlist" para verificaciones de grupo (incluso si channels.defaults.groupPolicy está configurado).

Los IDs de LINE distinguen mayúsculas y minúsculas. Los IDs válidos se ven así:

• Usuario: U + 32 caracteres hex
• Grupo: C + 32 caracteres hex
• Sala: R + 32 caracteres hex

Comportamiento de mensajes

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

Datos del canal (mensajes enriquecidos)

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

{
  text: "Aquí tienes",
  channelData: {
    line: {
      quickReplies: ["Estado", "Ayuda"],
      location: {
        title: "Oficina",
        address: "Calle Principal 123",
        latitude: 35.681236,
        longitude: 139.767125,
      },
      flexMessage: {
        altText: "Tarjeta de estado",
        contents: {
          /* Payload Flex */
        },
      },
      templateMessage: {
        type: "confirm",
        text: "¿Continuar?",
        confirmLabel: "Sí",
        confirmData: "yes",
        cancelLabel: "No",
        cancelData: "no",
      },
    },
  },
}

El plugin de LINE también incluye un comando /card para presets de mensajes Flex:

/card info "Bienvenida" "¡Gracias por unirte!"

Resolución de problemas

• La verificación del webhook falla: asegúrate de que la URL del webhook sea HTTPS y que el channelSecret coincida con la consola de LINE.
• No hay eventos entrantes: confirma que la ruta del webhook coincide con channels.line.webhookPath y que el gateway es accesible desde LINE.
• Errores de descarga de multimedia: aumenta channels.line.mediaMaxMb si el multimedia excede el límite predeterminado.