LINE

ZeroClaw prend en charge LINE via la Messaging API, en recevant les messages par l’intermédiaire d’un serveur webhook intégré et en répondant via la Reply API (avec repli sur la Push API lorsque le jeton de réponse a expiré).

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 line définit channel à line, liste les expéditeurs autorisés dans external_peers (pour line, l’identifiant utilisateur LINE ; ["*"] 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 :

LINE superpose dm_policy et group_policy à l’ensemble des pairs, voir Politiques d’accès ci-dessous. Lorsqu’une politique est définie sur allowlist, l’ensemble des pairs constitue la liste d’autorisation.

Prérequis

1. Un compte LINE Developers Console.
2. Un point de terminaison HTTPS public accessible depuis les serveurs de LINE (ou ngrok pour le développement local).
3. ZeroClaw construit avec le support du canal LINE activé (la fonctionnalité channel-line du crate zeroclaw-channels).

Créer un bot LINE

1. Connectez-vous à la console LINE Developers.
2. Créez un Provider (ou utilisez-en un existant).
3. Créez un nouveau canal Messaging API sous ce Provider.
4. Depuis les paramètres du canal, récupérer deux valeurs :
   • Jeton d’accès au canal : onglet Messaging API → Issue pour émettre un jeton de longue durée.
   • Secret du canal : onglet Paramètres de base.

2. Configurer ZeroClaw

zeroclaw config set channels.line.<alias>.channel_access_token    # entrée masquée, stockée chiffrée

export ZEROCLAW_channels__line__<alias>__channel_access_token=

zeroclaw config set channels.line.<alias>.channel_secret    # entrée masquée, stockée chiffrée

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=

Configurez le canal LINE sous [channels.line.<alias>] avec au minimum channel_access_token et channel_secret. La sémantique côté utilisateur de dm_policy / group_policy est traitée à la §6 ci-dessous.

Utiliser des variables d’environnement au lieu d’un fichier de configuration

Si vous préférez ne pas stocker les informations d’identification dans le fichier de configuration, omettez les champs de jeton et exportez-les en tant que variables d’environnement :

export LINE_CHANNEL_ACCESS_TOKEN="votre-jeton-d'accès-à-la-chaîne"
export LINE_CHANNEL_SECRET="your-channel-secret"

Les variables d’environnement prennent le pas sur les champs de configuration vides.

3. Exposer le point de terminaison Webhook

LINE fournit des messages en POSTant à votre URL webhook. Le serveur intégré écoute sur le webhook_port configuré.

Pour le développement local (ngrok) :

ngrok http 8443

Copiez l’URL https:// fournie par ngrok (par exemple https://abc123.ngrok.io).

Pour la production : exposez le port 8443 (ou le port que vous avez configuré) derrière un proxy inverse HTTPS (nginx, Caddy, etc.) ou déployez directement sur un serveur avec un certificat TLS.

4. Enregistrez le Webhook dans la console LINE Developers.

1. Accédez à votre chaîne → onglet API de messagerie → Paramètres du webhook.
2. Définissez Webhook URL sur https://your-domain.com/line/webhook.
3. Basculez Utiliser un webhook sur on.
4. Cliquez sur Verify, LINE enverra une requête de test. ZeroClaw doit être en cours d’exécution pour que la vérification réussisse.

5. Démarrer ZeroClaw

zeroclaw daemon

Signal de démarrage du journal :LINE: l'écouteur du serveur webhook à l'adresse http://0.0.0.0:8443/line/webhook

6. Politiques d’accès

DM (discussion individuelle) : dm_policy

- workflow d’appariement :

1. ZeroClaw affiche un code d’appariement dans les logs au démarrage.
2. L’utilisateur ouvre un DM LINE avec le bot et envoie /bind <code>.
3. ZeroClaw confirme l’appariement ; les messages directs suivants sont acceptés.

Discussion de groupe / à plusieurs : group_policy

7. Transcription audio / messages vocaux (optionnel)

Lorsque la transcription est activée (via la configuration globale [transcription], voir la Référence de configuration), les événements de message audio de LINE sont automatiquement téléchargés depuis l’API LINE Content et transcrits avant d’être transmis au modèle.

La taille maximale d’un fichier audio est de 25 Mo. Les fichiers plus volumineux sont silencieusement ignorés avec un avertissement de journal.

8. Dépannage

Mots-clés de journal

Voir aussi

• Référence de configuration : index complet des champs de configuration
• Documentation des développeurs LINE