steipete/openclaw-relay

Retransmisión de sesiones OpenClaw: envía mensajes a través de acpx local o remoto por SSH.

¿Qué es openclaw-relay?

Esta skill permite retransmitir mensajes y comandos a sesiones de OpenClaw, ya sea localmente o a través de SSH a un host remoto. Es útil para desarrolladores que trabajan con agentes de IA o herramientas de línea de comandos como acpx, y necesitan enviar mensajes a canales, agentes o sesiones específicas. Soporta dos modos de transporte: local (para trabajo directo en la misma máquina) y SSH (cuando el agente o sesión objetivo reside en otro equipo). La skill utiliza un script Python (`scripts/openclaw_relay.py`) que ofrece comandos como `ask`, `force-send`, `send` y `start`/`wait` para flujos sincrónicos o asíncronos. También incluye un mecanismo de manejo de fallos con `doctor`, `status` y `cancel`. Los alias de destino se configuran en `config/session_aliases.json`, y se pueden sobreescribir valores por defecto mediante variables de entorno.

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

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

OpenClaw Relay

Usa esto cuando la tarea sea:

  • "hablar con Molty"
  • "retransmitir esto a una sesión de canal OpenClaw"
  • "usar acpx"
  • "enviar esto a través de la puerta de enlace vía acp"
  • "trabajar a través de un puente remoto OpenClaw vía SSH"

Una skill. Dos transportes:

  1. local
  2. ssh

Por defecto usa local para trabajo directo "teléfono descompuesto" desde el checkout actual de OpenClaw. Usa ssh cuando el agente/sesión objetivo esté en otra máquina.

Para la configuración de Peter, Molty normalmente vive en la puerta de enlace Mac Studio, accesible como [email protected]; evita el alias SSH mac-studio para trabajo de retransmisión de un solo disparo porque ese alias adjunta tmux automáticamente.

Ruta del script: scripts/openclaw_relay.py

Archivo de alias de destino: config/session_aliases.json

Selección de Modo

Elige local cuando:

  • el usuario dice explícitamente acpx
  • la sesión objetivo está en la máquina actual
  • el objetivo es una retransmisión rápida o una consulta privada

Elige ssh cuando:

  • el agente/sesión objetivo reside en otro host
  • deseas una sesión de puente persistente
  • necesitas flujos asíncronos de cola/espera/muestra en una máquina remota

Valores por Defecto

El script evita rutas personales fijas. Sobrescribe con variables de entorno o flags cuando sea necesario.

  • transporte: local
  • directorio de trabajo del repo local: directorio de trabajo actual
  • repo local de acpx: <cwd>/extensions/acpx
  • host SSH: [email protected]
  • directorio de trabajo del repo remoto: <remote-home>/clawdbot
  • repo remoto de acpx: <remote-home>/Projects/oss/acpx
  • archivo de token de puerta de enlace: <home>/.openclaw/gateway.token
  • nombre de sesión de control: codex-bridge
  • archivo de alias de destino: config/session_aliases.json

Variables de entorno útiles:

  • 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

Inicio Rápido

Comprobación de estado:

python3 scripts/openclaw_relay.py doctor

Listar alias de destino conocidos:

python3 scripts/openclaw_relay.py targets

Resolver un alias de destino:

python3 scripts/openclaw_relay.py resolve --target maintainers

Preguntar a una sesión objetivo de forma privada:

python3 scripts/openclaw_relay.py ask \
  --target maintainers \
  --message "Resume el ambiente actual en este canal."

Forzar envío de texto al destino resuelto:

python3 scripts/openclaw_relay.py force-send \
  --target maintainers \
  --text "El despliegue está listo."

Para mensajes multilínea, usa --text-file <ruta> o --text-file - en lugar de entrecomillar el mensaje en la shell.

Forzar envío de medios cuando el usuario quiere explícitamente una publicación en el canal:

python3 scripts/openclaw_relay.py force-send \
  --transport ssh \
  --host [email protected] \
  --target maintainers \
  --text "Video de demostración." \
  --media /tmp/demo.mp4

Usar la sesión de control persistente:

python3 scripts/openclaw_relay.py ensure
python3 scripts/openclaw_relay.py send --message "Responde exactamente con OK."
python3 scripts/openclaw_relay.py show

Ejemplo con host remoto:

python3 scripts/openclaw_relay.py doctor --transport ssh --host [email protected]
python3 scripts/openclaw_relay.py send \
  --transport ssh \
  --host [email protected] \
  --message "Responde exactamente con OK."

Flujo Asíncrono

Encola trabajo y consulta la misma sesión de control:

python3 scripts/openclaw_relay.py start --message "Trabaja en X y responde cuando termines."
python3 scripts/openclaw_relay.py wait --after-seq <último-seq>
python3 scripts/openclaw_relay.py show

Alias de Destino

config/session_aliases.json viene con marcadores de posición. Reemplázalos con valores reales para tu configuración.

Ejemplo de estructura:

{
  "main": "agent:<agentId>:main",
  "maintainers": "agent:<agentId>:discord:channel:<channelId>"
}

Reglas de Sesión

Usa estas reglas al elegir un comando:

  • Quieres una respuesta privada de una sesión específica: ask
  • Quieres que la sesión objetivo decida si publicar: publish
  • Quieres una publicación directa garantizada: force-send
  • Quieres continuidad bloqueante con el cerebro de control: send
  • Quieres asíncrono de "dispara y olvida": start, luego wait y show
  • Quieres detener trabajo encolado: cancel

Manejo de Fallos

Si falla el trabajo de retransmisión:

  1. Ejecuta doctor.
  2. Ejecuta status.
  3. Ejecuta show.
  4. Si la sesión de control está atascada, ejecuta cancel, luego ensure, luego reintenta.

Si el descubrimiento de ruta es incierto:

  1. Resuelve el destino primero.
  2. Prefiere alias o clave de sesión exacta.
  3. Usa una pequeña sonda de prueba antes de enviar la carga real.

Salida de Retransmisión

Devuelve el texto real del asistente o el resultado de la entrega, no ruido de la shell.

Para tareas de retransmisión, informa:

  • transporte usado
  • clave de sesión objetivo
  • si la sonda de ruta/resolución tuvo éxito
  • resultado final publicado o devuelto

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 relacionados