Community생산성 & 협업github.com

steipete/openclaw-relay

OpenClaw 세션 릴레이: 로컬/원격 acpx를 통해 SSH로 프롬프트/포스트를 전송합니다.

openclaw-relay란 무엇인가요?

이 스킬은 AI 에이전트가 OpenClaw 세션 릴레이를 수행할 수 있게 해줍니다. 'acpx' 도구를 통해 로컬 또는 원격 SSH 연결로 프롬프트, 포스트, 미디어를 전송할 수 있어, 분산된 에이전트 환경에서의 협업과 통신을 지원합니다. 주로 Claude Code나 유사한 터미널 기반 AI 에이전트와 함께 사용되며, 사용자는 대상 세션 별칭을 설정하여 특정 채널이나 에이전트와 직접 대화할 수 있습니다. 이 스킬은 `scripts/openclaw_relay.py` 파이썬 스크립트를 통해 작동하며, `ask`, `force-send`, `send`, `start`, `wait`, `cancel` 등의 명령어를 제공합니다. 비동기 워크플로우, 헬스 체크(`doctor`), 대상 별칭 관리(`targets`, `resolve`) 등 고급 기능도 포함되어 있어, 복잡한 릴레이 작업을 체계적으로 처리할 수 있습니다.

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

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

OpenClaw Relay

다음과 같은 작업에 사용하세요:

  • "Molty와 대화"
  • "이 내용을 OpenClaw 채널 세션에 릴레이"
  • "acpx 사용"
  • "acp를 통해 게이트웨이로 전송"
  • "SSH를 통해 원격 OpenClaw 브리지 작업"

하나의 스킬, 두 가지 전송 방식:

  1. local
  2. ssh

현재 OpenClaw 체크아웃에서 직접적인 전화 게임 작업을 하려면 local을 기본값으로 사용하세요. 대상 에이전트/세션이 다른 머신에 있을 때는 ssh를 사용하세요.

Peter의 설정에서 Molty는 일반적으로 Mac Studio 게이트웨이에 있으며, [email protected]로 접속됩니다. 일회성 릴레이 작업에는 mac-studio SSH 별칭을 사용하지 마세요. 해당 별칭은 tmux를 자동으로 연결합니다.

스크립트 경로: scripts/openclaw_relay.py

대상 별칭 파일: config/session_aliases.json

모드 선택

다음과 같은 경우 local을 선택하세요:

  • 사용자가 명시적으로 acpx를 언급한 경우
  • 대상 세션이 현재 머신에 있는 경우
  • 빠른 릴레이 또는 개인 질문이 목적인 경우

다음과 같은 경우 ssh를 선택하세요:

  • 대상 에이전트/세션이 다른 호스트에 있는 경우
  • 영구적인 브리지 세션을 원하는 경우
  • 원격 머신에서 비동기 큐/대기/표시 흐름이 필요한 경우

기본값

스크립트는 개인 경로를 하드코딩하지 않습니다. 필요 시 환경 변수나 플래그로 재정의하세요.

  • transport: local
  • local repo cwd: 현재 작업 디렉토리
  • local acpx repo: <cwd>/extensions/acpx
  • ssh host: [email protected]
  • remote repo cwd: <remote-home>/clawdbot
  • remote acpx repo: <remote-home>/Projects/oss/acpx
  • gateway token file: <home>/.openclaw/gateway.token
  • control session name: codex-bridge
  • target aliases file: config/session_aliases.json

유용한 환경 변수:

  • 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

빠른 시작

헬스 체크:

python3 scripts/openclaw_relay.py doctor

알려진 대상 별칭 목록 보기:

python3 scripts/openclaw_relay.py targets

대상 별칭 확인:

python3 scripts/openclaw_relay.py resolve --target maintainers

대상 세션에 비공개로 질문하기:

python3 scripts/openclaw_relay.py ask \
  --target maintainers \
  --message "이 채널의 현재 분위기를 요약해 주세요."

확인된 대상에 텍스트 강제 전송:

python3 scripts/openclaw_relay.py force-send \
  --target maintainers \
  --text "배포가 완료되었습니다."

여러 줄의 포스트는 셸 인용 대신 --text-file <path> 또는 --text-file -을 사용하세요.

사용자가 명시적으로 채널 포스트를 원할 때 미디어 강제 전송:

python3 scripts/openclaw_relay.py force-send \
  --transport ssh \
  --host [email protected] \
  --target maintainers \
  --text "데모 비디오." \
  --media /tmp/demo.mp4

영구적인 제어 세션 사용:

python3 scripts/openclaw_relay.py ensure
python3 scripts/openclaw_relay.py send --message "정확히 OK라고 답변하세요."
python3 scripts/openclaw_relay.py show

원격 호스트 예시:

python3 scripts/openclaw_relay.py doctor --transport ssh --host [email protected]
python3 scripts/openclaw_relay.py send \
  --transport ssh \
  --host [email protected] \
  --message "정확히 OK라고 답변하세요."

비동기 워크플로우

작업을 큐에 넣고 동일한 제어 세션을 폴링:

python3 scripts/openclaw_relay.py start --message "X 작업을 수행하고 완료되면 답변하세요."
python3 scripts/openclaw_relay.py wait --after-seq <마지막-시퀀스>
python3 scripts/openclaw_relay.py show

대상 별칭

config/session_aliases.json 파일은 기본값으로 제공됩니다. 실제 값으로 교체하여 사용하세요.

예시 형태:

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

세션 규칙

명령어 선택 시 다음 규칙을 사용하세요:

  • 특정 세션에서 비공개 답변을 원할 때: ask
  • 대상 세션이 게시 여부를 결정하도록 할 때: publish
  • 보장된 직접 게시를 원할 때: force-send
  • 제어 뇌와의 차단 연속성(blocking continuity)을 원할 때: send
  • 발사 후 망각(fire-and-forget) 비동기 작업을 원할 때: start, 이후 wait 및 show
  • 큐에 넣은 작업을 중지하려면: cancel

오류 처리

릴레이 작업이 실패한 경우:

  1. doctor 실행.
  2. status 실행.
  3. show 실행.
  4. 제어 세션이 막혔으면 cancel 실행 후 ensure, 그리고 재시도.

경로 검색이 불확실한 경우:

  1. 먼저 대상을 확인(resolve)하세요.
  2. 별칭 또는 정확한 세션 키를 선호하세요.
  3. 실제 페이로드를 보내기 전에 작은 프로브 질문을 사용하세요.

출력 릴레이

셸 잡음 대신 실제 어시스턴트 텍스트 또는 전달 결과를 반환하세요.

릴레이 작업의 경우 다음을 보고하세요:

  • 사용된 전송 방식(transport)
  • 대상 세션 키
  • 경로 프로브/확인 성공 여부
  • 최종 게시 또는 반환된 결과

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.

관련 스킬