LINE

ZeroClaw es compatible con LINE a través de la Messaging API, recibiendo mensajes mediante un servidor webhook integrado y respondiendo a través de la Reply API (con la Push API como alternativa cuando el token de respuesta ha expirado).

Quién puede hablar con el agente

Los remitentes entrantes se filtran contra el conjunto de pares resuelto para el agente vinculado, obtenido de la configuración peer_groups a la que pertenece el agente. La coincidencia elimina el @ inicial y no distingue mayúsculas de minúsculas frente al identificador nativo de remitente del canal. Un conjunto vacío deniega a todos; un conjunto que contiene "*" acepta a cualquiera; en caso contrario, solo se aceptan los pares externos listados (y los agentes pares). Esto es independiente del emparejamiento de la puerta de enlace (gateway.require_pairing), que autentica clientes HTTP/WebSocket, no remitentes de canales de chat.

Un grupo de pares para line establece channel a line, lista los remitentes permitidos en external_peers (para line, el ID de usuario de LINE; ["*"] acepta a cualquiera), opcionalmente nombra agents pares para el despacho entre agentes, una lista de bloqueo ignore y un output_modality (mirror, voice o text). Consulte Peer Groups para la referencia de campos.

Dónde configurar esto:

LINE aplica dm_policy y group_policy como capas sobre el conjunto de pares, consulta Políticas de Acceso más abajo. Cuando una política está configurada como allowlist, el conjunto de pares es la lista de permitidos.

Requisitos previos

1. Una cuenta de LINE Developers Console.
2. Un punto de conexión HTTPS público accesible desde los servidores de LINE (o ngrok para el desarrollo local).
3. ZeroClaw construido con soporte para canales LINE habilitado (la función channel-line en el crate zeroclaw-channels).

1. Crear un bot de LINE

1. Inicia sesión en la Consola de LINE Developers.
2. Crea un Proveedor (o utiliza uno existente).
3. Crea un nuevo canal de API de Mensajería bajo ese Proveedor.
4. Desde la configuración del canal, recopila dos valores:
   • Channel Access Token: pestaña Messaging API → Issue (emitir) un token de larga duración.
   • Channel Secret: pestaña de Configuración básica.

2. Configurar ZeroClaw

zeroclaw config set channels.line.<alias>.channel_access_token    # entrada enmascarada, almacenada cifrada

export ZEROCLAW_channels__line__<alias>__channel_access_token=

zeroclaw config set channels.line.<alias>.channel_secret    # entrada enmascarada, almacenada cifrada

export ZEROCLAW_channels__line__<alias>__channel_secret=

zeroclaw config set channels.line.<alias>.dm_policy <value>

export ZEROCLAW_channels__line__<alias>__dm_policy=

zeroclaw config set channels.line.<alias>.excluded_tools <value>

export ZEROCLAW_channels__line__<alias>__excluded_tools=

zeroclaw config set channels.line.<alias>.group_policy <value>

export ZEROCLAW_channels__line__<alias>__group_policy=

zeroclaw config set channels.line.<alias>.proxy_url <value>

export ZEROCLAW_channels__line__<alias>__proxy_url=

zeroclaw config set channels.line.<alias>.sender_name <value>

export ZEROCLAW_channels__line__<alias>__sender_name=

zeroclaw config set channels.line.<alias>.webhook_port <value>

export ZEROCLAW_channels__line__<alias>__webhook_port=

Configura el canal de LINE en [channels.line.<alias>] con al menos channel_access_token y channel_secret. La semántica de cara al usuario de dm_policy / group_policy se describe en la §6 a continuación.

Usando variables de entorno en lugar de un archivo de configuración

Si prefieres no almacenar las credenciales en el archivo de configuración, omite los campos del token y expórtalos como variables de entorno:

export LINE_CHANNEL_ACCESS_TOKEN="tu-token-de-acceso-al-canal"
export LINE_CHANNEL_SECRET="tu-secreto-de-canal"

Las variables de entorno tienen prioridad sobre los campos vacíos de la configuración.

3. Exponer el extremo del webhook

LINE envía mensajes publicando en tu URL de webhook. El servidor integrado escucha en el webhook_port configurado.

Para el desarrollo local (ngrok):

ngrok http 8443

Copia la URL https:// que proporciona ngrok (por ejemplo, https://abc123.ngrok.io).

Para producción: expone el puerto 8443 (o el puerto que hayas configurado) detrás de un proxy inverso HTTPS (nginx, Caddy, etc.) o despliega directamente en un servidor con un certificado TLS.

4. Registra el Webhook en la consola de LINE Developers

1. Ve a tu canal → pestaña API de Mensajería → Configuración de Webhook.
2. Establece la URL del webhook en https://your-domain.com/line/webhook.
3. Activa Usar webhook.
4. Haz clic en Verify, LINE enviará una solicitud de prueba. ZeroClaw debe estar en ejecución para que la verificación tenga éxito.

5. Iniciar ZeroClaw

zeroclaw daemon

Señal de registro de inicio:

LINE: el servidor webhook está escuchando en http://0.0.0.0:8443/line/webhook

6. Políticas de acceso

Mensaje directo (chat 1:1): dm_policy

Flujo de trabajo de emparejamiento:

1. ZeroClaw imprime un código de emparejamiento en el registro al inicio.
2. El usuario abre un DM de LINE con el bot y envía /bind <code>.
3. ZeroClaw confirma el emparejamiento; los DMs posteriores son aceptados.

Chat grupal / de varias personas: group_policy

7. Transcripción de mensajes de audio/voz (opcional)

Cuando la transcripción está habilitada (a través de la configuración global [transcription], consulte Config reference), los eventos de mensajes audio de LINE se descargan automáticamente desde la LINE Content API y se transcriben antes de pasarse al modelo.

El tamaño máximo aceptado para el audio es de 25 MB. Los archivos más grandes se omiten silenciosamente con una advertencia en el registro.

8. Solución de problemas

Palabras clave de registro

Ver también

• Referencia de configuración: índice completo de campos de configuración
• Documentación de los desarrolladores de LINE