OpenClaw Relay
Utilisez cette compétence lorsque la tâche est :
- "parler à Molty"
- "relayer ceci dans une session de canal OpenClaw"
- "utiliser acpx"
- "envoyer ceci via la passerelle par acp"
- "travailler via un pont OpenClaw distant par SSH"
Une compétence. Deux transports :
localssh
Par défaut, utilisez local pour un travail direct en téléphone portable à partir de l'extraction OpenClaw actuelle. Utilisez ssh lorsque l'agent/session cible se trouve sur une autre machine.
Pour la configuration de Peter, Molty vit normalement sur la passerelle Mac Studio, accessible via [email protected] ; évitez l'alias SSH mac-studio pour un relais ponctuel car cet alias attache automatiquement tmux.
Chemin du script : scripts/openclaw_relay.py
Fichier d'alias cibles : config/session_aliases.json
Sélection du mode
Choisissez local lorsque :
- l'utilisateur dit explicitement
acpx - la session cible se trouve sur la machine actuelle
- l'objectif est un relais rapide ou une demande privée
Choisissez ssh lorsque :
- l'agent/session cible se trouve sur un autre hôte
- vous voulez une session pont persistante
- vous avez besoin de flux asynchrones (file d'attente, attente, affichage) sur une machine distante
Valeurs par défaut
Le script évite les chemins personnels intégrés. Remplacez-les par des variables d'environnement ou des indicateurs si nécessaire.
- transport :
local - répertoire de travail local du dépôt : répertoire de travail courant
- dépôt acpx local :
<cwd>/extensions/acpx - hôte SSH :
[email protected] - répertoire de travail distant du dépôt :
<remote-home>/clawdbot - dépôt acpx distant :
<remote-home>/Projects/oss/acpx - fichier de jeton de passerelle :
<home>/.openclaw/gateway.token - nom de session de contrôle :
codex-bridge - fichier d'alias cibles :
config/session_aliases.json
Variables d'environnement utiles :
OPENCLAW_RELAY_TRANSPORTOPENCLAW_RELAY_HOSTOPENCLAW_RELAY_CWDOPENCLAW_RELAY_ACPX_REPOOPENCLAW_RELAY_GATEWAY_URLOPENCLAW_RELAY_GATEWAY_TOKEN_FILEOPENCLAW_RELAY_SESSIONOPENCLAW_RELAY_TARGETS_FILE
Démarrage rapide
Vérification de santé :
python3 scripts/openclaw_relay.py doctor
Lister les alias cibles connus :
python3 scripts/openclaw_relay.py targets
Résoudre un alias cible :
python3 scripts/openclaw_relay.py resolve --target maintainers
Poser une question privée à une session cible :
python3 scripts/openclaw_relay.py ask \
--target maintainers \
--message "Résume l'ambiance actuelle dans ce canal."
Forcer l'envoi de texte à la cible résolue :
python3 scripts/openclaw_relay.py force-send \
--target maintainers \
--text "Le déploiement est terminé."
Pour les messages multilignes, utilisez --text-file <chemin> ou --text-file - au lieu de citer le message dans le shell.
Forcer l'envoi de média lorsque l'utilisateur veut explicitement une publication dans un canal :
python3 scripts/openclaw_relay.py force-send \
--transport ssh \
--host [email protected] \
--target maintainers \
--text "Vidéo de démo." \
--media /tmp/demo.mp4
Utiliser la session de contrôle persistante :
python3 scripts/openclaw_relay.py ensure
python3 scripts/openclaw_relay.py send --message "Réponds exactement par OK."
python3 scripts/openclaw_relay.py show
Exemple avec hôte distant :
python3 scripts/openclaw_relay.py doctor --transport ssh --host [email protected]
python3 scripts/openclaw_relay.py send \
--transport ssh \
--host [email protected] \
--message "Réponds exactement par OK."
Flux de travail asynchrone
Mettez en file d'attente et interrogez la même session de contrôle :
python3 scripts/openclaw_relay.py start --message "Travaille sur X et réponds quand c'est fait."
python3 scripts/openclaw_relay.py wait --after-seq <last-seq>
python3 scripts/openclaw_relay.py show
Alias cibles
config/session_aliases.json est livré avec des espaces réservés. Remplacez-les par les vraies valeurs de votre configuration.
Exemple de structure :
{
"main": "agent:<agentId>:main",
"maintainers": "agent:<agentId>:discord:channel:<channelId>"
}
Règles des sessions
Utilisez ces règles pour choisir une commande :
- Vous voulez une réponse privée d'une session spécifique :
ask - Vous voulez que la session cible décide de publier :
publish - Vous voulez une publication directe garantie :
force-send - Vous voulez une continuité bloquante avec le cerveau de contrôle :
send - Vous voulez un asynchrone "oublie et lance" :
start, puiswaitetshow - Vous voulez arrêter le travail en file d'attente :
cancel
Gestion des échecs
Si le relais échoue :
- Lancez
doctor. - Lancez
status. - Lancez
show. - Si la session de contrôle est bloquée, lancez
cancel, puisensure, puis réessayez.
Si la découverte de route est incertaine :
- Résolvez d'abord la cible.
- Préférez l'alias ou la clé de session exacte.
- Utilisez une petite demande de sonde avant d'envoyer la charge utile réelle.
Relais de sortie
Retournez le texte réel de l'assistant ou le résultat de la livraison, pas le bruit du shell.
Pour les tâches de relais, signalez :
- le transport utilisé
- la clé de la session cible
- si la sonde de route / la résolution a réussi
- le résultat final publié ou renvoyé