OpenClaw Relay
Use esta skill quando a tarefa for:
- "falar com Molty"
- "retransmitir isso para uma sessão de canal OpenClaw"
- "usar acpx"
- "enviar isso através do gateway via acp"
- "trabalhar através de uma ponte OpenClaw remota sobre SSH"
Uma skill. Dois transportes:
localssh
Use como padrão local para trabalho direto de telefone-sem-fio a partir do checkout atual do OpenClaw. Use ssh quando o agente/sessão de destino estiver em outra máquina.
Na configuração de Peter, o Molty normalmente vive no gateway Mac Studio, acessado como [email protected]; evite o alias SSH mac-studio para trabalho de relé único porque esse alias anexa tmux automaticamente.
Caminho do script: scripts/openclaw_relay.py
Arquivo de aliases de destino: config/session_aliases.json
Seleção de Modo
Escolha local quando:
- o usuário disser explicitamente
acpx - a sessão de destino estiver na máquina atual
- o objetivo for retransmissão rápida ou pergunta privada
Escolha ssh quando:
- o agente/sessão de destino estiver em outro host
- você quiser uma sessão de ponte persistente
- você precisar de fluxos assíncronos de fila/espera/exibição em uma máquina remota
Padrões
O script evita caminhos pessoais embutidos. Substitua com env ou flags quando necessário.
- transporte:
local - diretório de trabalho local do repo: diretório de trabalho atual
- repo acpx local:
<cwd>/extensions/acpx - host ssh:
[email protected] - diretório de trabalho remoto do repo:
<remote-home>/clawdbot - repo acpx remoto:
<remote-home>/Projects/oss/acpx - arquivo de token do gateway:
<home>/.openclaw/gateway.token - nome da sessão de controle:
codex-bridge - arquivo de aliases de destino:
config/session_aliases.json
Variáveis de ambiente úteis:
OPENCLAW_RELAY_TRANSPORTOPENCLAW_RELAY_HOSTOPENCLAW_RELAY_CWDOPENCLAW_RELAY_ACPX_REPOOPENCLAW_RELAY_GATEWAY_URLOPENCLAW_RELAY_GATEWAY_TOKEN_FILEOPENCLAW_RELAY_SESSIONOPENCLAW_RELAY_TARGETS_FILE
Início Rápido
Verificação de saúde:
python3 scripts/openclaw_relay.py doctor
Listar aliases de destino conhecidos:
python3 scripts/openclaw_relay.py targets
Resolver um alias de destino:
python3 scripts/openclaw_relay.py resolve --target maintainers
Fazer uma pergunta privada a uma sessão de destino:
python3 scripts/openclaw_relay.py ask \
--target maintainers \
--message "Resuma o clima atual neste canal."
Forçar o envio de texto para o destino resolvido:
python3 scripts/openclaw_relay.py force-send \
--target maintainers \
--text "A implantação foi concluída."
Para postagens com várias linhas, use --text-file <caminho> ou --text-file - em vez de
colocar a mensagem entre aspas no shell.
Forçar envio de mídia quando o usuário explicitamente quiser uma postagem no canal:
python3 scripts/openclaw_relay.py force-send \
--transport ssh \
--host [email protected] \
--target maintainers \
--text "Vídeo de demonstração." \
--media /tmp/demo.mp4
Usar a sessão de controle persistente:
python3 scripts/openclaw_relay.py ensure
python3 scripts/openclaw_relay.py send --message "Responda exatamente com OK."
python3 scripts/openclaw_relay.py show
Exemplo com 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 "Responda exatamente com OK."
Fluxo de Trabalho Assíncrono
Enfileirar trabalho e consultar a mesma sessão de controle:
python3 scripts/openclaw_relay.py start --message "Trabalhe em X e responda quando terminar."
python3 scripts/openclaw_relay.py wait --after-seq <ultimo-seq>
python3 scripts/openclaw_relay.py show
Aliases de Destino
config/session_aliases.json vem com espaços reservados. Substitua-os por valores reais para sua configuração.
Exemplo de formato:
{
"main": "agent:<agentId>:main",
"maintainers": "agent:<agentId>:discord:channel:<channelId>"
}
Regras de Sessão
Use estas regras ao escolher um comando:
- Quer uma resposta privada de uma sessão específica:
ask - Quer que a sessão de destino decida se deve postar:
publish - Quer uma postagem direta garantida:
force-send - Quer continuidade com bloqueio no cérebro de controle:
send - Quer assíncrono do tipo 'disparar e esquecer':
start, depoiswaiteshow - Quer parar o trabalho enfileirado:
cancel
Tratamento de Falhas
Se o trabalho de retransmissão falhar:
- Execute
doctor. - Execute
status. - Execute
show. - Se a sessão de controle estiver travada, execute
cancel, depoisensure, e repita.
Se a descoberta de rota for incerta:
- Resolva o destino primeiro.
- Prefira alias ou chave de sessão exata.
- Use uma pequena pergunta de sonda antes de enviar a carga real.
Retransmissão de Saída
Retorne o texto real do assistente ou o resultado da entrega, não ruído do shell.
Para tarefas de retransmissão, relate:
- transporte usado
- chave da sessão de destino
- se a sonda/resolução de rota foi bem-sucedida
- resultado final postado ou retornado