steipete/openclaw-relay

OpenClaw-Sitzungsrelais: Anfragen/Beiträge via lokales/entferntes acpx über SSH.

Was ist openclaw-relay?

Dieses Skill ermöglicht es KI-Agenten (wie Claude Code, Cursor oder Codex), Nachrichten und Befehle über das OpenClaw-Protokoll (acpx) an andere Agenten oder Kanäle weiterzuleiten – entweder lokal auf demselben Rechner oder per SSH auf einem entfernten Host. Es ist besonders nützlich für Szenarien wie "Sprich mit Molty", die Weiterleitung in einen OpenClaw-Kanal oder die Nutzung einer persistenten Brückensitzung über SSH. Der Skill unterscheidet zwischen zwei Transportmodi (lokal und SSH), unterstützt asynchrone Workflows (starten, warten, anzeigen) und bietet eine umfangreiche Skriptschnittstelle (openclaw_relay.py) mit Befehlen wie 'doctor', 'targets', 'ask', 'force-send' und 'send'. Die Konfiguration erfolgt über eine JSON-Datei für Sitzungsaliase und Umgebungsvariablen, was eine flexible Anpassung an verschiedene Setup-Umgebungen ermöglicht.

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

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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:

  1. local
  2. ssh

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 acpx sagt
  • 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_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

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, dann wait und show
  • Möchten Sie die eingereihte Arbeit abbrechen: cancel

Fehlerbehandlung

Wenn die Relaisarbeit fehlschlägt:

  1. Führen Sie doctor aus.
  2. Führen Sie status aus.
  3. Führen Sie show aus.
  4. Wenn die Steuerungssitzung blockiert ist, führen Sie cancel, dann ensure aus und wiederholen Sie den Vorgang.

Wenn die Routenerkennung unsicher ist:

  1. Lösen Sie zuerst das Ziel auf.
  2. Bevorzugen Sie Alias oder exakten Sitzungsschlüssel.
  3. 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

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.

Verwandte Skills