adb-controller

adb-controller 技能提供了一個透過 Android Debug Bridge (ADB) 與 Android 裝置互動的介面。它專為開發人員、品質測試人員及自動化愛好者設計，旨在橋接 AI 代理推理與移動裝置執行之間的差距。透過基於腳本的架構，代理可以將自然語言指令轉換為精確的 shell 操作，從而實現對實體或模擬裝置的免手動控制。

• 執行 shell 指令，例如 input tap（點擊）、swipe（滑動）、keyevent（按鍵事件）及文字輸入。

• 為每個動作自動進行截圖，使代理能夠進行視覺驗證。

• 與 openclaw.json 無縫整合，方便進行個別裝置或伺服器的連接設定。

• 支援標準 ADB 協定，確保與任何已連接的裝置或網路可訪問的 ADB 伺服器相容。

• 具備回饋迴圈設計，視覺輸出會直接傳送回對話介面。

• 使用者必須在 openclaw.json 設定檔中配置 adbServer（裝置序列號或 IP:port）。

• 此技能依賴 exec 工具來執行 python 腳本；請確保環境具有適當的 ADB 權限，且裝置已透過 USB 偵錯進行授權。

• 最適合用於涉及 UI 導航、自動化測試或在 Android 上執行重複性手勢的任務。

• 始終確保裝置處於螢幕開啟且已解鎖的狀態，如果裝置需要憑證輸入或受限於系統級輸入限制，ADB 指令可能會失敗。

• 視覺輸出對代理來說至關重要；請確保代理使用帶有 media 參數的 message 工具，以正確顯示結果截圖。