一款用於與 iOS 與 Android 裝置、模擬器及仿真器互動的多功能行動自動化技能。
安裝與下載
1. ClawHub CLI
從來源直接安裝技能的最快方式。
npx clawhub@latest install agent-device
2. 手動安裝
將技能資料夾複製到以下位置之一
~/.openclaw/skills/ <project>/skills/ 優先級：工作區 > 本地 > 內建
3. 提示詞安裝
將此提示詞複製到 OpenClaw 即可自動安裝。
請幫我使用 Clawhub 安裝 agent-device。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。
想要直接下載？
取得包含原生技能檔案的ZIP壓縮檔。
什麼是 agent-device？
agent-device 是一款先進的自動化工具，旨在彌合 AI 代理與行動環境之間的鴻溝。作為 Openclaw Skills 生態系統的一部分，它能夠與 iOS 與 Android 目標進行無縫互動，支援複雜的 UI 導航、數據選取與狀態管理。無論您是使用實體裝置還是虛擬仿真器，該技能都能提供必要的介面，精確執行點擊、輸入與捲動等操作。
該技能對於需要將行動測試整合到 AI 驅動工作流中的開發人員與 QA 工程師特別有價值。透過利用快照與基於選擇器的定位，agent-device 確保了即使在應用程式介面演進時，互動也能保持確定性與可靠性。它是 Openclaw Skills 函式庫中任何需要深度行動作業系統整合專案的核心組件。
agent-device 應用場景
- 實現 iOS 與 Android 應用程式端到端 UI 測試的自動化。
- 透過擷取日誌與重現程序來調試應用程式崩潰。
- 擷取 UI 資訊與詮釋資料，用於無障礙稽核或數據收集。
- 重播互動腳本，以驗證程式碼變更後的 UI 穩定性。
- 管理裝置狀態，包括應用程式安裝、啟動與工作階段追蹤。
agent-device 運作原理
- 目標識別：該技能使用 devices 指令列出並連接到可用的 iOS 模擬器或 Android 仿真器。
- 工作階段初始化：open 指令在目標裝置上啟動指定的應用程式或 URL。
- UI 探索：獲取快照以分析目前螢幕階層，並透過參考 ID 或選擇器識別元素。
- 互動執行：向裝置發送 press、fill 或 scroll 等指令以模擬使用者行為。
- 驗證與比對：隨後的快照或 appstate 檢查可確認操作是否成功或偵測 UI 變化。
- 清理：關閉工作階段，並儲存任何擷取的日誌或螢幕截圖以供分析。
agent-device 設定指南
要開始使用 Openclaw Skills 套件中的此工具，請確保已安裝必要的行動 SDK（如 Xcode 或 Android Studio）。為保證穩定性，建議使用固定版本。
npx --yes agent-device@latest --help
對於 iOS 開發，如果使用實體裝置，請確保已配置簽署與佈署環境變數。基本用法包括開啟一個工作階段：
agent-device open MyApp --platform ios
agent-device 資料結構與分類體系
agent-device 透過快照、日誌與腳本檔案組織自動化數據，以保持 Openclaw Skills 架構內的一致性。
| 數據類型 | 格式 | 描述 |
|---|---|---|
| 快照 | JSON | 包含元素參考 ID 的 UI 階層樹。 |
| 日誌 | Text/Log | 儲存在 ~/.agent-device 中的系統日誌。 |
| 重播腳本 | .ad | 用於確定性重播的序列化互動步驟。 |
| 螢幕截圖 | PNG | 裝置螢幕狀態的視覺捕捉。 |
| 詮釋資料 | JSON | 包括平台、Bundle ID 與裝置狀態在內的工作階段資訊。 |
agent-device 進階特性
- 互動式快照比對，用於偵測不同應用程式版本間的 UI 偏差。
- 透過 replay -u 指令維護確定性重播，用於更新選擇器。
- 整合日誌清理與定向 grep 功能的底層系統調試。
- 支援從 JSON 檔案執行複雜互動程序的批次執行模式。
- 支援在 iOS 模擬器上進行生物識別模擬（FaceID）。
- 追蹤記錄功能，用於自動化流程的詳細事後分析。
SKILL.md
加載中
Openclaw 相關技能
React Native Logs CLI
一個輕量級的 CLI 工具，透過 CDP 讀取 React Native Metro 日誌，旨在與 Openclaw Skills 無縫整合。
Clawland
Clawland 允許 AI 智能體透過將 SOL 或 USDC 鑄造成 GEM 代幣，在 Solana devnet 上進行鏈上奇偶遊戲。
精選*
