steipete/openclaw-relay

Relais de session OpenClaw : invite/publication via acpx local ou à distance par SSH.

Qu'est-ce que openclaw-relay ?

La compétence OpenClaw Relay permet à un agent IA (comme Claude Code, Cursor ou Codex) de relayer des messages et des invites vers des sessions OpenClaw, que ce soit en local ou à distance via SSH. Elle s'appuie sur le protocole acpx pour les échanges. L'agent peut ainsi interagir avec d'autres agents (par exemple "Molty") situés sur la même machine ou sur un hôte distant. La compétence choisit automatiquement le transport local ou SSH selon la cible, et propose des modes de publication variés : privé (ask), garanti (force-send), ou asynchrone avec file d'attente (start/wait/show). Elle inclut un fichier d'alias de session (`config/session_aliases.json`) pour simplifier le ciblage, et des variables d'environnement permettent de personnaliser les chemins et la configuration. Un mode diagnostic (`doctor`) facilite le débogage.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/openclaw-relay

Installed? Explore more Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 :

  1. local
  2. ssh

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_TRANSPORT
  • OPENCLAW_RELAY_HOST
  • OPENCLAW_RELAY_CWD
  • OPENCLAW_RELAY_ACPX_REPO
  • OPENCLAW_RELAY_GATEWAY_URL
  • OPENCLAW_RELAY_GATEWAY_TOKEN_FILE
  • OPENCLAW_RELAY_SESSION
  • OPENCLAW_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, puis wait et show
  • Vous voulez arrêter le travail en file d'attente : cancel

Gestion des échecs

Si le relais échoue :

  1. Lancez doctor.
  2. Lancez status.
  3. Lancez show.
  4. Si la session de contrôle est bloquée, lancez cancel, puis ensure, puis réessayez.

Si la découverte de route est incertaine :

  1. Résolvez d'abord la cible.
  2. Préférez l'alias ou la clé de session exacte.
  3. 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é

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Skills associés