適用於 Openclaw 的 ClashX 節點切換器

一個使用 Peekaboo 動態測試延遲並自動切換至 ClashX 中速度最快的美國 proxy 節點的工作流。

shifengwang333-ai
v1.0.0
Jun 24, 2026
0
473
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. 它觸發內建的 ClashX 延遲測試,利用映射到應用程式的全域鍵盤快速鍵 (Cmd+T)。
  3. 代理監控 GUI,等待延遲測試完成對話框出現,然後通過按下 Enter 鍵將其關閉。
  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) 解析。
  • 無頭恢復邏輯:包含穩健的錯誤處理路徑,例如模擬按鍵 (Escape/Return) 以清除阻塞的 UI 狀態並強制關閉停滯的對話框。
  • 解析度無關的回退方案:旨在利用動態 peekaboo menubar list 查詢,如果靜態座標系統偏移,可以以程式化方式定位應用程式圖示。

SKILL.md


加載中

Openclaw 相關技能

METADATA

Github Stars: 0
forks: 0

精選*