{"id":"a8e56549-b63f-41e4-8829-7309afd85336","entityType":"agent","slug":"clawhub-crazytigerman-agent-android","name":"agent-android","canonicalUrl":"https://www.xpersona.co/agent/clawhub-crazytigerman-agent-android","canonicalPath":"/agent/clawhub-crazytigerman-agent-android","generatedAt":"2026-10-11T11:22:42.557Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T09:19:56.618Z","emptyReason":null},"description":"agent-android for AI agents","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s1715h06na20d964bkr1mcyrz184z5pg:agent-android","sourceUrl":"https://clawhub.ai/crazytigerman/agent-android","homepage":"https://clawhub.ai/crazytigerman/skills/agent-android","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/crazytigerman/agent-android","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/crazytigerman/skills/agent-android","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"agent-android technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T09:19:56.618Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T09:19:56.618Z","emptyReason":null},"stars":null,"forks":null,"downloads":1102,"packageName":null,"latestVersion":"0.1.6","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T09:19:56.604Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T09:19:56.618Z","lastCrawledAt":"2026-10-11T09:19:56.604Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T09:19:56.604Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.6","createdAt":"2026-04-16T04:58:01.598Z","changelog":"Shorten the ClawHub summary to highlight LAN Android control without USB, ADB, or root.","fileCount":5,"zipByteSize":5686},{"version":"0.1.5","createdAt":"2026-04-16T04:42:36.230Z","changelog":"Clarify how to install the agent-android CLI when it is missing.","fileCount":4,"zipByteSize":4538},{"version":"0.1.4","createdAt":"2026-04-16T04:39:12.681Z","changelog":"Replace fenced code blocks with inline command lists for ClawHub readability.","fileCount":4,"zipByteSize":4494},{"version":"0.1.3","createdAt":"2026-04-16T04:29:48.386Z","changelog":"Declare OpenClaw runtime metadata and reduce install/persistence warning signals.","fileCount":4,"zipByteSize":4519},{"version":"0.1.2","createdAt":"2026-04-16T04:18:58.187Z","changelog":"Remove platform-specific skill install instructions and add runtime safety boundaries.","fileCount":4,"zipByteSize":4483},{"version":"0.1.1","createdAt":"2026-04-16T04:02:37.077Z","changelog":"Initial public OpenClaw skill for AIVane Android REPL.","fileCount":4,"zipByteSize":4331}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1715h06na20d964bkr1mcyrz184z5pg:agent-android","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s1715h06na20d964bkr1mcyrz184z5pg:agent-android` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/crazytigerman/agent-android before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-crazytigerman-agent-android/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-crazytigerman-agent-android/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-crazytigerman-agent-android/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-crazytigerman-agent-android/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-crazytigerman-agent-android/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-crazytigerman-agent-android/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T11:22:42.556Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-crazytigerman-agent-android/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-crazytigerman-agent-android/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-crazytigerman-agent-android/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-crazytigerman-agent-android/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T09:19:56.618Z","emptyReason":null},"readme":"Skill: agent-android\n\nOwner: crazytigerman\n\nSummary: agent-android for AI agents\n\nTags: aivane:0.1.6, aivane-agent:0.1.6, android:0.1.6, automation:0.1.6, latest:0.1.6\n\nVersion history:\n\nv0.1.6 | 2026-04-16T04:58:01.598Z | user\n\nShorten the ClawHub summary to highlight LAN Android control without USB, ADB, or root.\n\nv0.1.5 | 2026-04-16T04:42:36.230Z | user\n\nClarify how to install the agent-android CLI when it is missing.\n\nv0.1.4 | 2026-04-16T04:39:12.681Z | user\n\nReplace fenced code blocks with inline command lists for ClawHub readability.\n\nv0.1.3 | 2026-04-16T04:29:48.386Z | user\n\nDeclare OpenClaw runtime metadata and reduce install/persistence warning signals.\n\nv0.1.2 | 2026-04-16T04:18:58.187Z | user\n\nRemove platform-specific skill install instructions and add runtime safety boundaries.\n\nv0.1.1 | 2026-04-16T04:02:37.077Z | user\n\nInitial public OpenClaw skill for AIVane Android REPL.\n\nArchive index:\n\nArchive v0.1.6: 5 files, 5686 bytes\n\nFiles: agents/openai.yaml (283b), references/smoke-flow.md (803b), skill-card.md (2546b), SKILL.md (8106b), _meta.json (132b)\n\nFile v0.1.6:SKILL.md\n\n---\r\nname: agent-android\ndescription: Control Android over LAN without USB, ADB, or root.\nmetadata: {\"openclaw\":{\"homepage\":\"https://github.com/aivanelabs/ai-rpa\",\"requires\":{\"bins\":[\"agent-android\"]},\"install\":[{\"id\":\"agent-android-uv\",\"kind\":\"uv\",\"package\":\"aivane-agent-android\",\"bins\":[\"agent-android\"],\"label\":\"Install agent-android CLI (uv)\"}]}}\n---\n\r\n# Android REPL\r\n\r\nUse this skill to drive an Android device through the public `agent-android` beta surface published in the `aivanelabs/ai-rpa` repo.\n\nRuntime prerequisites:\n\n- `agent-android` is available on `PATH`\n- if it is missing, install the CLI with `uv tool install aivane-agent-android`; then run `uv tool update-shell` if the command is still not found\n- the user has provided a trusted device URL such as `http://:8080`\n\r\nThe public path is local-first:\r\n\r\n- the phone hosts the lightweight HTTP service locally\r\n- the desktop connects directly to `http://:8080`\r\n- UI reads, taps, inputs, and screenshots stay on the phone and controlling machine\r\n- the current tradeoff is LAN-only control; an optional server-side or relay path may arrive later\r\n\r\nIf an `agent-android` command suddenly stops working, first check whether the AIVane app or its local API service has exited on the phone.\n\n## Safety Boundaries\n\n- Connect only to a device URL explicitly provided by the user.\n- Do not scan local networks or guess device IP addresses.\n- Treat UI trees and screenshots as sensitive because they may contain private app content.\n- Save screenshots or raw UI dumps only when the user explicitly asks for a file output.\n- Ask for confirmation before operating sensitive apps, private content, account settings, or irreversible actions.\n- Do not expose the phone-side service on a public network.\n\n## Core Workflow\n\r\nEvery Android control task should follow the same short loop:\r\n\r\n1. Confirm connectivity with `/health`\r\n2. Discover the target app with `apps` if needed\r\n3. Launch one app\r\n4. Inspect the current UI tree\r\n5. Perform one action\r\n6. Inspect again\r\n\r\nKeep the loop short. Prefer inspect -> act -> inspect over long speculative command chains.\r\n\r\n## Quick Start\r\n\r\nStart the REPL with the user-provided device URL:\n\n- `agent-android --repl --url http://:8080`\n\nBuilt-in help:\n\n- `agent-android --help`\n- In the REPL: `h`\n\r\n## Essential CLI Commands\r\n\r\nUse the one-off CLI when you already know the exact action you want.\r\n\r\nConnectivity:\n\n- `agent-android --health --url http://:8080`\n\nDiscovery:\n\n- `agent-android --apps --url http://:8080`\n- `agent-android --list --url http://:8080`\n- `agent-android --id com.example:id/search --url http://:8080`\n- `agent-android --text Search --url http://:8080`\n- `agent-android --inputs --url http://:8080`\n- `agent-android --refId 7 --url http://:8080`\n- `agent-android --xpath 7 --url http://:8080`\n- `agent-android --get-attr 7 text --url http://:8080`\n\nActions:\n\n- `agent-android --launch com.xingin.xhs --url http://:8080`\n- `agent-android --tap 7 --url http://:8080`\n- `agent-android --input 7 \"hello world\" --url http://:8080`\n- `agent-android --swipe up --url http://:8080`\n- `agent-android --back --url http://:8080`\n- `agent-android --press home --url http://:8080`\n- `agent-android --screenshot --url http://:8080`\n\nWaiting and output:\n\n- `agent-android --wait-for Search --timeout 30 --url http://:8080`\n- `agent-android --list --raw --url http://:8080`\n\r\n## REPL Command Reference\r\n\r\nUse the REPL for exploratory tasks and smoke runs. Short aliases and long names both work.\r\n\r\n### Browse\r\n\r\n- `health` or `hl`\r\n Check `/health`.\r\n- `l [n]` or `list [n]`\r\n List the first `n` elements, or all cached elements when `n` is omitted.\r\n- `ss` or `snapshot`\r\n Force-refresh the UI tree and print it again.\r\n- `f ` or `find `\r\n Filter by text or content description.\r\n- `id `\r\n Filter by Android resource ID.\r\n- `ref `\r\n Show the full element detail for one refId.\r\n- `x ` or `xpath `\r\n Generate XPath candidates and validate their runtime match counts.\r\n- `xx `\r\n Tap by the best unique generated XPath candidate. Refuses ambiguous matches.\r\n- `vx [idx]` or `validatex [idx]`\r\n Validate one XPath against the runtime. Optionally inspect one match by zero-based index.\r\n\r\n### Interact\r\n\r\n- `t ` or `tap `\r\n Tap the element center point from the current tree.\r\n- `tx ` or `tapx `\r\n Tap one runtime-resolved XPath target.\r\n- `i ` or `input `\r\n Input text into a refId target.\r\n Use `--clear` or `\"\"` to clear instead of typing.\r\n- `ix ` or `inputx `\r\n Input text into one XPath target.\r\n Use `ix --` or `--clear` to clear the field.\r\n- `sw [--dur N] [--dist N]` or `swipe ...`\r\n Swipe down/up/left/right with optional duration and distance.\r\n- `p ` or `press ...`\n Press a system key.\n- `b` or `back`\r\n Press Back.\r\n- `la ` or `launch `\r\n Launch an app by package name.\r\n- `s [path]` or `screenshot [path]`\r\n Capture a screenshot to an auto-generated or explicit path.\r\n\r\n### Wait And Inspect\r\n\r\n- `wf [--t N]` or `waitfor ...`\r\n Wait for an element to appear.\r\n- `g ` or `get `\r\n Read an attribute such as `text`, `class`, `bounds`, `x`, `y`, or `xpath`.\r\n- `apps`\r\n List launcher apps from `/apps`.\r\n\r\n### Session\r\n\r\n- `raw`\r\n Toggle raw JSON mode.\r\n- `vars`\n Show current URL, timeout, raw mode, and tree cache state.\n- `set timeout 30`\n Set the default wait timeout in seconds.\n- `h` or `help`\r\n Show the built-in help text.\r\n- `q` or `quit`\r\n Exit the REPL.\r\n\r\n## Common Patterns\r\n\r\n### First smoke flow\r\n\r\n1. Start the REPL with `agent-android --repl --url http://:8080`.\n2. `health`\n3. `apps`\n4. `la `\n5. `l`\n6. `t `\n7. `i hello`\n8. `b`\n9. `s`\n\r\n### Find the right package before launch\n\n- `apps`\n- `la com.example.app`\n- `l`\n\r\n### Inspect an element before using XPath\n\n- `l`\n- `ref 12`\n- `x 12`\n- `vx //EditText[@text='Search']`\n\r\n### Clear and refill an input\n\n- `i 7 --clear`\n- `i 7 hello world`\n- `ix //EditText[@text='Search'] --`\n- `ix //EditText[@text='Search'] -- hello world`\n\r\n## Troubleshooting\r\n\r\n- If an `agent-android` command fails, first check whether the AIVane app or phone-side API service has exited.\n- If `agent-android` is not found, run `uv tool update-shell`, reopen the terminal, and retry.\n- Re-open the app or restart the phone-side service, then retry `curl http://:8080/health`.\n- If `health` works but UI commands fail, run `ss` to force-refresh the tree before tapping or inputting.\r\n- If `tx` or `ix` fails, run `vx ` and make sure the XPath resolves to exactly one runtime match.\r\n- If screenshots fail the first time, confirm the on-device MediaProjection permission prompt was accepted.\r\n- If everything suddenly stops responding, confirm the phone IP did not change and that the desktop is still on the same LAN.\r\n\r\n## When To Stop\r\n\r\nStop and ask for user help when:\r\n\r\n- the device is unreachable on LAN\r\n- the app is not running and cannot be restarted from the current path\r\n- required Android permissions are missing\r\n- launcher discovery returns nothing useful\r\n- the runtime UI no longer matches the expected screen after repeated refreshes\r\n\r\n## References\r\n\r\n- Smoke checklist: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/skills/agent-android/references/smoke-flow.md)\n- Quickstart: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/quickstart.md)\n- Install guide: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/install-agent-android.md)\n- Public protocol: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/protocol-v1.md)\n- Known beta limits: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/known-limitations.md)\n\nFile v0.1.6:_meta.json\n\n{\n \"ownerId\": \"kn77cfv5yzn6q2zqaewdexqsth84z5tf\",\n \"slug\": \"agent-android\",\n \"version\": \"0.1.6\",\n \"publishedAt\": 1776315481598\n}\n\nFile v0.1.6:references/smoke-flow.md\n\n# Android REPL Smoke Flow\n\nUse this checklist when validating a fresh setup.\n\n## Preconditions\n\n- Android REPL app installed\n- API service running\n- controlling machine on the same LAN\n- `agent-android` available on `PATH`\n\n## Checklist\n\n1. Save the device URL:\n\n```text\nset url http://:8080\n```\n\n2. Check service health:\n\n```bash\ncurl http://:8080/health\n```\n\n3. List launcher apps:\n\n```bash\nagent-android --apps --url http://:8080\n```\n\n4. Launch the target app.\n5. List the current UI tree.\n6. Perform one tap.\n7. Perform one text input if relevant.\n8. Navigate back.\n\n## Success Criteria\n\n- the device responds\n- launcher apps are visible\n- launch succeeds\n- the UI tree refreshes after actions\n- the user can complete at least one inspect -> act -> inspect loop\n\nFile v0.1.6:skill-card.md\n\n## Description:\n\nControl Android over LAN without USB, ADB, or root.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[crazytigerman](https://clawhub.ai/user/crazytigerman)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and operators use this skill to connect to a trusted Android device on the same LAN, inspect apps and UI state, and drive step-by-step tap, input, navigation, and screenshot workflows without USB, ADB, or root.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can read and control an Android device over unauthenticated plaintext LAN HTTP.\n\nMitigation: Use only a trusted device URL provided by the user, keep the phone service off public or shared Wi-Fi, and prefer an isolated trusted network or encrypted tunnel.\n\nRisk: UI trees and screenshots can expose private app content.\n\nMitigation: Use a test device or non-sensitive apps when possible, ask for confirmation before sensitive or irreversible actions, and save screenshots or raw UI dumps only when explicitly requested.\n\nRisk: The uv-installed dependency is not version-pinned in the skill metadata.\n\nMitigation: Review the upstream package before installation and confirm the installed package version is acceptable for the deployment.\n\n## Reference(s):\n\n- [Project homepage](https://github.com/aivanelabs/ai-rpa)\n- [Smoke checklist](https://github.com/aivanelabs/ai-rpa/blob/main/skills/agent-android/references/smoke-flow.md)\n- [Quickstart](https://github.com/aivanelabs/ai-rpa/blob/main/docs/quickstart.md)\n- [Install guide](https://github.com/aivanelabs/ai-rpa/blob/main/docs/install-agent-android.md)\n- [Public protocol](https://github.com/aivanelabs/ai-rpa/blob/main/docs/protocol-v1.md)\n- [Known beta limits](https://github.com/aivanelabs/ai-rpa/blob/main/docs/known-limitations.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown with inline shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include user-approved Android control commands, trusted device URL placeholders, and screenshot file paths when explicitly requested.]\n\n## Skill Version(s):\n\n0.1.6 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v0.1.6:agents/openai.yaml\n\ninterface:\n display_name: \"agent-android\"\n short_description: \"agent-android for AI agents\"\n default_prompt: \"Use $agent-android from the aivanelabs/ai-rpa repo to connect to an AIVane device over LAN, inspect launcher apps and UI state, then control the phone step by step.\"\n\nArchive v0.1.5: 4 files, 4538 bytes\n\nFiles: agents/openai.yaml (283b), references/smoke-flow.md (803b), SKILL.md (8528b), _meta.json (132b)\n\nFile v0.1.5:SKILL.md\n\n---\r\nname: agent-android\ndescription: Connect to AIVane (AI Mobile Automation) over LAN, inspect launcher apps and UI state, and control the phone step by step through the public REPL/CLI path. Use this when Codex needs Android phone control for AI-agent tasks such as checking device connectivity, listing launchable apps, launching an app, inspecting the current UI tree, tapping, inputting text, swiping, navigating back/home, taking screenshots, or running a small end-to-end smoke flow with the public CLI.\nmetadata: {\"openclaw\":{\"homepage\":\"https://github.com/aivanelabs/ai-rpa\",\"requires\":{\"bins\":[\"agent-android\"]},\"install\":[{\"id\":\"agent-android-uv\",\"kind\":\"uv\",\"package\":\"aivane-agent-android\",\"bins\":[\"agent-android\"],\"label\":\"Install agent-android CLI (uv)\"}]}}\n---\n\r\n# Android REPL\r\n\r\nUse this skill to drive an Android device through the public `agent-android` beta surface published in the `aivanelabs/ai-rpa` repo.\n\nRuntime prerequisites:\n\n- `agent-android` is available on `PATH`\n- if it is missing, install the CLI with `uv tool install aivane-agent-android`; then run `uv tool update-shell` if the command is still not found\n- the user has provided a trusted device URL such as `http://:8080`\n\r\nThe public path is local-first:\r\n\r\n- the phone hosts the lightweight HTTP service locally\r\n- the desktop connects directly to `http://:8080`\r\n- UI reads, taps, inputs, and screenshots stay on the phone and controlling machine\r\n- the current tradeoff is LAN-only control; an optional server-side or relay path may arrive later\r\n\r\nIf an `agent-android` command suddenly stops working, first check whether the AIVane app or its local API service has exited on the phone.\n\n## Safety Boundaries\n\n- Connect only to a device URL explicitly provided by the user.\n- Do not scan local networks or guess device IP addresses.\n- Treat UI trees and screenshots as sensitive because they may contain private app content.\n- Save screenshots or raw UI dumps only when the user explicitly asks for a file output.\n- Ask for confirmation before operating sensitive apps, private content, account settings, or irreversible actions.\n- Do not expose the phone-side service on a public network.\n\n## Core Workflow\n\r\nEvery Android control task should follow the same short loop:\r\n\r\n1. Confirm connectivity with `/health`\r\n2. Discover the target app with `apps` if needed\r\n3. Launch one app\r\n4. Inspect the current UI tree\r\n5. Perform one action\r\n6. Inspect again\r\n\r\nKeep the loop short. Prefer inspect -> act -> inspect over long speculative command chains.\r\n\r\n## Quick Start\r\n\r\nStart the REPL with the user-provided device URL:\n\n- `agent-android --repl --url http://:8080`\n\nBuilt-in help:\n\n- `agent-android --help`\n- In the REPL: `h`\n\r\n## Essential CLI Commands\r\n\r\nUse the one-off CLI when you already know the exact action you want.\r\n\r\nConnectivity:\n\n- `agent-android --health --url http://:8080`\n\nDiscovery:\n\n- `agent-android --apps --url http://:8080`\n- `agent-android --list --url http://:8080`\n- `agent-android --id com.example:id/search --url http://:8080`\n- `agent-android --text Search --url http://:8080`\n- `agent-android --inputs --url http://:8080`\n- `agent-android --refId 7 --url http://:8080`\n- `agent-android --xpath 7 --url http://:8080`\n- `agent-android --get-attr 7 text --url http://:8080`\n\nActions:\n\n- `agent-android --launch com.xingin.xhs --url http://:8080`\n- `agent-android --tap 7 --url http://:8080`\n- `agent-android --input 7 \"hello world\" --url http://:8080`\n- `agent-android --swipe up --url http://:8080`\n- `agent-android --back --url http://:8080`\n- `agent-android --press home --url http://:8080`\n- `agent-android --screenshot --url http://:8080`\n\nWaiting and output:\n\n- `agent-android --wait-for Search --timeout 30 --url http://:8080`\n- `agent-android --list --raw --url http://:8080`\n\r\n## REPL Command Reference\r\n\r\nUse the REPL for exploratory tasks and smoke runs. Short aliases and long names both work.\r\n\r\n### Browse\r\n\r\n- `health` or `hl`\r\n Check `/health`.\r\n- `l [n]` or `list [n]`\r\n List the first `n` elements, or all cached elements when `n` is omitted.\r\n- `ss` or `snapshot`\r\n Force-refresh the UI tree and print it again.\r\n- `f ` or `find `\r\n Filter by text or content description.\r\n- `id `\r\n Filter by Android resource ID.\r\n- `ref `\r\n Show the full element detail for one refId.\r\n- `x ` or `xpath `\r\n Generate XPath candidates and validate their runtime match counts.\r\n- `xx `\r\n Tap by the best unique generated XPath candidate. Refuses ambiguous matches.\r\n- `vx [idx]` or `validatex [idx]`\r\n Validate one XPath against the runtime. Optionally inspect one match by zero-based index.\r\n\r\n### Interact\r\n\r\n- `t ` or `tap `\r\n Tap the element center point from the current tree.\r\n- `tx ` or `tapx `\r\n Tap one runtime-resolved XPath target.\r\n- `i ` or `input `\r\n Input text into a refId target.\r\n Use `--clear` or `\"\"` to clear instead of typing.\r\n- `ix ` or `inputx `\r\n Input text into one XPath target.\r\n Use `ix --` or `--clear` to clear the field.\r\n- `sw [--dur N] [--dist N]` or `swipe ...`\r\n Swipe down/up/left/right with optional duration and distance.\r\n- `p ` or `press ...`\n Press a system key.\n- `b` or `back`\r\n Press Back.\r\n- `la ` or `launch `\r\n Launch an app by package name.\r\n- `s [path]` or `screenshot [path]`\r\n Capture a screenshot to an auto-generated or explicit path.\r\n\r\n### Wait And Inspect\r\n\r\n- `wf [--t N]` or `waitfor ...`\r\n Wait for an element to appear.\r\n- `g ` or `get `\r\n Read an attribute such as `text`, `class`, `bounds`, `x`, `y`, or `xpath`.\r\n- `apps`\r\n List launcher apps from `/apps`.\r\n\r\n### Session\r\n\r\n- `raw`\r\n Toggle raw JSON mode.\r\n- `vars`\n Show current URL, timeout, raw mode, and tree cache state.\n- `set timeout 30`\n Set the default wait timeout in seconds.\n- `h` or `help`\r\n Show the built-in help text.\r\n- `q` or `quit`\r\n Exit the REPL.\r\n\r\n## Common Patterns\r\n\r\n### First smoke flow\r\n\r\n1. Start the REPL with `agent-android --repl --url http://:8080`.\n2. `health`\n3. `apps`\n4. `la `\n5. `l`\n6. `t `\n7. `i hello`\n8. `b`\n9. `s`\n\r\n### Find the right package before launch\n\n- `apps`\n- `la com.example.app`\n- `l`\n\r\n### Inspect an element before using XPath\n\n- `l`\n- `ref 12`\n- `x 12`\n- `vx //EditText[@text='Search']`\n\r\n### Clear and refill an input\n\n- `i 7 --clear`\n- `i 7 hello world`\n- `ix //EditText[@text='Search'] --`\n- `ix //EditText[@text='Search'] -- hello world`\n\r\n## Troubleshooting\r\n\r\n- If an `agent-android` command fails, first check whether the AIVane app or phone-side API service has exited.\n- If `agent-android` is not found, run `uv tool update-shell`, reopen the terminal, and retry.\n- Re-open the app or restart the phone-side service, then retry `curl http://:8080/health`.\n- If `health` works but UI commands fail, run `ss` to force-refresh the tree before tapping or inputting.\r\n- If `tx` or `ix` fails, run `vx ` and make sure the XPath resolves to exactly one runtime match.\r\n- If screenshots fail the first time, confirm the on-device MediaProjection permission prompt was accepted.\r\n- If everything suddenly stops responding, confirm the phone IP did not change and that the desktop is still on the same LAN.\r\n\r\n## When To Stop\r\n\r\nStop and ask for user help when:\r\n\r\n- the device is unreachable on LAN\r\n- the app is not running and cannot be restarted from the current path\r\n- required Android permissions are missing\r\n- launcher discovery returns nothing useful\r\n- the runtime UI no longer matches the expected screen after repeated refreshes\r\n\r\n## References\r\n\r\n- Smoke checklist: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/skills/agent-android/references/smoke-flow.md)\n- Quickstart: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/quickstart.md)\n- Install guide: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/install-agent-android.md)\n- Public protocol: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/protocol-v1.md)\n- Known beta limits: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/known-limitations.md)\n\nFile v0.1.5:_meta.json\n\n{\n \"ownerId\": \"kn77cfv5yzn6q2zqaewdexqsth84z5tf\",\n \"slug\": \"agent-android\",\n \"version\": \"0.1.5\",\n \"publishedAt\": 1776314556230\n}\n\nFile v0.1.5:references/smoke-flow.md\n\n# Android REPL Smoke Flow\n\nUse this checklist when validating a fresh setup.\n\n## Preconditions\n\n- Android REPL app installed\n- API service running\n- controlling machine on the same LAN\n- `agent-android` available on `PATH`\n\n## Checklist\n\n1. Save the device URL:\n\n```text\nset url http://:8080\n```\n\n2. Check service health:\n\n```bash\ncurl http://:8080/health\n```\n\n3. List launcher apps:\n\n```bash\nagent-android --apps --url http://:8080\n```\n\n4. Launch the target app.\n5. List the current UI tree.\n6. Perform one tap.\n7. Perform one text input if relevant.\n8. Navigate back.\n\n## Success Criteria\n\n- the device responds\n- launcher apps are visible\n- launch succeeds\n- the UI tree refreshes after actions\n- the user can complete at least one inspect -> act -> inspect loop\n\nFile v0.1.5:agents/openai.yaml\n\ninterface:\n display_name: \"agent-android\"\n short_description: \"agent-android for AI agents\"\n default_prompt: \"Use $agent-android from the aivanelabs/ai-rpa repo to connect to an AIVane device over LAN, inspect launcher apps and UI state, then control the phone step by step.\"\n\nArchive v0.1.4: 4 files, 4494 bytes\n\nFiles: agents/openai.yaml (283b), references/smoke-flow.md (803b), SKILL.md (8381b), _meta.json (132b)\n\nFile v0.1.4:SKILL.md\n\n---\r\nname: agent-android\ndescription: Connect to AIVane (AI Mobile Automation) over LAN, inspect launcher apps and UI state, and control the phone step by step through the public REPL/CLI path. Use this when Codex needs Android phone control for AI-agent tasks such as checking device connectivity, listing launchable apps, launching an app, inspecting the current UI tree, tapping, inputting text, swiping, navigating back/home, taking screenshots, or running a small end-to-end smoke flow with the public CLI.\nmetadata: {\"openclaw\":{\"homepage\":\"https://github.com/aivanelabs/ai-rpa\",\"requires\":{\"bins\":[\"agent-android\"]},\"install\":[{\"id\":\"agent-android-uv\",\"kind\":\"uv\",\"package\":\"aivane-agent-android\",\"bins\":[\"agent-android\"],\"label\":\"Install agent-android CLI (uv)\"}]}}\n---\n\r\n# Android REPL\r\n\r\nUse this skill to drive an Android device through the public `agent-android` beta surface published in the `aivanelabs/ai-rpa` repo.\n\nRuntime prerequisites:\n\n- `agent-android` is available on `PATH`\n- the user has provided a trusted device URL such as `http://:8080`\n\r\nThe public path is local-first:\r\n\r\n- the phone hosts the lightweight HTTP service locally\r\n- the desktop connects directly to `http://:8080`\r\n- UI reads, taps, inputs, and screenshots stay on the phone and controlling machine\r\n- the current tradeoff is LAN-only control; an optional server-side or relay path may arrive later\r\n\r\nIf an `agent-android` command suddenly stops working, first check whether the AIVane app or its local API service has exited on the phone.\n\n## Safety Boundaries\n\n- Connect only to a device URL explicitly provided by the user.\n- Do not scan local networks or guess device IP addresses.\n- Treat UI trees and screenshots as sensitive because they may contain private app content.\n- Save screenshots or raw UI dumps only when the user explicitly asks for a file output.\n- Ask for confirmation before operating sensitive apps, private content, account settings, or irreversible actions.\n- Do not expose the phone-side service on a public network.\n\n## Core Workflow\n\r\nEvery Android control task should follow the same short loop:\r\n\r\n1. Confirm connectivity with `/health`\r\n2. Discover the target app with `apps` if needed\r\n3. Launch one app\r\n4. Inspect the current UI tree\r\n5. Perform one action\r\n6. Inspect again\r\n\r\nKeep the loop short. Prefer inspect -> act -> inspect over long speculative command chains.\r\n\r\n## Quick Start\r\n\r\nStart the REPL with the user-provided device URL:\n\n- `agent-android --repl --url http://:8080`\n\nBuilt-in help:\n\n- `agent-android --help`\n- In the REPL: `h`\n\r\n## Essential CLI Commands\r\n\r\nUse the one-off CLI when you already know the exact action you want.\r\n\r\nConnectivity:\n\n- `agent-android --health --url http://:8080`\n\nDiscovery:\n\n- `agent-android --apps --url http://:8080`\n- `agent-android --list --url http://:8080`\n- `agent-android --id com.example:id/search --url http://:8080`\n- `agent-android --text Search --url http://:8080`\n- `agent-android --inputs --url http://:8080`\n- `agent-android --refId 7 --url http://:8080`\n- `agent-android --xpath 7 --url http://:8080`\n- `agent-android --get-attr 7 text --url http://:8080`\n\nActions:\n\n- `agent-android --launch com.xingin.xhs --url http://:8080`\n- `agent-android --tap 7 --url http://:8080`\n- `agent-android --input 7 \"hello world\" --url http://:8080`\n- `agent-android --swipe up --url http://:8080`\n- `agent-android --back --url http://:8080`\n- `agent-android --press home --url http://:8080`\n- `agent-android --screenshot --url http://:8080`\n\nWaiting and output:\n\n- `agent-android --wait-for Search --timeout 30 --url http://:8080`\n- `agent-android --list --raw --url http://:8080`\n\r\n## REPL Command Reference\r\n\r\nUse the REPL for exploratory tasks and smoke runs. Short aliases and long names both work.\r\n\r\n### Browse\r\n\r\n- `health` or `hl`\r\n Check `/health`.\r\n- `l [n]` or `list [n]`\r\n List the first `n` elements, or all cached elements when `n` is omitted.\r\n- `ss` or `snapshot`\r\n Force-refresh the UI tree and print it again.\r\n- `f ` or `find `\r\n Filter by text or content description.\r\n- `id `\r\n Filter by Android resource ID.\r\n- `ref `\r\n Show the full element detail for one refId.\r\n- `x ` or `xpath `\r\n Generate XPath candidates and validate their runtime match counts.\r\n- `xx `\r\n Tap by the best unique generated XPath candidate. Refuses ambiguous matches.\r\n- `vx [idx]` or `validatex [idx]`\r\n Validate one XPath against the runtime. Optionally inspect one match by zero-based index.\r\n\r\n### Interact\r\n\r\n- `t ` or `tap `\r\n Tap the element center point from the current tree.\r\n- `tx ` or `tapx `\r\n Tap one runtime-resolved XPath target.\r\n- `i ` or `input `\r\n Input text into a refId target.\r\n Use `--clear` or `\"\"` to clear instead of typing.\r\n- `ix ` or `inputx `\r\n Input text into one XPath target.\r\n Use `ix --` or `--clear` to clear the field.\r\n- `sw [--dur N] [--dist N]` or `swipe ...`\r\n Swipe down/up/left/right with optional duration and distance.\r\n- `p ` or `press ...`\n Press a system key.\n- `b` or `back`\r\n Press Back.\r\n- `la ` or `launch `\r\n Launch an app by package name.\r\n- `s [path]` or `screenshot [path]`\r\n Capture a screenshot to an auto-generated or explicit path.\r\n\r\n### Wait And Inspect\r\n\r\n- `wf [--t N]` or `waitfor ...`\r\n Wait for an element to appear.\r\n- `g ` or `get `\r\n Read an attribute such as `text`, `class`, `bounds`, `x`, `y`, or `xpath`.\r\n- `apps`\r\n List launcher apps from `/apps`.\r\n\r\n### Session\r\n\r\n- `raw`\r\n Toggle raw JSON mode.\r\n- `vars`\n Show current URL, timeout, raw mode, and tree cache state.\n- `set timeout 30`\n Set the default wait timeout in seconds.\n- `h` or `help`\r\n Show the built-in help text.\r\n- `q` or `quit`\r\n Exit the REPL.\r\n\r\n## Common Patterns\r\n\r\n### First smoke flow\r\n\r\n1. Start the REPL with `agent-android --repl --url http://:8080`.\n2. `health`\n3. `apps`\n4. `la `\n5. `l`\n6. `t `\n7. `i hello`\n8. `b`\n9. `s`\n\r\n### Find the right package before launch\n\n- `apps`\n- `la com.example.app`\n- `l`\n\r\n### Inspect an element before using XPath\n\n- `l`\n- `ref 12`\n- `x 12`\n- `vx //EditText[@text='Search']`\n\r\n### Clear and refill an input\n\n- `i 7 --clear`\n- `i 7 hello world`\n- `ix //EditText[@text='Search'] --`\n- `ix //EditText[@text='Search'] -- hello world`\n\r\n## Troubleshooting\r\n\r\n- If an `agent-android` command fails, first check whether the AIVane app or phone-side API service has exited.\n- If `agent-android` is not found, run `uv tool update-shell`, reopen the terminal, and retry.\n- Re-open the app or restart the phone-side service, then retry `curl http://:8080/health`.\n- If `health` works but UI commands fail, run `ss` to force-refresh the tree before tapping or inputting.\r\n- If `tx` or `ix` fails, run `vx ` and make sure the XPath resolves to exactly one runtime match.\r\n- If screenshots fail the first time, confirm the on-device MediaProjection permission prompt was accepted.\r\n- If everything suddenly stops responding, confirm the phone IP did not change and that the desktop is still on the same LAN.\r\n\r\n## When To Stop\r\n\r\nStop and ask for user help when:\r\n\r\n- the device is unreachable on LAN\r\n- the app is not running and cannot be restarted from the current path\r\n- required Android permissions are missing\r\n- launcher discovery returns nothing useful\r\n- the runtime UI no longer matches the expected screen after repeated refreshes\r\n\r\n## References\r\n\r\n- Smoke checklist: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/skills/agent-android/references/smoke-flow.md)\n- Quickstart: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/quickstart.md)\n- Install guide: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/install-agent-android.md)\n- Public protocol: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/protocol-v1.md)\n- Known beta limits: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/known-limitations.md)\n\nFile v0.1.4:_meta.json\n\n{\n \"ownerId\": \"kn77cfv5yzn6q2zqaewdexqsth84z5tf\",\n \"slug\": \"agent-android\",\n \"version\": \"0.1.4\",\n \"publishedAt\": 1776314352681\n}\n\nFile v0.1.4:references/smoke-flow.md\n\n# Android REPL Smoke Flow\n\nUse this checklist when validating a fresh setup.\n\n## Preconditions\n\n- Android REPL app installed\n- API service running\n- controlling machine on the same LAN\n- `agent-android` available on `PATH`\n\n## Checklist\n\n1. Save the device URL:\n\n```text\nset url http://:8080\n```\n\n2. Check service health:\n\n```bash\ncurl http://:8080/health\n```\n\n3. List launcher apps:\n\n```bash\nagent-android --apps --url http://:8080\n```\n\n4. Launch the target app.\n5. List the current UI tree.\n6. Perform one tap.\n7. Perform one text input if relevant.\n8. Navigate back.\n\n## Success Criteria\n\n- the device responds\n- launcher apps are visible\n- launch succeeds\n- the UI tree refreshes after actions\n- the user can complete at least one inspect -> act -> inspect loop\n\nFile v0.1.4:agents/openai.yaml\n\ninterface:\n display_name: \"agent-android\"\n short_description: \"agent-android for AI agents\"\n default_prompt: \"Use $agent-android from the aivanelabs/ai-rpa repo to connect to an AIVane device over LAN, inspect launcher apps and UI state, then control the phone step by step.\"\n\nArchive v0.1.3: 4 files, 4519 bytes\n\nFiles: agents/openai.yaml (283b), references/smoke-flow.md (803b), SKILL.md (8380b), _meta.json (132b)\n\nFile v0.1.3:SKILL.md\n\n---\r\nname: agent-android\ndescription: Connect to AIVane (AI Mobile Automation) over LAN, inspect launcher apps and UI state, and control the phone step by step through the public REPL/CLI path. Use this when Codex needs Android phone control for AI-agent tasks such as checking device connectivity, listing launchable apps, launching an app, inspecting the current UI tree, tapping, inputting text, swiping, navigating back/home, taking screenshots, or running a small end-to-end smoke flow with the public CLI.\nmetadata: {\"openclaw\":{\"homepage\":\"https://github.com/aivanelabs/ai-rpa\",\"requires\":{\"bins\":[\"agent-android\"]},\"install\":[{\"id\":\"agent-android-uv\",\"kind\":\"uv\",\"package\":\"aivane-agent-android\",\"bins\":[\"agent-android\"],\"label\":\"Install agent-android CLI (uv)\"}]}}\n---\n\r\n# Android REPL\r\n\r\nUse this skill to drive an Android device through the public `agent-android` beta surface published in the `aivanelabs/ai-rpa` repo.\n\nRuntime prerequisites:\n\n- `agent-android` is available on `PATH`\n- the user has provided a trusted device URL such as `http://:8080`\n\r\nThe public path is local-first:\r\n\r\n- the phone hosts the lightweight HTTP service locally\r\n- the desktop connects directly to `http://:8080`\r\n- UI reads, taps, inputs, and screenshots stay on the phone and controlling machine\r\n- the current tradeoff is LAN-only control; an optional server-side or relay path may arrive later\r\n\r\nIf an `agent-android` command suddenly stops working, first check whether the AIVane app or its local API service has exited on the phone.\n\n## Safety Boundaries\n\n- Connect only to a device URL explicitly provided by the user.\n- Do not scan local networks or guess device IP addresses.\n- Treat UI trees and screenshots as sensitive because they may contain private app content.\n- Save screenshots or raw UI dumps only when the user explicitly asks for a file output.\n- Ask for confirmation before operating sensitive apps, private content, account settings, or irreversible actions.\n- Do not expose the phone-side service on a public network.\n\n## Core Workflow\n\r\nEvery Android control task should follow the same short loop:\r\n\r\n1. Confirm connectivity with `/health`\r\n2. Discover the target app with `apps` if needed\r\n3. Launch one app\r\n4. Inspect the current UI tree\r\n5. Perform one action\r\n6. Inspect again\r\n\r\nKeep the loop short. Prefer inspect -> act -> inspect over long speculative command chains.\r\n\r\n## Quick Start\r\n\r\nStart the REPL with the user-provided device URL:\n\r\n```bash\nagent-android --repl --url http://:8080\n```\n\r\nBuilt-in help:\n\r\n```bash\nagent-android --help\n```\n\r\n```text\r\nh\r\n```\r\n\r\n## Essential CLI Commands\r\n\r\nUse the one-off CLI when you already know the exact action you want.\r\n\r\n```bash\r\n# Connectivity\r\nagent-android --health --url http://:8080\n\r\n# Discovery\r\nagent-android --apps --url http://:8080\nagent-android --list --url http://:8080\nagent-android --id com.example:id/search --url http://:8080\nagent-android --text Search --url http://:8080\nagent-android --inputs --url http://:8080\nagent-android --refId 7 --url http://:8080\nagent-android --xpath 7 --url http://:8080\nagent-android --get-attr 7 text --url http://:8080\n\r\n# Actions\r\nagent-android --launch com.xingin.xhs --url http://:8080\nagent-android --tap 7 --url http://:8080\nagent-android --input 7 \"hello world\" --url http://:8080\nagent-android --swipe up --url http://:8080\nagent-android --back --url http://:8080\nagent-android --press home --url http://:8080\nagent-android --screenshot --url http://:8080\n\r\n# Waiting and output\r\nagent-android --wait-for Search --timeout 30 --url http://:8080\nagent-android --list --raw --url http://:8080\n```\r\n\r\n## REPL Command Reference\r\n\r\nUse the REPL for exploratory tasks and smoke runs. Short aliases and long names both work.\r\n\r\n### Browse\r\n\r\n- `health` or `hl`\r\n Check `/health`.\r\n- `l [n]` or `list [n]`\r\n List the first `n` elements, or all cached elements when `n` is omitted.\r\n- `ss` or `snapshot`\r\n Force-refresh the UI tree and print it again.\r\n- `f ` or `find `\r\n Filter by text or content description.\r\n- `id `\r\n Filter by Android resource ID.\r\n- `ref `\r\n Show the full element detail for one refId.\r\n- `x ` or `xpath `\r\n Generate XPath candidates and validate their runtime match counts.\r\n- `xx `\r\n Tap by the best unique generated XPath candidate. Refuses ambiguous matches.\r\n- `vx [idx]` or `validatex [idx]`\r\n Validate one XPath against the runtime. Optionally inspect one match by zero-based index.\r\n\r\n### Interact\r\n\r\n- `t ` or `tap `\r\n Tap the element center point from the current tree.\r\n- `tx ` or `tapx `\r\n Tap one runtime-resolved XPath target.\r\n- `i ` or `input `\r\n Input text into a refId target.\r\n Use `--clear` or `\"\"` to clear instead of typing.\r\n- `ix ` or `inputx `\r\n Input text into one XPath target.\r\n Use `ix --` or `--clear` to clear the field.\r\n- `sw [--dur N] [--dist N]` or `swipe ...`\r\n Swipe down/up/left/right with optional duration and distance.\r\n- `p ` or `press ...`\n Press a system key.\n- `b` or `back`\r\n Press Back.\r\n- `la ` or `launch `\r\n Launch an app by package name.\r\n- `s [path]` or `screenshot [path]`\r\n Capture a screenshot to an auto-generated or explicit path.\r\n\r\n### Wait And Inspect\r\n\r\n- `wf [--t N]` or `waitfor ...`\r\n Wait for an element to appear.\r\n- `g ` or `get `\r\n Read an attribute such as `text`, `class`, `bounds`, `x`, `y`, or `xpath`.\r\n- `apps`\r\n List launcher apps from `/apps`.\r\n\r\n### Session\r\n\r\n- `raw`\r\n Toggle raw JSON mode.\r\n- `vars`\n Show current URL, timeout, raw mode, and tree cache state.\n- `set timeout 30`\n Set the default wait timeout in seconds.\n- `h` or `help`\r\n Show the built-in help text.\r\n- `q` or `quit`\r\n Exit the REPL.\r\n\r\n## Common Patterns\r\n\r\n### First smoke flow\r\n\r\n1. Start the REPL with `agent-android --repl --url http://:8080`.\n2. `health`\n3. `apps`\n4. `la `\n5. `l`\n6. `t `\n7. `i hello`\n8. `b`\n9. `s`\n\r\n### Find the right package before launch\r\n\r\n```text\r\napps\r\nla com.example.app\r\nl\r\n```\r\n\r\n### Inspect an element before using XPath\r\n\r\n```text\r\nl\r\nref 12\r\nx 12\r\nvx //EditText[@text='Search']\r\n```\r\n\r\n### Clear and refill an input\r\n\r\n```text\r\ni 7 --clear\r\ni 7 hello world\r\n```\r\n\r\n```text\r\nix //EditText[@text='Search'] --\r\nix //EditText[@text='Search'] -- hello world\r\n```\r\n\r\n## Troubleshooting\r\n\r\n- If an `agent-android` command fails, first check whether the AIVane app or phone-side API service has exited.\n- If `agent-android` is not found, run `uv tool update-shell`, reopen the terminal, and retry.\n- Re-open the app or restart the phone-side service, then retry `curl http://:8080/health`.\n- If `health` works but UI commands fail, run `ss` to force-refresh the tree before tapping or inputting.\r\n- If `tx` or `ix` fails, run `vx ` and make sure the XPath resolves to exactly one runtime match.\r\n- If screenshots fail the first time, confirm the on-device MediaProjection permission prompt was accepted.\r\n- If everything suddenly stops responding, confirm the phone IP did not change and that the desktop is still on the same LAN.\r\n\r\n## When To Stop\r\n\r\nStop and ask for user help when:\r\n\r\n- the device is unreachable on LAN\r\n- the app is not running and cannot be restarted from the current path\r\n- required Android permissions are missing\r\n- launcher discovery returns nothing useful\r\n- the runtime UI no longer matches the expected screen after repeated refreshes\r\n\r\n## References\r\n\r\n- Smoke checklist: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/skills/agent-android/references/smoke-flow.md)\n- Quickstart: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/quickstart.md)\n- Install guide: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/install-agent-android.md)\n- Public protocol: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/protocol-v1.md)\n- Known beta limits: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/known-limitations.md)\n\nFile v0.1.3:_meta.json\n\n{\n \"ownerId\": \"kn77cfv5yzn6q2zqaewdexqsth84z5tf\",\n \"slug\": \"agent-android\",\n \"version\": \"0.1.3\",\n \"publishedAt\": 1776313788386\n}\n\nFile v0.1.3:references/smoke-flow.md\n\n# Android REPL Smoke Flow\n\nUse this checklist when validating a fresh setup.\n\n## Preconditions\n\n- Android REPL app installed\n- API service running\n- controlling machine on the same LAN\n- `agent-android` available on `PATH`\n\n## Checklist\n\n1. Save the device URL:\n\n```text\nset url http://:8080\n```\n\n2. Check service health:\n\n```bash\ncurl http://:8080/health\n```\n\n3. List launcher apps:\n\n```bash\nagent-android --apps --url http://:8080\n```\n\n4. Launch the target app.\n5. List the current UI tree.\n6. Perform one tap.\n7. Perform one text input if relevant.\n8. Navigate back.\n\n## Success Criteria\n\n- the device responds\n- launcher apps are visible\n- launch succeeds\n- the UI tree refreshes after actions\n- the user can complete at least one inspect -> act -> inspect loop\n\nFile v0.1.3:agents/openai.yaml\n\ninterface:\n display_name: \"agent-android\"\n short_description: \"agent-android for AI agents\"\n default_prompt: \"Use $agent-android from the aivanelabs/ai-rpa repo to connect to an AIVane device over LAN, inspect launcher apps and UI state, then control the phone step by step.\"\n\nArchive v0.1.2: 4 files, 4483 bytes\n\nFiles: agents/openai.yaml (283b), references/smoke-flow.md (803b), SKILL.md (8330b), _meta.json (132b)\n\nFile v0.1.2:SKILL.md\n\n---\r\nname: agent-android\r\ndescription: Connect to AIVane (AI Mobile Automation) over LAN, inspect launcher apps and UI state, and control the phone step by step through the public REPL/CLI path. Use this when Codex needs Android phone control for AI-agent tasks such as checking device connectivity, listing launchable apps, launching an app, inspecting the current UI tree, tapping, inputting text, swiping, navigating back/home, taking screenshots, or running a small end-to-end smoke flow with the public CLI.\n---\r\n\r\n# Android REPL\r\n\r\nUse this skill to drive an Android device through the public `agent-android` beta surface published in the `aivanelabs/ai-rpa` repo.\n\nRuntime prerequisites:\n\n- `uv` is installed:\n - https://docs.astral.sh/uv/getting-started/installation/\n- the `agent-android` CLI is installed:\n - `uv tool install aivane-agent-android`\n- if `agent-android` is not found afterwards:\n - `uv tool update-shell`\n- `agent-android` is available on `PATH`\n\r\nThe public path is local-first:\r\n\r\n- the phone hosts the lightweight HTTP service locally\r\n- the desktop connects directly to `http://:8080`\r\n- UI reads, taps, inputs, and screenshots stay on the phone and controlling machine\r\n- the current tradeoff is LAN-only control; an optional server-side or relay path may arrive later\r\n\r\nIf an `agent-android` command suddenly stops working, first check whether the AIVane app or its local API service has exited on the phone.\n\n## Safety Boundaries\n\n- Connect only to a device URL explicitly provided by the user.\n- Do not scan local networks or guess device IP addresses.\n- Treat UI trees and screenshots as sensitive because they may contain private app content.\n- Ask for confirmation before operating payment, banking, password manager, or private messaging screens.\n- Do not expose the phone-side service on a public network.\n\n## Core Workflow\n\r\nEvery Android control task should follow the same short loop:\r\n\r\n1. Confirm connectivity with `/health`\r\n2. Discover the target app with `apps` if needed\r\n3. Launch one app\r\n4. Inspect the current UI tree\r\n5. Perform one action\r\n6. Inspect again\r\n\r\nKeep the loop short. Prefer inspect -> act -> inspect over long speculative command chains.\r\n\r\n## Quick Start\r\n\r\nStart the REPL:\r\n\r\n```bash\nagent-android --repl --url http://:8080\n```\n\r\nSave the current device URL inside the REPL:\r\n\r\n```text\r\nset url http://:8080\r\n```\r\n\r\nBuilt-in help:\r\n\r\n```bash\nagent-android --help\n```\n\r\n```text\r\nh\r\n```\r\n\r\n## Essential CLI Commands\r\n\r\nUse the one-off CLI when you already know the exact action you want.\r\n\r\n```bash\r\n# Connectivity\r\nagent-android --health --url http://:8080\n\r\n# Discovery\r\nagent-android --apps --url http://:8080\nagent-android --list --url http://:8080\nagent-android --id com.example:id/search --url http://:8080\nagent-android --text Search --url http://:8080\nagent-android --inputs --url http://:8080\nagent-android --refId 7 --url http://:8080\nagent-android --xpath 7 --url http://:8080\nagent-android --get-attr 7 text --url http://:8080\n\r\n# Actions\r\nagent-android --launch com.xingin.xhs --url http://:8080\nagent-android --tap 7 --url http://:8080\nagent-android --input 7 \"hello world\" --url http://:8080\nagent-android --swipe up --url http://:8080\nagent-android --back --url http://:8080\nagent-android --press home --url http://:8080\nagent-android --screenshot --url http://:8080\n\r\n# Waiting and output\r\nagent-android --wait-for Search --timeout 30 --url http://:8080\nagent-android --list --raw --output tree.json --url http://:8080\n```\r\n\r\n## REPL Command Reference\r\n\r\nUse the REPL for exploratory tasks and smoke runs. Short aliases and long names both work.\r\n\r\n### Browse\r\n\r\n- `health` or `hl`\r\n Check `/health`.\r\n- `l [n]` or `list [n]`\r\n List the first `n` elements, or all cached elements when `n` is omitted.\r\n- `ss` or `snapshot`\r\n Force-refresh the UI tree and print it again.\r\n- `f ` or `find `\r\n Filter by text or content description.\r\n- `id `\r\n Filter by Android resource ID.\r\n- `ref `\r\n Show the full element detail for one refId.\r\n- `x ` or `xpath `\r\n Generate XPath candidates and validate their runtime match counts.\r\n- `xx `\r\n Tap by the best unique generated XPath candidate. Refuses ambiguous matches.\r\n- `vx [idx]` or `validatex [idx]`\r\n Validate one XPath against the runtime. Optionally inspect one match by zero-based index.\r\n\r\n### Interact\r\n\r\n- `t ` or `tap `\r\n Tap the element center point from the current tree.\r\n- `tx ` or `tapx `\r\n Tap one runtime-resolved XPath target.\r\n- `i ` or `input `\r\n Input text into a refId target.\r\n Use `--clear` or `\"\"` to clear instead of typing.\r\n- `ix ` or `inputx `\r\n Input text into one XPath target.\r\n Use `ix --` or `--clear` to clear the field.\r\n- `sw [--dur N] [--dist N]` or `swipe ...`\r\n Swipe down/up/left/right with optional duration and distance.\r\n- `p ` or `press ...`\n Press a system key.\n- `b` or `back`\r\n Press Back.\r\n- `la ` or `launch `\r\n Launch an app by package name.\r\n- `s [path]` or `screenshot [path]`\r\n Capture a screenshot to an auto-generated or explicit path.\r\n\r\n### Wait And Inspect\r\n\r\n- `wf [--t N]` or `waitfor ...`\r\n Wait for an element to appear.\r\n- `g ` or `get `\r\n Read an attribute such as `text`, `class`, `bounds`, `x`, `y`, or `xpath`.\r\n- `apps`\r\n List launcher apps from `/apps`.\r\n\r\n### Session\r\n\r\n- `raw`\r\n Toggle raw JSON mode.\r\n- `vars`\r\n Show current URL, timeout, raw mode, and tree cache state.\r\n- `set url http://:8080`\r\n Switch the server URL and persist it to local config.\r\n- `set timeout 30`\r\n Set the default wait timeout in seconds.\r\n- `h` or `help`\r\n Show the built-in help text.\r\n- `q` or `quit`\r\n Exit the REPL.\r\n\r\n## Common Patterns\r\n\r\n### First smoke flow\r\n\r\n1. `set url http://:8080`\r\n2. `health`\r\n3. `apps`\r\n4. `la `\r\n5. `l`\r\n6. `t `\r\n7. `i hello`\r\n8. `b`\r\n9. `s`\r\n\r\n### Find the right package before launch\r\n\r\n```text\r\napps\r\nla com.example.app\r\nl\r\n```\r\n\r\n### Inspect an element before using XPath\r\n\r\n```text\r\nl\r\nref 12\r\nx 12\r\nvx //EditText[@text='Search']\r\n```\r\n\r\n### Clear and refill an input\r\n\r\n```text\r\ni 7 --clear\r\ni 7 hello world\r\n```\r\n\r\n```text\r\nix //EditText[@text='Search'] --\r\nix //EditText[@text='Search'] -- hello world\r\n```\r\n\r\n## Troubleshooting\r\n\r\n- If an `agent-android` command fails, first check whether the AIVane app or phone-side API service has exited.\n- If `agent-android` is not found, run `uv tool update-shell`, reopen the terminal, and retry.\n- Re-open the app or restart the phone-side service, then retry `curl http://:8080/health`.\n- If `health` works but UI commands fail, run `ss` to force-refresh the tree before tapping or inputting.\r\n- If `tx` or `ix` fails, run `vx ` and make sure the XPath resolves to exactly one runtime match.\r\n- If screenshots fail the first time, confirm the on-device MediaProjection permission prompt was accepted.\r\n- If everything suddenly stops responding, confirm the phone IP did not change and that the desktop is still on the same LAN.\r\n\r\n## When To Stop\r\n\r\nStop and ask for user help when:\r\n\r\n- the device is unreachable on LAN\r\n- the app is not running and cannot be restarted from the current path\r\n- required Android permissions are missing\r\n- launcher discovery returns nothing useful\r\n- the runtime UI no longer matches the expected screen after repeated refreshes\r\n\r\n## References\r\n\r\n- Smoke checklist: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/skills/agent-android/references/smoke-flow.md)\n- Quickstart: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/quickstart.md)\n- Install guide: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/install-agent-android.md)\n- Public protocol: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/protocol-v1.md)\n- Known beta limits: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/known-limitations.md)\n\nFile v0.1.2:_meta.json\n\n{\n \"ownerId\": \"kn77cfv5yzn6q2zqaewdexqsth84z5tf\",\n \"slug\": \"agent-android\",\n \"version\": \"0.1.2\",\n \"publishedAt\": 1776313138187\n}\n\nFile v0.1.2:references/smoke-flow.md\n\n# Android REPL Smoke Flow\n\nUse this checklist when validating a fresh setup.\n\n## Preconditions\n\n- Android REPL app installed\n- API service running\n- controlling machine on the same LAN\n- `agent-android` available on `PATH`\n\n## Checklist\n\n1. Save the device URL:\n\n```text\nset url http://:8080\n```\n\n2. Check service health:\n\n```bash\ncurl http://:8080/health\n```\n\n3. List launcher apps:\n\n```bash\nagent-android --apps --url http://:8080\n```\n\n4. Launch the target app.\n5. List the current UI tree.\n6. Perform one tap.\n7. Perform one text input if relevant.\n8. Navigate back.\n\n## Success Criteria\n\n- the device responds\n- launcher apps are visible\n- launch succeeds\n- the UI tree refreshes after actions\n- the user can complete at least one inspect -> act -> inspect loop\n\nFile v0.1.2:agents/openai.yaml\n\ninterface:\n display_name: \"agent-android\"\n short_description: \"agent-android for AI agents\"\n default_prompt: \"Use $agent-android from the aivanelabs/ai-rpa repo to connect to an AIVane device over LAN, inspect launcher apps and UI state, then control the phone step by step.\"\n\nArchive v0.1.1: 4 files, 4331 bytes\n\nFiles: agents/openai.yaml (283b), references/smoke-flow.md (803b), SKILL.md (8007b), _meta.json (132b)\n\nFile v0.1.1:SKILL.md\n\n---\r\nname: agent-android\r\ndescription: Connect to AIVane (AI Mobile Automation) over LAN, inspect launcher apps and UI state, and control the phone step by step through the public REPL/CLI path. Use this when Codex needs Android phone control for AI-agent tasks such as checking device connectivity, listing launchable apps, launching an app, inspecting the current UI tree, tapping, inputting text, swiping, navigating back/home, taking screenshots, or running a small end-to-end smoke flow with the public CLI.\n---\r\n\r\n# Android REPL\r\n\r\nUse this skill to drive an Android device through the public `agent-android` beta surface published in the `aivanelabs/ai-rpa` repo.\n\nPrerequisites:\n\n- install `uv` first:\n - https://docs.astral.sh/uv/getting-started/installation/\n- install the CLI:\n - `uv tool install aivane-agent-android`\n- if `agent-android` is not found afterwards:\n - `uv tool update-shell`\n- make sure `agent-android` is available on `PATH`\n- install the skill from GitHub with:\n `npx skills add aivanelabs/ai-rpa --skill agent-android`\n\r\nThe public path is local-first:\r\n\r\n- the phone hosts the lightweight HTTP service locally\r\n- the desktop connects directly to `http://:8080`\r\n- UI reads, taps, inputs, and screenshots stay on the phone and controlling machine\r\n- the current tradeoff is LAN-only control; an optional server-side or relay path may arrive later\r\n\r\nIf an `agent-android` command suddenly stops working, first check whether the AIVane app or its local API service has exited on the phone.\n\r\n## Core Workflow\r\n\r\nEvery Android control task should follow the same short loop:\r\n\r\n1. Confirm connectivity with `/health`\r\n2. Discover the target app with `apps` if needed\r\n3. Launch one app\r\n4. Inspect the current UI tree\r\n5. Perform one action\r\n6. Inspect again\r\n\r\nKeep the loop short. Prefer inspect -> act -> inspect over long speculative command chains.\r\n\r\n## Quick Start\r\n\r\nStart the REPL:\r\n\r\n```bash\nagent-android --repl --url http://:8080\n```\n\r\nSave the current device URL inside the REPL:\r\n\r\n```text\r\nset url http://:8080\r\n```\r\n\r\nBuilt-in help:\r\n\r\n```bash\nagent-android --help\n```\n\r\n```text\r\nh\r\n```\r\n\r\n## Essential CLI Commands\r\n\r\nUse the one-off CLI when you already know the exact action you want.\r\n\r\n```bash\r\n# Connectivity\r\nagent-android --health --url http://:8080\n\r\n# Discovery\r\nagent-android --apps --url http://:8080\nagent-android --list --url http://:8080\nagent-android --id com.example:id/search --url http://:8080\nagent-android --text Search --url http://:8080\nagent-android --inputs --url http://:8080\nagent-android --refId 7 --url http://:8080\nagent-android --xpath 7 --url http://:8080\nagent-android --get-attr 7 text --url http://:8080\n\r\n# Actions\r\nagent-android --launch com.xingin.xhs --url http://:8080\nagent-android --tap 7 --url http://:8080\nagent-android --input 7 \"hello world\" --url http://:8080\nagent-android --swipe up --url http://:8080\nagent-android --back --url http://:8080\nagent-android --press home --url http://:8080\nagent-android --screenshot --url http://:8080\n\r\n# Waiting and output\r\nagent-android --wait-for Search --timeout 30 --url http://:8080\nagent-android --list --raw --output tree.json --url http://:8080\n```\r\n\r\n## REPL Command Reference\r\n\r\nUse the REPL for exploratory tasks and smoke runs. Short aliases and long names both work.\r\n\r\n### Browse\r\n\r\n- `health` or `hl`\r\n Check `/health`.\r\n- `l [n]` or `list [n]`\r\n List the first `n` elements, or all cached elements when `n` is omitted.\r\n- `ss` or `snapshot`\r\n Force-refresh the UI tree and print it again.\r\n- `f ` or `find `\r\n Filter by text or content description.\r\n- `id `\r\n Filter by Android resource ID.\r\n- `ref `\r\n Show the full element detail for one refId.\r\n- `x ` or `xpath `\r\n Generate XPath candidates and validate their runtime match counts.\r\n- `xx `\r\n Tap by the best unique generated XPath candidate. Refuses ambiguous matches.\r\n- `vx [idx]` or `validatex [idx]`\r\n Validate one XPath against the runtime. Optionally inspect one match by zero-based index.\r\n\r\n### Interact\r\n\r\n- `t ` or `tap `\r\n Tap the element center point from the current tree.\r\n- `tx ` or `tapx `\r\n Tap one runtime-resolved XPath target.\r\n- `i ` or `input `\r\n Input text into a refId target.\r\n Use `--clear` or `\"\"` to clear instead of typing.\r\n- `ix ` or `inputx `\r\n Input text into one XPath target.\r\n Use `ix --` or `--clear` to clear the field.\r\n- `sw [--dur N] [--dist N]` or `swipe ...`\r\n Swipe down/up/left/right with optional duration and distance.\r\n- `p ` or `press ...`\n Press a system key.\n- `b` or `back`\r\n Press Back.\r\n- `la ` or `launch `\r\n Launch an app by package name.\r\n- `s [path]` or `screenshot [path]`\r\n Capture a screenshot to an auto-generated or explicit path.\r\n\r\n### Wait And Inspect\r\n\r\n- `wf [--t N]` or `waitfor ...`\r\n Wait for an element to appear.\r\n- `g ` or `get `\r\n Read an attribute such as `text`, `class`, `bounds`, `x`, `y`, or `xpath`.\r\n- `apps`\r\n List launcher apps from `/apps`.\r\n\r\n### Session\r\n\r\n- `raw`\r\n Toggle raw JSON mode.\r\n- `vars`\r\n Show current URL, timeout, raw mode, and tree cache state.\r\n- `set url http://:8080`\r\n Switch the server URL and persist it to local config.\r\n- `set timeout 30`\r\n Set the default wait timeout in seconds.\r\n- `h` or `help`\r\n Show the built-in help text.\r\n- `q` or `quit`\r\n Exit the REPL.\r\n\r\n## Common Patterns\r\n\r\n### First smoke flow\r\n\r\n1. `set url http://:8080`\r\n2. `health`\r\n3. `apps`\r\n4. `la `\r\n5. `l`\r\n6. `t `\r\n7. `i hello`\r\n8. `b`\r\n9. `s`\r\n\r\n### Find the right package before launch\r\n\r\n```text\r\napps\r\nla com.example.app\r\nl\r\n```\r\n\r\n### Inspect an element before using XPath\r\n\r\n```text\r\nl\r\nref 12\r\nx 12\r\nvx //EditText[@text='Search']\r\n```\r\n\r\n### Clear and refill an input\r\n\r\n```text\r\ni 7 --clear\r\ni 7 hello world\r\n```\r\n\r\n```text\r\nix //EditText[@text='Search'] --\r\nix //EditText[@text='Search'] -- hello world\r\n```\r\n\r\n## Troubleshooting\r\n\r\n- If an `agent-android` command fails, first check whether the AIVane app or phone-side API service has exited.\n- If `agent-android` is not found, run `uv tool update-shell`, reopen the terminal, and retry.\n- Re-open the app or restart the phone-side service, then retry `curl http://:8080/health`.\n- If `health` works but UI commands fail, run `ss` to force-refresh the tree before tapping or inputting.\r\n- If `tx` or `ix` fails, run `vx ` and make sure the XPath resolves to exactly one runtime match.\r\n- If screenshots fail the first time, confirm the on-device MediaProjection permission prompt was accepted.\r\n- If everything suddenly stops responding, confirm the phone IP did not change and that the desktop is still on the same LAN.\r\n\r\n## When To Stop\r\n\r\nStop and ask for user help when:\r\n\r\n- the device is unreachable on LAN\r\n- the app is not running and cannot be restarted from the current path\r\n- required Android permissions are missing\r\n- launcher discovery returns nothing useful\r\n- the runtime UI no longer matches the expected screen after repeated refreshes\r\n\r\n## References\r\n\r\n- Smoke checklist: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/skills/agent-android/references/smoke-flow.md)\n- Quickstart: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/quickstart.md)\n- Install guide: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/install-agent-android.md)\n- Public protocol: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/protocol-v1.md)\n- Known beta limits: [GitHub](https://github.com/aivanelabs/ai-rpa/blob/main/docs/known-limitations.md)\n\nFile v0.1.1:_meta.json\n\n{\n \"ownerId\": \"kn77cfv5yzn6q2zqaewdexqsth84z5tf\",\n \"slug\": \"agent-android\",\n \"version\": \"0.1.1\",\n \"publishedAt\": 1776312157077\n}\n\nFile v0.1.1:references/smoke-flow.md\n\n# Android REPL Smoke Flow\n\nUse this checklist when validating a fresh setup.\n\n## Preconditions\n\n- Android REPL app installed\n- API service running\n- controlling machine on the same LAN\n- `agent-android` available on `PATH`\n\n## Checklist\n\n1. Save the device URL:\n\n```text\nset url http://:8080\n```\n\n2. Check service health:\n\n```bash\ncurl http://:8080/health\n```\n\n3. List launcher apps:\n\n```bash\nagent-android --apps --url http://:8080\n```\n\n4. Launch the target app.\n5. List the current UI tree.\n6. Perform one tap.\n7. Perform one text input if relevant.\n8. Navigate back.\n\n## Success Criteria\n\n- the device responds\n- launcher apps are visible\n- launch succeeds\n- the UI tree refreshes after actions\n- the user can complete at least one inspect -> act -> inspect loop\n\nFile v0.1.1:agents/openai.yaml\n\ninterface:\n display_name: \"agent-android\"\n short_description: \"agent-android for AI agents\"\n default_prompt: \"Use $agent-android from the aivanelabs/ai-rpa repo to connect to an AIVane device over LAN, inspect launcher apps and UI state, then control the phone step by step.\"","readmeExcerpt":"Skill: agent-android Owner: crazytigerman Summary: agent-android for AI agents Tags: aivane:0.1.6, aivane-agent:0.1.6, android:0.1.6, automation:0.1.6, latest:0.1.6 Version history: v0.1.6 | 2026-04-16T04:58:01.598Z | user Shorten the ClawHub summary to highlight LAN Android control without USB, ADB, or root. v0.1.5 | 2026-04-16T04:42:36.230Z | user Clarify how to install the agent-android CLI when it is missing. v0.","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"set url http://:8080"},{"language":"bash","snippet":"curl http://:8080/health"},{"language":"bash","snippet":"curl http://:8080/health"},{"language":"bash","snippet":"agent-android --apps --url http://:8080"},{"language":"text","snippet":"set url http://:8080"},{"language":"bash","snippet":"curl http://:8080/health"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: agent-android\ndescription: Control Android over LAN without USB, ADB, or root.\nmetadata: {\"openclaw\":{\"homepage\":\"https://github.com/aivanelabs/ai-rpa\",\"requires\":{\"bins\":[\"agent-android\"]},\"install\":[{\"id\":\"agent-android-uv\",\"kind\":\"uv\",\"package\":\"aivane-agent-android\",\"bins\":[\"agent-android\"],\"label\":\"Install agent-android CLI (uv)\"}]}}\n---\n\r\n# Android REPL\r\n\r\nUse this skill to drive an Android device through the public `agent-android` beta surface published in the `aivanelabs/ai-rpa` repo.\n\nRuntime prerequisites:\n\n- `agent-android` is available on `PATH`\n- if it is missing, install the CLI with `uv tool install aivane-agent-android`; then run `uv tool update-shell` if the command is still not found\n- the user has provided a trusted device URL such as `http://:8080`\n\r\nThe public path is local-first:\r\n\r\n- the phone hosts the lightweight HTTP service locally\r\n- the desktop connects directly to `http://:8080`\r\n- UI reads, taps, inputs, and screenshots stay on the phone and controlling machine\r\n- the current tradeoff is LAN-only control; an optional server-side or relay path may arrive later\r\n\r\nIf an `agent-android` command suddenly stops working, first check whether the AIVane app or its local API service has exited on the phone.\n\n## Safety Boundaries\n\n- Connect only to a device URL explicitly provided by the user.\n- Do not scan local networks or guess device IP addresses.\n- Treat UI trees and screenshots as sensitive because they may contain private app content.\n- Save screenshots or raw UI dumps only when the user explicitly asks for a file output.\n- Ask for confirmation before operating sensitive apps, private content, account settings, or irreversible actions.\n- Do not expose the phone-side service on a public network.\n\n## Core Workflow\n\r\nEvery Android control task should follow the same short loop:\r\n\r\n1. Confirm connectivity with `/health`\r\n2. Discover the target app with `apps` if needed\r\n3. Launch one app\r\n4. Inspect the current UI tree\r\n5. Perform one action\r\n6. Inspect again\r\n\r\nKeep the loop short. Prefer inspect -> act -> inspect over long speculative command chains.\r\n\r\n## Quick Start\r\n\r\nStart the REPL with the user-provided device URL:\n\n- `agent-android --repl --url http://:8080`\n\nBuilt-in help:\n\n- `agent-android --help`\n- In the REPL: `h`\n\r\n## Essential CLI Commands\r\n\r\nUse the one-off CLI when you already know the exact action you want.\r\n\r\nConnectivity:\n\n- `agent-android --health --url http://:8080`\n\nDiscovery:\n\n- `agent-android --apps --url http://:8080`\n- `agent-android --list --url http://:8080`\n- `agent-android --id com.example:id/search --url http://:8080`\n- `agent-android --text Search --url http://:8080`\n- `agent-android --inputs --url http://:8080`\n- `agent-android --refId 7 --url http://:8080`\n- `agent-android --xpath 7 --url http://:8080`\n- `agent-android --get-attr 7 text --url http://:8080\n```\n\n2. Check service health:\n\n```bash\ncurl http://:8080/health\n```\n\n3. List launcher apps:\n\n```bash\nagent-android --apps --url http://:8080\n```\n\n4. Launch the target app.\n5. List the current UI tree.\n6. Perform one tap.\n7. Perform one text input if relevant.\n8. Navigate back.\n\n## Success Criteria\n\n- the device responds\n- launcher apps are visible\n- launch succeeds\n- the UI tree refreshes after actions\n- the user can complete at least one inspect -> act -> inspect loop"},{"path":"skill-card.md","content":"## Description:\n\nControl Android over LAN without USB, ADB, or root.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[crazytigerman](https://clawhub.ai/user/crazytigerman)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and operators use this skill to connect to a trusted Android device on the same LAN, inspect apps and UI state, and drive step-by-step tap, input, navigation, and screenshot workflows without USB, ADB, or root.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can read and control an Android device over unauthenticated plaintext LAN HTTP.\n\nMitigation: Use only a trusted device URL provided by the user, keep the phone service off public or shared Wi-Fi, and prefer an isolated trusted network or encrypted tunnel.\n\nRisk: UI trees and screenshots can expose private app content.\n\nMitigation: Use a test device or non-sensitive apps when possible, ask for confirmation before sensitive or irreversible actions, and save screenshots or raw UI dumps only when explicitly requested.\n\nRisk: The uv-installed dependency is not version-pinned in the skill metadata.\n\nMitigation: Review the upstream package before installation and confirm the installed package version is acceptable for the deployment.\n\n## Reference(s):\n\n- [Project homepage](https://github.com/aivanelabs/ai-rpa)\n- [Smoke checklist](https://github.com/aivanelabs/ai-rpa/blob/main/skills/agent-android/references/smoke-flow.md)\n- [Quickstart](https://github.com/aivanelabs/ai-rpa/blob/main/docs/quickstart.md)\n- [Install guide](https://github.com/aivanelabs/ai-rpa/blob/main/docs/install-agent-android.md)\n- [Public protocol](https://github.com/aivanelabs/ai-rpa/blob/main/docs/protocol-v1.md)\n- [Known beta limits](https://github.com/aivanelabs/ai-rpa/blob/main/docs/known-limitations.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown with inline shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include user-approved Android control commands, trusted device URL placeholders, and screenshot file paths when explicitly requested.]\n\n## Skill Version(s):\n\n0.1.6 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."},{"path":"agents/openai.yaml","content":"interface:\n display_name: \"agent-android\"\n short_description: \"agent-android for AI agents\"\n default_prompt: \"Use $agent-android from the aivanelabs/ai-rpa repo to connect to an AIVane device over LAN, inspect launcher apps and UI state, then control the phone step by step.\""}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1316,"uniquenessScore":44,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T09:19:56.618Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T09:19:56.618Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T11:22:42.557Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}