Signal

El canal de Signal de ZeroClaw se comunica con un daemon HTTP signal-cli en ejecución. Signal no proporciona una API oficial para bots, por lo que ZeroClaw se conecta a signal-cli a través de HTTP local y deja que signal-cli gestione la cuenta de Signal, las claves del dispositivo y el transporte de mensajes.

Usa este canal cuando ya operas una cuenta de Signal con signal-cli, o cuando puedes ejecutar el daemon junto a ZeroClaw. Si solo tienes instalada la aplicación de escritorio o móvil de Signal, eso no es suficiente por sí solo; ZeroClaw necesita el endpoint del daemon HTTP.

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 signal establece channel en signal, enumera los remitentes permitidos en external_peers (para signal, un número de teléfono E.164 o un identificador de origen de signal-cli; ["*"] 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:

También puedes restringir el tráfico a nivel de canal: dm_only = true ignora los grupos; group_ids = ["<signal-group-id>"] acepta solo los grupos listados sin dejar de aceptar mensajes directos; ignore_attachments e ignore_stories descartan esos tipos de mensajes antes de que lleguen al agente.

Requisitos previos

• Una cuenta de Signal vinculada o registrada en signal-cli.
• Un daemon HTTP signal-cli en ejecución, por ejemplo signal-cli daemon --http 127.0.0.1:8686.
• Una compilación de ZeroClaw con la característica channel-signal habilitada.

Mantén el daemon enlazado a localhost a menos que lo hayas colocado detrás de tu propio límite de red autenticado. El daemon puede enviar y recibir como la cuenta de Signal vinculada.

Configura el canal

zeroclaw config set channels.signal.<alias>.account <value>

export ZEROCLAW_channels__signal__<alias>__account=

zeroclaw config set channels.signal.<alias>.approval_timeout_secs <value>

export ZEROCLAW_channels__signal__<alias>__approval_timeout_secs=

zeroclaw config set channels.signal.<alias>.dm_only <value>

export ZEROCLAW_channels__signal__<alias>__dm_only=

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

export ZEROCLAW_channels__signal__<alias>__excluded_tools=

zeroclaw config set channels.signal.<alias>.group_ids <value>

export ZEROCLAW_channels__signal__<alias>__group_ids=

zeroclaw config set channels.signal.<alias>.http_url <value>

export ZEROCLAW_channels__signal__<alias>__http_url=

zeroclaw config set channels.signal.<alias>.ignore_attachments <value>

export ZEROCLAW_channels__signal__<alias>__ignore_attachments=

zeroclaw config set channels.signal.<alias>.ignore_stories <value>

export ZEROCLAW_channels__signal__<alias>__ignore_stories=

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

export ZEROCLAW_channels__signal__<alias>__proxy_url=

zeroclaw config set channels.signal.<alias>.reply_min_interval_secs <value>

export ZEROCLAW_channels__signal__<alias>__reply_min_interval_secs=

zeroclaw config set channels.signal.<alias>.reply_queue_depth_max <value>

export ZEROCLAW_channels__signal__<alias>__reply_queue_depth_max=

Vincule el canal a un agente mediante la lista channels de ese agente.

Iniciar y comprobar

Primero inicia el daemon, luego inicia los canales de ZeroClaw:

signal-cli daemon --http 127.0.0.1:8686
zeroclaw channel start

Usa zeroclaw channel doctor para confirmar que ZeroClaw puede cargar el canal configurado. Si el canal falla en tiempo de ejecución, comprueba que http_url apunte al daemon, que la cuenta esté registrada en signal-cli y que la compilación incluya channel-signal.

Confusión común

El proyecto signal-cli es conocido principalmente como una CLI, pero ZeroClaw necesita su modo demonio HTTP. Si solo instalaste el binario de línea de comandos y nunca iniciaste el demonio, ZeroClaw no tiene nada a lo que conectarse.