OpenClaw-Relais
Verwenden Sie dies, wenn der Auftrag lautet:
- "Sprich mit Molty"
- "Leite dies an einen OpenClaw-Kanal weiter"
- "Verwende acpx"
- "Sende dies durch das Gateway via acp"
- "Arbeite über eine entfernte OpenClaw-Brücke per SSH"
Ein Skill. Zwei Transporte:
localssh
Standardmäßig local für direkte telefonische Arbeit aus dem aktuellen OpenClaw-Checkout. Verwenden Sie ssh, wenn der Ziel-Agent / die Sitzung auf einem anderen Rechner läuft.
Für Peters Setup lebt Molty normalerweise auf dem Mac Studio Gateway, erreichbar als [email protected]; vermeiden Sie den mac-studio-SSH-Alias für einmalige Relais-Arbeit, da dieser Alias automatisch tmux anhängt.
Skriptpfad: scripts/openclaw_relay.py
Zielaliasmdatei: config/session_aliases.json
Modusauswahl
Wählen Sie local, wenn:
- der Benutzer explizit
acpxsagt - die Zielsitzung auf dem aktuellen Rechner läuft
- das Ziel eine schnelle Weiterleitung oder private Anfrage ist
Wählen Sie ssh, wenn:
- der Ziel-Agent / die Sitzung auf einem anderen Host läuft
- Sie eine persistente Brückensitzung wünschen
- Sie asynchrone Warteschlangen-/Warte-/Anzeigeabläufe auf einem entfernten Rechner benötigen
Standardwerte
Das Skript vermeidet fest codierte persönliche Pfade. Überschreiben Sie bei Bedarf mit Umgebungsvariablen oder Flags.
- Transport:
local - Lokales Repository cwd: aktuelles Arbeitsverzeichnis
- Lokales acpx-Repository:
<cwd>/extensions/acpx - SSH-Host:
[email protected] - Remote-Repository cwd:
<remote-home>/clawdbot - Remote-acpx-Repository:
<remote-home>/Projects/oss/acpx - Gateway-Token-Datei:
<home>/.openclaw/gateway.token - Steuerungssitzungsname:
codex-bridge - Zielaliasmdatei:
config/session_aliases.json
Nützliche Umgebungsvariablen:
OPENCLAW_RELAY_TRANSPORTOPENCLAW_RELAY_HOSTOPENCLAW_RELAY_CWDOPENCLAW_RELAY_ACPX_REPOOPENCLAW_RELAY_GATEWAY_URLOPENCLAW_RELAY_GATEWAY_TOKEN_FILEOPENCLAW_RELAY_SESSIONOPENCLAW_RELAY_TARGETS_FILE
Schnellstart
Gesundheitscheck:
python3 scripts/openclaw_relay.py doctor
Bekannte Zielaliase auflisten:
python3 scripts/openclaw_relay.py targets
Einen Zielalias auflösen:
python3 scripts/openclaw_relay.py resolve --target maintainers
Eine Zielsitzung privat etwas fragen:
python3 scripts/openclaw_relay.py ask \
--target maintainers \
--message "Fasse die aktuelle Stimmung in diesem Kanal zusammen."
Erzwungenes Senden von Text an das aufgelöste Ziel:
python3 scripts/openclaw_relay.py force-send \
--target maintainers \
--text "Das Deployment ist abgeschlossen."
Für mehrzeilige Beiträge verwenden Sie --text-file <pfad> oder --text-file - anstelle von
Shell-Zitierung der Nachricht.
Erzwungenes Senden von Medien, wenn der Benutzer explizit einen Kanalbeitrag wünscht:
python3 scripts/openclaw_relay.py force-send \
--transport ssh \
--host [email protected] \
--target maintainers \
--text "Demo-Video." \
--media /tmp/demo.mp4
Verwenden Sie die persistente Steuerungssitzung:
python3 scripts/openclaw_relay.py ensure
python3 scripts/openclaw_relay.py send --message "Antworte mit genau OK."
python3 scripts/openclaw_relay.py show
Beispiel für entfernten Host:
python3 scripts/openclaw_relay.py doctor --transport ssh --host [email protected]
python3 scripts/openclaw_relay.py send \
--transport ssh \
--host [email protected] \
--message "Antworte mit genau OK."
Asynchroner Workflow
Arbeit einreihen und dieselbe Steuerungssitzung abfragen:
python3 scripts/openclaw_relay.py start --message "Arbeite an X und antworte, wenn fertig."
python3 scripts/openclaw_relay.py wait --after-seq <letzte-seq>
python3 scripts/openclaw_relay.py show
Zielaliase
config/session_aliases.json wird mit Platzhaltern ausgeliefert. Ersetzen Sie sie durch echte Werte für Ihr Setup.
Beispielstruktur:
{
"main": "agent:<agentId>:main",
"maintainers": "agent:<agentId>:discord:channel:<channelId>"
}
Sitzungsregeln
Verwenden Sie diese Regeln bei der Auswahl eines Befehls:
- Möchten Sie eine private Antwort von einer bestimmten Sitzung:
ask - Möchten Sie, dass die Zielsitzung entscheidet, ob sie etwas postet:
publish - Möchten Sie eine garantierte direkte Veröffentlichung:
force-send - Möchten Sie blockierende Kontinuität mit dem Steuerungsgehirn:
send - Möchten Sie Fire-and-Forget-asynchron:
start, dannwaitundshow - Möchten Sie die eingereihte Arbeit abbrechen:
cancel
Fehlerbehandlung
Wenn die Relaisarbeit fehlschlägt:
- Führen Sie
doctoraus. - Führen Sie
statusaus. - Führen Sie
showaus. - Wenn die Steuerungssitzung blockiert ist, führen Sie
cancel, dannensureaus und wiederholen Sie den Vorgang.
Wenn die Routenerkennung unsicher ist:
- Lösen Sie zuerst das Ziel auf.
- Bevorzugen Sie Alias oder exakten Sitzungsschlüssel.
- Verwenden Sie eine kleine Testanfrage, bevor Sie die eigentliche Nutzlast senden.
Ausgaberelais
Geben Sie den tatsächlichen Assistententext oder das Zustellungsergebnis zurück, kein Shell-Rauschen.
Melden Sie für Relaisaufgaben:
- verwendeter Transport
- Zielsitzungsschlüssel
- ob die Routenprüfung/-auflösung erfolgreich war
- endgültig gepostetes oder zurückgegebenes Ergebnis