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:
localssh
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_TRANSPORTOPENCLAW_RELAY_HOSTOPENCLAW_RELAY_CWDOPENCLAW_RELAY_ACPX_REPOOPENCLAW_RELAY_GATEWAY_URLOPENCLAW_RELAY_GATEWAY_TOKEN_FILEOPENCLAW_RELAY_SESSIONOPENCLAW_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, luegowaityshow - Quieres detener trabajo encolado:
cancel
Manejo de Fallos
Si falla el trabajo de retransmisión:
- Ejecuta
doctor. - Ejecuta
status. - Ejecuta
show. - Si la sesión de control está atascada, ejecuta
cancel, luegoensure, luego reintenta.
Si el descubrimiento de ruta es incierto:
- Resuelve el destino primero.
- Prefiere alias o clave de sesión exacta.
- 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