steipete/openclaw-relay

Retransmissão de sessão OpenClaw: prompts/posts via acpx local/remoto sobre SSH.

O que é openclaw-relay?

Esta skill permite que um agente de IA (como Claude Code ou Cursor) atue como um relé para sessões de canal OpenClaw, enviando perguntas ou postagens diretamente para sessões de agentes locais ou remotas via SSH. Ela é útil para cenários onde você precisa conversar com um agente específico (como 'Molty') que reside em outra máquina, ou para integrar um assistente de IA com um sistema de gateway acpx. A skill suporta dois modos de transporte: 'local', para comunicação direta com sessões na mesma máquina, e 'ssh', para conectar-se a sessões em hosts remotos. O script `openclaw_relay.py` gerencia a descoberta de rotas, envio de mensagens, filas assíncronas e verificação de saúde, lendo configurações de aliases de sessão de um arquivo JSON. O usuário pode definir variáveis de ambiente para personalizar caminhos, host e outras opções. A skill oferece comandos como 'doctor' para verificação, 'ask' para perguntas privadas, 'force-send' para postagens garantidas, e 'start/wait/show' para workflows assíncronos.

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

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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:

  1. local
  2. ssh

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_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

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, depois wait e show
  • Quer parar o trabalho enfileirado: cancel

Tratamento de Falhas

Se o trabalho de retransmissão falhar:

  1. Execute doctor.
  2. Execute status.
  3. Execute show.
  4. Se a sessão de controle estiver travada, execute cancel, depois ensure, e repita.

Se a descoberta de rota for incerta:

  1. Resolva o destino primeiro.
  2. Prefira alias ou chave de sessão exata.
  3. 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

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.

Habilidades Relacionadas