# Send Agent Device to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "agent-device", "name": "Agent Device", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/okwasniewski/agent-device", "canonicalUrl": "https://clawhub.ai/okwasniewski/agent-device", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/agent-device", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-device", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "references/permissions.md", "references/coordinate-system.md", "references/video-recording.md", "references/logs-and-debug.md", "references/snapshot-refs.md", "references/batching.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "agent-device", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T12:12:19.764Z", "expiresAt": "2026-05-06T12:12:19.764Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-device", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-device", "contentDisposition": "attachment; filename=\"agent-device-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "agent-device" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/agent-device" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/agent-device", "downloadUrl": "https://openagent3.xyz/downloads/agent-device", "agentUrl": "https://openagent3.xyz/skills/agent-device/agent", "manifestUrl": "https://openagent3.xyz/skills/agent-device/agent.json", "briefUrl": "https://openagent3.xyz/skills/agent-device/agent.md" } } ``` ## Documentation ### Mobile Automation with agent-device For exploration, use snapshot refs. For deterministic replay, use selectors. ### Start Here (Read This First) Use this skill as a router, not a full manual. Pick one mode: Normal interaction flow Debug/crash flow Replay maintenance flow Run one canonical flow below. Open references only if blocked. ### Decision Map No target context yet: devices -> pick target -> open. Normal UI task: open -> snapshot -i -> press/fill -> diff snapshot -i -> close Debug/crash: open -> logs clear --restart -> reproduce -> logs path -> targeted grep Replay drift: replay -u -> verify updated selectors ### 1) Normal Interaction Flow agent-device open Settings --platform ios agent-device snapshot -i agent-device press @e3 agent-device diff snapshot -i agent-device fill @e5 "test" agent-device close ### 2) Debug/Crash Flow agent-device open MyApp --platform ios agent-device logs clear --restart agent-device logs path Logging is off by default. Enable only for debugging windows. logs clear --restart requires an active app session (open first). ### 3) Replay Maintenance Flow agent-device replay -u ./session.ad ### Session and navigation agent-device devices agent-device open [app|url] [url] agent-device open [app] --relaunch agent-device close [app] agent-device session list Use boot only as fallback when open cannot find/connect to a ready target. ### Snapshot and targeting agent-device snapshot -i agent-device diff snapshot -i agent-device find "Sign In" click agent-device press @e1 agent-device fill @e2 "text" agent-device is visible 'id="anchor"' press is canonical tap command; click is an alias. ### Utilities agent-device appstate agent-device get text @e1 agent-device screenshot out.png agent-device trace start agent-device trace stop ./trace.log ### Batch (when sequence is already known) agent-device batch --steps-file /tmp/batch-steps.json --json ### Guardrails (High Value Only) Re-snapshot after UI mutations (navigation/modal/list changes). Prefer snapshot -i; scope/depth only when needed. Use refs for discovery, selectors for replay/assertions. Use fill for clear-then-type semantics; use type for focused append typing. iOS appstate is session-scoped; Android appstate is live foreground state. iOS settings helpers are simulator-only; use faceid match|nonmatch|enroll|unenroll. If using --save-script, prefer explicit path syntax (--save-script=flow.ad or ./flow.ad). ### Security and Trust Notes Prefer a preinstalled agent-device binary over on-demand package execution. If install is required, pin an exact version (for example: npx --yes agent-device@ --help). Signing/provisioning environment variables are optional, sensitive, and only for iOS physical-device setup. Logs/artifacts are written under ~/.agent-device; replay scripts write to explicit paths you provide. Keep logging off unless debugging and use least-privilege/isolated environments for autonomous runs. ### Common Mistakes Mixing debug flow into normal runs (keep logs off unless debugging). Continuing to use stale refs after screen transitions. Using URL opens with Android --activity (unsupported combination). Treating boot as default first step instead of fallback. ### References references/snapshot-refs.md references/logs-and-debug.md references/session-management.md references/permissions.md references/video-recording.md references/coordinate-system.md references/batching.md ## Trust - Source: tencent - Verification: Indexed source record - Publisher: okwasniewski - Version: 1.0.1 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-29T12:12:19.764Z - Expires at: 2026-05-06T12:12:19.764Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/agent-device) - [Send to Agent page](https://openagent3.xyz/skills/agent-device/agent) - [JSON manifest](https://openagent3.xyz/skills/agent-device/agent.json) - [Markdown brief](https://openagent3.xyz/skills/agent-device/agent.md) - [Download page](https://openagent3.xyz/downloads/agent-device)