LÍNEA

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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 agrega 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 en el endpoint de tu Gateway (se 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 límites estrictos de cuerpo previos a la autenticación y tiempo de espera antes de la verificación.
• OpenClaw procesa los eventos de Webhook desde los bytes sin procesar verificados de la solicitud. Los valores req.body transformados por middleware ascendente se ignoran por seguridad de integridad de 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
• channels.line.allowFrom: IDs de usuario de LINE permitidos para DM; dmPolicy: "open" requiere ["*"]
• channels.line.groupPolicy: allowlist | open | disabled
• channels.line.groupAllowFrom: IDs de usuario de LINE permitidos para grupos
• Overrides por grupo: channels.line.groups.<groupId>.allowFrom
• Se puede hacer referencia a grupos estáticos de acceso de remitentes desde allowFrom, groupAllowFrom y allowFrom por grupo con accessGroup:<name>.
• Nota de tiempo de ejecución: si channels.line falta por completo, el tiempo de ejecución recurre a groupPolicy="allowlist" para las comprobaciones de grupo (aunque channels.defaults.groupPolicy esté establecido).

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

​

Comportamiento de los 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 incluidos.

​

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 enlaza el chat actual de LINE a una sesión de ACP sin crear un hilo secundario.
• Los enlaces de ACP configurados y las sesiones de ACP activas enlazadas a conversaciones funcionan en LINE como en otros canales de conversación.

​

Medios salientes

• 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ían como mensajes de audio de LINE.

​

Solución de problemas

• La verificación del Webhook falla: asegúrate de que la URL del Webhook use HTTPS y 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 alcanzar el Gateway.
• Errores de descarga de medios: aumenta channels.line.mediaMaxMb si los medios superan el límite predeterminado.

​

Relacionado

• Descripción general de canales — todos los canales admitidos
• Pairing — autenticación de DM y flujo de pairing
• Grupos — comportamiento de chat grupal y control de menciones
• Enrutamiento de canales — enrutamiento de sesiones para mensajes
• Seguridad — modelo de acceso y hardening