OpenClaw Relay
다음과 같은 작업에 사용하세요:
- "Molty와 대화"
- "이 내용을 OpenClaw 채널 세션에 릴레이"
- "acpx 사용"
- "acp를 통해 게이트웨이로 전송"
- "SSH를 통해 원격 OpenClaw 브리지 작업"
하나의 스킬, 두 가지 전송 방식:
localssh
현재 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_TRANSPORTOPENCLAW_RELAY_HOSTOPENCLAW_RELAY_CWDOPENCLAW_RELAY_ACPX_REPOOPENCLAW_RELAY_GATEWAY_URLOPENCLAW_RELAY_GATEWAY_TOKEN_FILEOPENCLAW_RELAY_SESSIONOPENCLAW_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
오류 처리
릴레이 작업이 실패한 경우:
doctor실행.status실행.show실행.- 제어 세션이 막혔으면
cancel실행 후ensure, 그리고 재시도.
경로 검색이 불확실한 경우:
- 먼저 대상을 확인(
resolve)하세요. - 별칭 또는 정확한 세션 키를 선호하세요.
- 실제 페이로드를 보내기 전에 작은 프로브 질문을 사용하세요.
출력 릴레이
셸 잡음 대신 실제 어시스턴트 텍스트 또는 전달 결과를 반환하세요.
릴레이 작업의 경우 다음을 보고하세요:
- 사용된 전송 방식(transport)
- 대상 세션 키
- 경로 프로브/확인 성공 여부
- 최종 게시 또는 반환된 결과