LINE

​

Instalar

openclaw plugins install @openclaw/line

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

​

Configuración

1. Crea una cuenta de LINE Developers y abre la consola: https://developers.line.biz/console/
2. Crea (o elige) un proveedor y añade un canal de Messaging API.
3. Copia el Channel access token y el Channel secret desde la configuración del canal.
4. Activa Use webhook en la configuración de Messaging API.
5. Establece la URL del Webhook en tu endpoint del Gateway (requiere HTTPS):

https://gateway-host/line/webhook

• La verificación de firma de LINE depende del cuerpo (HMAC sobre el cuerpo sin procesar), por lo que OpenClaw aplica un límite estricto de cuerpo previo a la autenticación (64 KB) y un tiempo de espera de lectura antes de la verificación.
• OpenClaw procesa eventos de Webhook desde los bytes sin procesar verificados de la solicitud. Los valores de req.body transformados por middleware ascendente se ignoran para proteger la integridad de la firma.

​

Configurar

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

​

Control de acceso

openclaw pairing list line
openclaw pairing approve line <CODE>

• channels.line.dmPolicy: pairing | allowlist | open | disabled (predeterminado pairing)
• channels.line.allowFrom: IDs de usuario de LINE permitidos para MD; dmPolicy: "open" requiere ["*"]
• channels.line.groupPolicy: allowlist | open | disabled (predeterminado allowlist)
• channels.line.groupAllowFrom: IDs de usuario de LINE permitidos para grupos
• Sustituciones por grupo: channels.line.groups.<groupId>.allowFrom (más enabled, requireMention, systemPrompt, skills)
• Los grupos estáticos de acceso de remitente pueden referenciarse desde allowFrom, groupAllowFrom y allowFrom por grupo con accessGroup:<name>; consulta Grupos de acceso.
• Nota de runtime: si channels.line falta por completo, el runtime recurre a groupPolicy="allowlist" para las comprobaciones de grupo (incluso si channels.defaults.groupPolicy está establecido).

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

​

Comportamiento de mensajes

• El texto se divide en fragmentos de 5000 caracteres.
• Se elimina el formato Markdown; 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 almacén de medios compartido que usan otros plugins de canal.

​

Datos de canal (mensajes enriquecidos)

{
  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 "Welcome" "Thanks for joining!"

​

Compatibilidad con ACP

• /acp spawn <agent> --bind here vincula el chat actual de LINE a una sesión de ACP sin crear un hilo hijo.
• Las vinculaciones de ACP configuradas y las sesiones de ACP activas vinculadas a conversación funcionan en LINE como en otros canales de conversación.

​

Medios salientes

• Imágenes: se envían como mensajes de imagen de LINE; la imagen de vista previa usa de forma predeterminada la URL del medio.
• Videos: requieren una imagen de vista previa; establece channelData.line.previewImageUrl en una URL de imagen.
• Audio: se envía como mensajes de audio de LINE; la duración predeterminada es de 60 segundos salvo que channelData.line.durationMs esté establecido.

​

Solución de problemas

• Falla la verificación de Webhook: asegúrate de que la URL del Webhook use HTTPS y de que channelSecret coincida con la consola de LINE.
• No hay eventos entrantes: confirma que la ruta del Webhook coincida con channels.line.webhookPath y que LINE pueda acceder al Gateway.
• Errores de descarga de medios: aumenta channels.line.mediaMaxMb si los medios superan el límite predeterminado.

​

Relacionado

• Resumen de canales — todos los canales admitidos
• Emparejamiento — autenticación de MD y flujo de emparejamiento
• Grupos — comportamiento de chat de grupo y control por menciones
• Enrutamiento de canal — enrutamiento de sesión para mensajes
• Seguridad — modelo de acceso y endurecimiento