Openclaw용 ClashX 노드 전환기

Peekaboo를 사용하여 지연 시간을 동적으로 테스트하고 ClashX에서 가장 빠른 미국 proxy 노드로 전환하는 자동화 워크플로우입니다.

shifengwang333-ai
v1.0.0
Jun 24, 2026
0
496
0

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install clashx-node-switcher

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 clashx-node-switcher 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

ClashX 노드 전환기란 무엇인가요?

ClashX 노드 전환기는 macOS proxy 전환을 원활하게 조정하기 위해 설계된 특수 자동화 청사진입니다. Peekaboo GUI 제어 라이브러리를 활용하여 이 스킬은 ClashX 메뉴 막대 애플리케이션과 직접 상호 작용하여 지연 시간 테스트를 수행하고, 네트워크 성능 메타데이터를 파싱하며, 프로그래밍 방식으로 최적의 미국 기반 proxy 노드를 선택합니다. 이 스킬은 Openclaw Skills 생태계 내에서 제공되는 강력한 데스크톱 자동화 기능의 대표적인 예입니다.

수동 메뉴 탐색 및 지연 시간 확인을 자동화함으로써 개발자와 파워 유저는 네트워크 트래픽이 항상 최소 지연 시간 경로를 통해 라우팅되도록 보장할 수 있습니다. 이는 직접적인 API 액세스가 부족한 메뉴 막대 전용 macOS 애플리케이션을 지능형 화면 좌표, 키보드 단축키 및 OCR 지원 시각적 캡처를 사용하여 자동화하는 문제를 해결합니다.

ClashX 노드 전환기 활용 사례

  • 저지연 미국 proxy 연결이 필요한 개발 환경의 자동 최적화.
  • 자동화된 워크플로우 중 성능이 저하된 네트워크 속도나 연결이 끊긴 VPN 노드에서 핸즈프리 복구.
  • 안정적이고 고속인 지역 proxy가 필요한 더 광범위한 다중 에이전트 파이프라인으로의 통합.

ClashX 노드 전환기 작동 원리

  1. 워크플로우는 특정 화면 좌표를 사용하여 macOS 메뉴 막대에서 ClashX 아이콘을 프로그래밍 방식으로 클릭하며 시작합니다.
  2. 애플리케이션에 매핑된 글로벌 키보드 단축키 (Cmd+T)를 활용하여 내장된 ClashX 지연 시간 테스트를 트리거합니다.
  3. 에이전트는 GUI를 모니터링하여 지연 시간 테스트 완료 대화 상자가 나타날 때까지 기다린 후, 리턴 키를 눌러 닫습니다.
  4. 지정된 proxy 그룹(예: '国外流量') 위로 마우스를 가져가 사용 가능한 노드가 포함된 확장된 하위 메뉴를 표시합니다.
  5. 자동 화면 캡처를 수행하여 노드 이름('US', 'USA', '美国' 등과 같은 미국 기반 태그 필터링)과 각각의 지연 시간을 평가하고 파싱합니다.
  6. 워크플로우는 최소 지연 시간을 보이는 대상 미국 노드의 좌표를 정확하게 마우스로 클릭하며 마무리됩니다.

ClashX 노드 전환기 설정 가이드

필수 조건

Peekaboo가 설치되어 있고 macOS 시스템에서 필요한 접근성 권한이 부여되었는지 확인하십시오. ClashX도 메뉴 막대에서 실행 중이어야 합니다.

CLI 구현

다음 Peekaboo 명령을 사용하여 이 워크플로우를 조정할 수 있습니다.

# 1. ClashX 메뉴 열기
peekaboo click --coords 1578,12

# 2. 지연 시간 테스트 트리거
peekaboo hotkey --keys "cmd,t" --app ClashX
sleep 3

# 3. 완료 대화 상자를 닫고 메뉴 다시 열기
peekaboo press return
sleep 0.3
peekaboo click --coords 1578,12

# 4. 하위 메뉴를 표시하기 위해 proxy 그룹 위에 마우스 올리기
peekaboo move 900,65
sleep 0.3
screencapture -x /tmp/clash_nodes.png

디버깅 및 검사

해상도 변경으로 인해 좌표가 이동하는 경우 다음 명령으로 UI 요소를 검사하십시오:

# ClashX 메뉴 막대 항목 위치 찾기
peekaboo menubar list

# 화면의 대화형 요소 검사
peekaboo see --mode screen --screen-index 0

ClashX 노드 전환기 데이터 스키마 및 분류 체계

ClashX 노드 전환기는 물리적 화면 좌표와 임시 파일 저장을 사용하여 인터페이스 상태를 처리하고 분석을 수행합니다. 주요 데이터 매개변수 및 캡처된 자산의 레이아웃은 다음과 같습니다:

매개변수 / 경로 유형 설명
(1578, 12) 좌표 ClashX macOS 메뉴 막대 아이콘의 대상 클릭 위치 (1920x1080 해상도 기준)
Y ~340 오프셋 '延迟测速' (Latency Test) 메뉴 항목의 메뉴 수직 좌표
Y ~65 오프셋 '国外流量' (Overseas Traffic) proxy 그룹의 메뉴 수직 좌표
/tmp/clash_nodes.png 파일 보이는 노드 옵션을 분석하는 데 사용되는 임시 화면 캡처 이미지
/tmp/screen.png 파일 전체 화면 상태를 캡처하는 디버깅 스크린샷

ClashX 노드 전환기 고급 기능

  • 시각적 검증 훅: 로컬 UI 상태를 캡처하기 위해 시스템 수준 화면 캡처 루틴과 통합되어, 중국어 및 영어 노드 이름의 광학 문자 인식(OCR) 파싱을 가능하게 합니다.
  • 헤드리스 복구 로직: 차단된 UI 상태를 지우고 멈춘 대화 상자를 강제로 닫기 위한 시뮬레이션된 키 입력(Escape/Return)과 같은 강력한 오류 처리 경로를 포함합니다.
  • 해상도 독립적 폴백: 정적 좌표 시스템이 드리프트될 경우 프로그래밍 방식으로 애플리케이션 아이콘을 찾기 위해 동적 peekaboo menubar list 쿼리를 사용하도록 설계되었습니다.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*