Signal

Le canal Signal de ZeroClaw communique avec un démon HTTP signal-cli en cours d’exécution. Signal ne fournit pas d’API de bot officielle, c’est pourquoi ZeroClaw se connecte à signal-cli via HTTP local et laisse signal-cli gérer le compte Signal, les clés d’appareil et le transport des messages.

Utilisez ce canal lorsque vous exploitez déjà un compte Signal avec signal-cli, ou lorsque vous pouvez exécuter le daemon à côté de ZeroClaw. Si vous avez uniquement installé l’application Signal pour ordinateur ou mobile, cela ne suffit pas en soi ; ZeroClaw a besoin du point de terminaison du daemon HTTP.

Qui peut parler à l’agent

Les expéditeurs entrants sont filtrés par rapport au peer set résolu pour l’agent lié, issu de la configuration peer_groups à laquelle l’agent appartient. La correspondance supprime le @ initial et est insensible à la casse par rapport à l’identifiant d’expéditeur natif du canal. Un ensemble vide refuse tout le monde ; un ensemble contenant "*" accepte n’importe qui ; sinon, seuls les pairs externes listés (et les agents pairs) sont acceptés. Ceci est distinct de l’appairage de la passerelle (gateway.require_pairing), qui authentifie les clients HTTP/WebSocket, et non les expéditeurs des canaux de discussion.

Un groupe de pairs pour signal définit channel à signal, liste les expéditeurs autorisés dans external_peers (pour signal, un numéro de téléphone E.164 ou un identifiant de source signal-cli ; ["*"] accepte tout le monde), nomme éventuellement des agents pairs pour la répartition inter-agents, une liste de blocage ignore, et un output_modality (mirror, voice ou text). Consultez Peer Groups pour la référence des champs.

Où définir ce paramètre :

Vous pouvez également restreindre le trafic au niveau du canal : dm_only = true ignore les groupes ; group_ids = ["<signal-group-id>"] n’accepte que les groupes listés tout en continuant d’accepter les messages directs ; ignore_attachments et ignore_stories rejettent ces types de messages avant qu’ils n’atteignent l’agent.

Prérequis

• Un compte Signal lié ou enregistré dans signal-cli.
• Un démon HTTP signal-cli en cours d’exécution, par exemple signal-cli daemon --http 127.0.0.1:8686.
• Une version de ZeroClaw avec la fonctionnalité channel-signal activée.

Gardez le démon lié à localhost à moins de l’avoir placé derrière votre propre limite réseau authentifiée. Le démon peut envoyer et recevoir en tant que compte Signal lié.

Configurer le 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=

Liez le canal à un agent via la liste channels de cet agent.

Démarrer et vérifier

Démarrez d’abord le daemon, puis démarrez les canaux ZeroClaw :

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

Utilisez zeroclaw channel doctor pour confirmer que ZeroClaw peut charger le canal configuré. Si le canal échoue à l’exécution, vérifiez que http_url pointe vers le démon, que le compte est enregistré dans signal-cli et que la build inclut channel-signal.

Confusion fréquente

Le projet signal-cli est principalement connu comme une CLI, mais ZeroClaw a besoin de son mode démon HTTP. Si vous avez installé uniquement le binaire en ligne de commande sans jamais démarrer le démon, ZeroClaw n’a rien à quoi se connecter.