{
  "schemaVersion": "1.0",
  "item": {
    "slug": "android-agent",
    "name": "android-agent",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/harshilmathur/android-agent",
    "canonicalUrl": "https://clawhub.ai/harshilmathur/android-agent",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/android-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=android-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "examples/tasks.md",
      "requirements.txt",
      "scripts/connect.sh",
      "scripts/run-task.py",
      "scripts/screenshot.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/android-agent"
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/android-agent",
    "agentPageUrl": "https://openagent3.xyz/skills/android-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/android-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/android-agent/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "android-agent — AI-Powered Android Phone Control",
        "body": "Plug your old Android phone into your Mac/PC. Now your AI assistant can use it.\n\nGot an old Android in a drawer? Connect it to any machine running OpenClaw — your gateway, a Mac Mini, a Raspberry Pi. Your AI can now open apps, tap buttons, type text, and complete tasks on a real phone. Book a cab, order food, check your bank app — anything you'd do with your thumbs."
      },
      {
        "title": "How It Works",
        "body": "Your AI agent sees the phone screen (via screenshots), decides what to tap/type/swipe, and executes actions via ADB. Under the hood it uses DroidRun with GPT-4o vision.\n\n┌─────────────┐    screenshots    ┌──────────────┐    ADB commands    ┌─────────────┐\n│  GPT-4o     │◄─────────────────│  DroidRun    │──────────────────►│  Android    │\n│  Vision     │─────────────────►│  Agent       │◄──────────────────│  Phone      │\n│             │   tap/type/swipe  │              │    screen state    │             │\n└─────────────┘                   └──────────────┘                    └─────────────┘"
      },
      {
        "title": "Direct Mode",
        "body": "Phone plugged into your OpenClaw gateway machine via USB. Zero networking required.\n\n[Gateway Machine] ──USB──► [Android Phone]"
      },
      {
        "title": "Node Mode",
        "body": "Phone plugged into a Mac Mini, Raspberry Pi, or any OpenClaw node. The gateway controls it over the network.\n\n[Gateway] ──network──► [Mac Mini / Pi node] ──USB──► [Android Phone]\n\nFor Node mode, connect ADB over TCP/WiFi so the node can forward commands."
      },
      {
        "title": "1. Enable USB Debugging",
        "body": "On your Android phone:\n\nGo to Settings → About Phone\nTap Build Number 7 times to enable Developer Options\nGo to Settings → Developer Options\nEnable USB Debugging"
      },
      {
        "title": "2. Connect & Install",
        "body": "# Plug phone in via USB, then:\npip install -r requirements.txt\nadb devices  # verify phone shows up — authorize on phone if prompted"
      },
      {
        "title": "3. Run Your First Task",
        "body": "export OPENAI_API_KEY=\"sk-...\"\npython scripts/run-task.py \"Open Settings and turn on Dark Mode\"\n\nThat's it. The script handles everything: waking the screen, unlocking, keeping the display on, and running your task."
      },
      {
        "title": "📱 Daily Life",
        "body": "python scripts/run-task.py \"Order an Uber to the airport\"\npython scripts/run-task.py \"Set an alarm for 6 AM tomorrow\"\npython scripts/run-task.py \"Check my bank balance on PhonePe\"\npython scripts/run-task.py \"Open Google Maps and navigate to the nearest coffee shop\""
      },
      {
        "title": "💬 Messaging",
        "body": "python scripts/run-task.py \"Send a WhatsApp message to Mom saying I'll be late\"\npython scripts/run-task.py \"Read my latest SMS messages\"\npython scripts/run-task.py \"Open Telegram and check unread messages\""
      },
      {
        "title": "🛒 Shopping",
        "body": "python scripts/run-task.py \"Open Amazon and search for wireless earbuds under 2000 rupees\"\npython scripts/run-task.py \"Add milk and bread to my Instamart cart\""
      },
      {
        "title": "📅 Productivity",
        "body": "python scripts/run-task.py \"Open Google Calendar and check my schedule for tomorrow\"\npython scripts/run-task.py \"Create a new note in Google Keep: Buy groceries\""
      },
      {
        "title": "🎵 Entertainment",
        "body": "python scripts/run-task.py \"Play my Discover Weekly playlist on Spotify\"\npython scripts/run-task.py \"Open YouTube and search for lo-fi study music\""
      },
      {
        "title": "⚙️ Settings & Setup",
        "body": "python scripts/run-task.py \"Turn on Dark Mode\"\npython scripts/run-task.py \"Connect to my home WiFi network\"\npython scripts/run-task.py \"Enable Do Not Disturb mode\"\npython scripts/run-task.py \"Turn off Bluetooth\""
      },
      {
        "title": "📸 Utilities",
        "body": "python scripts/run-task.py \"Take a screenshot\"\npython scripts/run-task.py \"Open the camera and take a photo\"\npython scripts/run-task.py \"Clear all notifications\""
      },
      {
        "title": "Environment Variables",
        "body": "VariableRequiredDescriptionOPENAI_API_KEYYesAPI key for GPT-4o visionANDROID_SERIALNoDevice serial number. Auto-detected if only one device is connectedANDROID_PINNoPhone PIN/password for auto-unlock. If not set, unlock is skippedDROIDRUN_TIMEOUTNoTask timeout in seconds (default: 120)"
      },
      {
        "title": "Direct Mode (USB)",
        "body": "Install ADB:\n# macOS\nbrew install android-platform-tools\n\n# Ubuntu/Debian\nsudo apt install android-tools-adb\n\n# Windows\n# Download from https://developer.android.com/tools/releases/platform-tools\n\n\n\nConnect phone via USB and verify:\n./scripts/connect.sh usb\n\n\n\nInstall DroidRun Portal APK on the phone:\n\nDownload from DroidRun releases\nOr sideload: adb install droidrun-portal.apk\nOpen the Portal app on the phone and grant accessibility permissions\n\n\n\nInstall Python dependencies:\npip install -r requirements.txt"
      },
      {
        "title": "Node Mode (Remote via WiFi/TCP)",
        "body": "On the node machine (Mac Mini, Pi, etc.), connect the phone via USB and enable WiFi ADB:\nadb tcpip 5555\nadb connect <phone-ip>:5555\n\n\n\nFrom your gateway, connect to the node's ADB:\n# If using SSH tunnel:\nssh -L 15555:<phone-ip>:5555 user@node-ip\nexport ANDROID_SERIAL=\"127.0.0.1:15555\"\n\n# Or direct WiFi (same network):\n./scripts/connect.sh wifi <phone-ip>\n\n\n\nRun tasks as normal — the script uses whatever ANDROID_SERIAL points to."
      },
      {
        "title": "DroidRun Portal Setup",
        "body": "The DroidRun Portal APK must be installed and running on the phone. It provides the accessibility service that allows DroidRun to read screen content and interact with UI elements.\n\nInstall the APK (download from DroidRun GitHub releases)\nOpen the Portal app\nGrant Accessibility Service permission when prompted\nKeep it running in the background"
      },
      {
        "title": "scripts/run-task.py — The Main Script",
        "body": "# Basic usage\npython scripts/run-task.py \"Your task description here\"\n\n# With options\npython scripts/run-task.py --timeout 180 \"Install Spotify from Play Store\"\npython scripts/run-task.py --model gpt-4o \"Open Chrome and search for weather\"\npython scripts/run-task.py --no-unlock \"Take a screenshot\"\npython scripts/run-task.py --serial 127.0.0.1:15555 \"Check notifications\"\npython scripts/run-task.py --verbose \"Open Settings\"\n\nOptions:\n\nFlagDescriptiongoalTask description (positional, required)--timeoutTimeout in seconds (default: 120, or DROIDRUN_TIMEOUT env)--modelLLM model to use (default: gpt-4o)--no-unlockSkip the auto-unlock step--serialDevice serial (default: ANDROID_SERIAL env or auto-detect)--verboseShow detailed debug output"
      },
      {
        "title": "scripts/connect.sh — Setup & Verify Connection",
        "body": "./scripts/connect.sh          # Auto-detect USB device\n./scripts/connect.sh usb      # USB mode (explicit)\n./scripts/connect.sh wifi 192.168.1.100  # WiFi/TCP mode"
      },
      {
        "title": "scripts/screenshot.sh — Screenshot (ADB screencap, reliable)",
        "body": "DroidRun’s internal screenshot sometimes fails on certain devices. Use this to bypass DroidRun and capture a PNG directly via ADB.\n\n# Save to /tmp/android-screenshot.png\n./scripts/screenshot.sh\n\n# Explicit serial + output path\n./scripts/screenshot.sh 127.0.0.1:15555 /tmp/a03.png\n\nYou can also do it from Python:\n\npython scripts/run-task.py --screenshot --serial 127.0.0.1:15555 --screenshot-path /tmp/a03.png"
      },
      {
        "title": "scripts/status.sh — Device Status",
        "body": "./scripts/status.sh\n# Output:\n# 📱 Device: Samsung Galaxy A03 (SM-A035F)\n# 🤖 Android: 11 (API 30)\n# 🔋 Battery: 87%\n# 📺 Screen: ON (unlocked)\n# 🔌 Connection: USB\n# 📦 DroidRun Portal: installed (v0.5.5)"
      },
      {
        "title": "\"no devices/emulators found\"",
        "body": "Check USB cable (use a data cable, not charge-only)\nAuthorize the computer on your phone's USB debugging prompt\nTry adb kill-server && adb start-server"
      },
      {
        "title": "\"device unauthorized\"",
        "body": "Disconnect and reconnect USB\nCheck the phone screen for an authorization dialog\nIf no dialog appears, revoke USB debugging authorizations in Developer Options and reconnect"
      },
      {
        "title": "Phone screen turns off during task",
        "body": "The script sets keep-awake mode automatically, but some phones override this\nManually: Settings → Developer Options → Stay Awake (while charging)"
      },
      {
        "title": "Task fails with dialog/popup blocking",
        "body": "The script tries to dismiss common dialogs automatically\nFor persistent popups, dismiss them manually first, then retry\nUse --verbose to see what the agent is seeing"
      },
      {
        "title": "WiFi ADB disconnects after reboot",
        "body": "WiFi ADB mode resets on phone reboot — you need to re-enable it via USB\nRun ./scripts/connect.sh usb first, then ./scripts/connect.sh wifi <ip>"
      },
      {
        "title": "DroidRun agent seems confused",
        "body": "Make sure DroidRun Portal is running and accessibility service is enabled\nClose unnecessary apps to reduce screen complexity\nTry a simpler task first to verify the setup works"
      },
      {
        "title": "PIN unlock fails",
        "body": "PIN pad button coordinates vary by device and screen resolution\nTo find your device's coordinates: adb shell getevent -l and tap each digit\nOr use adb shell input text <PIN> as a fallback on some devices\nSet ANDROID_PIN environment variable (never hardcode it)"
      },
      {
        "title": "Security",
        "body": "ADB grants full device access — only connect devices you trust and own\nScreenshots are sent to your LLM provider (OpenAI by default) — be mindful of sensitive content on screen (banking apps, private messages)\nPIN is read from environment variable only — never stored in files or logs\nWiFi ADB is unencrypted — use USB or an SSH tunnel on untrusted networks\nDroidRun Portal requires accessibility permissions — this is powerful access; understand what it enables"
      },
      {
        "title": "Requirements",
        "body": "Python 3.10+\nADB (Android Debug Bridge)\nAndroid 8.0+ phone with Developer Options and USB Debugging enabled\nDroidRun Portal APK installed on phone\nOpenAI API key (GPT-4o for vision capabilities)\nUSB data cable (not charge-only)"
      },
      {
        "title": "⚠️ Security Notes",
        "body": "Use a dedicated test device, not your primary phone.\n\nScreenshots & screen text go to OpenAI. Every screenshot the agent takes is sent to GPT-4o for vision processing. Don't run this on devices with sensitive data visible — banking apps, 2FA tokens, private messages, medical info. If it's on screen, it's sent to the cloud.\nANDROID_PIN is stored as an environment variable. While it's never written to files or logs, anyone with access to the host's environment can read it. Use a disposable device PIN you don't use elsewhere, or accept the risk.\nOnly install DroidRun Portal from official sources. Download the APK exclusively from DroidRun GitHub releases. Never sideload APKs from third-party sites.\nADB grants full device access. Combined with accessibility permissions, this is effectively root-level control. Only connect devices you own and are comfortable exposing.\nWiFi ADB is unencrypted. If using TCP/WiFi mode on an untrusted network, wrap it in an SSH tunnel.\n\nBottom line: Treat the connected phone as a \"work device for AI.\" Don't leave personal accounts logged in. Don't store secrets on it. If you wouldn't hand your unlocked phone to a stranger, don't point this skill at it."
      },
      {
        "title": "License",
        "body": "MIT — see LICENSE"
      }
    ],
    "body": "android-agent — AI-Powered Android Phone Control\n\nPlug your old Android phone into your Mac/PC. Now your AI assistant can use it.\n\nGot an old Android in a drawer? Connect it to any machine running OpenClaw — your gateway, a Mac Mini, a Raspberry Pi. Your AI can now open apps, tap buttons, type text, and complete tasks on a real phone. Book a cab, order food, check your bank app — anything you'd do with your thumbs.\n\nHow It Works\n\nYour AI agent sees the phone screen (via screenshots), decides what to tap/type/swipe, and executes actions via ADB. Under the hood it uses DroidRun with GPT-4o vision.\n\n┌─────────────┐    screenshots    ┌──────────────┐    ADB commands    ┌─────────────┐\n│  GPT-4o     │◄─────────────────│  DroidRun    │──────────────────►│  Android    │\n│  Vision     │─────────────────►│  Agent       │◄──────────────────│  Phone      │\n│             │   tap/type/swipe  │              │    screen state    │             │\n└─────────────┘                   └──────────────┘                    └─────────────┘\n\nWorks Two Ways\nDirect Mode\n\nPhone plugged into your OpenClaw gateway machine via USB. Zero networking required.\n\n[Gateway Machine] ──USB──► [Android Phone]\n\nNode Mode\n\nPhone plugged into a Mac Mini, Raspberry Pi, or any OpenClaw node. The gateway controls it over the network.\n\n[Gateway] ──network──► [Mac Mini / Pi node] ──USB──► [Android Phone]\n\n\nFor Node mode, connect ADB over TCP/WiFi so the node can forward commands.\n\nQuick Start (3 steps)\n1. Enable USB Debugging\n\nOn your Android phone:\n\nGo to Settings → About Phone\nTap Build Number 7 times to enable Developer Options\nGo to Settings → Developer Options\nEnable USB Debugging\n2. Connect & Install\n# Plug phone in via USB, then:\npip install -r requirements.txt\nadb devices  # verify phone shows up — authorize on phone if prompted\n\n3. Run Your First Task\nexport OPENAI_API_KEY=\"sk-...\"\npython scripts/run-task.py \"Open Settings and turn on Dark Mode\"\n\n\nThat's it. The script handles everything: waking the screen, unlocking, keeping the display on, and running your task.\n\nWhat Can It Do?\n📱 Daily Life\npython scripts/run-task.py \"Order an Uber to the airport\"\npython scripts/run-task.py \"Set an alarm for 6 AM tomorrow\"\npython scripts/run-task.py \"Check my bank balance on PhonePe\"\npython scripts/run-task.py \"Open Google Maps and navigate to the nearest coffee shop\"\n\n💬 Messaging\npython scripts/run-task.py \"Send a WhatsApp message to Mom saying I'll be late\"\npython scripts/run-task.py \"Read my latest SMS messages\"\npython scripts/run-task.py \"Open Telegram and check unread messages\"\n\n🛒 Shopping\npython scripts/run-task.py \"Open Amazon and search for wireless earbuds under 2000 rupees\"\npython scripts/run-task.py \"Add milk and bread to my Instamart cart\"\n\n📅 Productivity\npython scripts/run-task.py \"Open Google Calendar and check my schedule for tomorrow\"\npython scripts/run-task.py \"Create a new note in Google Keep: Buy groceries\"\n\n🎵 Entertainment\npython scripts/run-task.py \"Play my Discover Weekly playlist on Spotify\"\npython scripts/run-task.py \"Open YouTube and search for lo-fi study music\"\n\n⚙️ Settings & Setup\npython scripts/run-task.py \"Turn on Dark Mode\"\npython scripts/run-task.py \"Connect to my home WiFi network\"\npython scripts/run-task.py \"Enable Do Not Disturb mode\"\npython scripts/run-task.py \"Turn off Bluetooth\"\n\n📸 Utilities\npython scripts/run-task.py \"Take a screenshot\"\npython scripts/run-task.py \"Open the camera and take a photo\"\npython scripts/run-task.py \"Clear all notifications\"\n\nEnvironment Variables\nVariable\tRequired\tDescription\nOPENAI_API_KEY\tYes\tAPI key for GPT-4o vision\nANDROID_SERIAL\tNo\tDevice serial number. Auto-detected if only one device is connected\nANDROID_PIN\tNo\tPhone PIN/password for auto-unlock. If not set, unlock is skipped\nDROIDRUN_TIMEOUT\tNo\tTask timeout in seconds (default: 120)\nSetup Details\nDirect Mode (USB)\n\nInstall ADB:\n\n# macOS\nbrew install android-platform-tools\n\n# Ubuntu/Debian\nsudo apt install android-tools-adb\n\n# Windows\n# Download from https://developer.android.com/tools/releases/platform-tools\n\n\nConnect phone via USB and verify:\n\n./scripts/connect.sh usb\n\n\nInstall DroidRun Portal APK on the phone:\n\nDownload from DroidRun releases\nOr sideload: adb install droidrun-portal.apk\nOpen the Portal app on the phone and grant accessibility permissions\n\nInstall Python dependencies:\n\npip install -r requirements.txt\n\nNode Mode (Remote via WiFi/TCP)\n\nOn the node machine (Mac Mini, Pi, etc.), connect the phone via USB and enable WiFi ADB:\n\nadb tcpip 5555\nadb connect <phone-ip>:5555\n\n\nFrom your gateway, connect to the node's ADB:\n\n# If using SSH tunnel:\nssh -L 15555:<phone-ip>:5555 user@node-ip\nexport ANDROID_SERIAL=\"127.0.0.1:15555\"\n\n# Or direct WiFi (same network):\n./scripts/connect.sh wifi <phone-ip>\n\n\nRun tasks as normal — the script uses whatever ANDROID_SERIAL points to.\n\nDroidRun Portal Setup\n\nThe DroidRun Portal APK must be installed and running on the phone. It provides the accessibility service that allows DroidRun to read screen content and interact with UI elements.\n\nInstall the APK (download from DroidRun GitHub releases)\nOpen the Portal app\nGrant Accessibility Service permission when prompted\nKeep it running in the background\nScript Reference\nscripts/run-task.py — The Main Script\n# Basic usage\npython scripts/run-task.py \"Your task description here\"\n\n# With options\npython scripts/run-task.py --timeout 180 \"Install Spotify from Play Store\"\npython scripts/run-task.py --model gpt-4o \"Open Chrome and search for weather\"\npython scripts/run-task.py --no-unlock \"Take a screenshot\"\npython scripts/run-task.py --serial 127.0.0.1:15555 \"Check notifications\"\npython scripts/run-task.py --verbose \"Open Settings\"\n\n\nOptions:\n\nFlag\tDescription\ngoal\tTask description (positional, required)\n--timeout\tTimeout in seconds (default: 120, or DROIDRUN_TIMEOUT env)\n--model\tLLM model to use (default: gpt-4o)\n--no-unlock\tSkip the auto-unlock step\n--serial\tDevice serial (default: ANDROID_SERIAL env or auto-detect)\n--verbose\tShow detailed debug output\nscripts/connect.sh — Setup & Verify Connection\n./scripts/connect.sh          # Auto-detect USB device\n./scripts/connect.sh usb      # USB mode (explicit)\n./scripts/connect.sh wifi 192.168.1.100  # WiFi/TCP mode\n\nscripts/screenshot.sh — Screenshot (ADB screencap, reliable)\n\nDroidRun’s internal screenshot sometimes fails on certain devices. Use this to bypass DroidRun and capture a PNG directly via ADB.\n\n# Save to /tmp/android-screenshot.png\n./scripts/screenshot.sh\n\n# Explicit serial + output path\n./scripts/screenshot.sh 127.0.0.1:15555 /tmp/a03.png\n\n\nYou can also do it from Python:\n\npython scripts/run-task.py --screenshot --serial 127.0.0.1:15555 --screenshot-path /tmp/a03.png\n\nscripts/status.sh — Device Status\n./scripts/status.sh\n# Output:\n# 📱 Device: Samsung Galaxy A03 (SM-A035F)\n# 🤖 Android: 11 (API 30)\n# 🔋 Battery: 87%\n# 📺 Screen: ON (unlocked)\n# 🔌 Connection: USB\n# 📦 DroidRun Portal: installed (v0.5.5)\n\nTroubleshooting\n\"no devices/emulators found\"\nCheck USB cable (use a data cable, not charge-only)\nAuthorize the computer on your phone's USB debugging prompt\nTry adb kill-server && adb start-server\n\"device unauthorized\"\nDisconnect and reconnect USB\nCheck the phone screen for an authorization dialog\nIf no dialog appears, revoke USB debugging authorizations in Developer Options and reconnect\nPhone screen turns off during task\nThe script sets keep-awake mode automatically, but some phones override this\nManually: Settings → Developer Options → Stay Awake (while charging)\nTask fails with dialog/popup blocking\nThe script tries to dismiss common dialogs automatically\nFor persistent popups, dismiss them manually first, then retry\nUse --verbose to see what the agent is seeing\nWiFi ADB disconnects after reboot\nWiFi ADB mode resets on phone reboot — you need to re-enable it via USB\nRun ./scripts/connect.sh usb first, then ./scripts/connect.sh wifi <ip>\nDroidRun agent seems confused\nMake sure DroidRun Portal is running and accessibility service is enabled\nClose unnecessary apps to reduce screen complexity\nTry a simpler task first to verify the setup works\nPIN unlock fails\nPIN pad button coordinates vary by device and screen resolution\nTo find your device's coordinates: adb shell getevent -l and tap each digit\nOr use adb shell input text <PIN> as a fallback on some devices\nSet ANDROID_PIN environment variable (never hardcode it)\nSecurity\nADB grants full device access — only connect devices you trust and own\nScreenshots are sent to your LLM provider (OpenAI by default) — be mindful of sensitive content on screen (banking apps, private messages)\nPIN is read from environment variable only — never stored in files or logs\nWiFi ADB is unencrypted — use USB or an SSH tunnel on untrusted networks\nDroidRun Portal requires accessibility permissions — this is powerful access; understand what it enables\nRequirements\nPython 3.10+\nADB (Android Debug Bridge)\nAndroid 8.0+ phone with Developer Options and USB Debugging enabled\nDroidRun Portal APK installed on phone\nOpenAI API key (GPT-4o for vision capabilities)\nUSB data cable (not charge-only)\n⚠️ Security Notes\n\nUse a dedicated test device, not your primary phone.\n\nScreenshots & screen text go to OpenAI. Every screenshot the agent takes is sent to GPT-4o for vision processing. Don't run this on devices with sensitive data visible — banking apps, 2FA tokens, private messages, medical info. If it's on screen, it's sent to the cloud.\nANDROID_PIN is stored as an environment variable. While it's never written to files or logs, anyone with access to the host's environment can read it. Use a disposable device PIN you don't use elsewhere, or accept the risk.\nOnly install DroidRun Portal from official sources. Download the APK exclusively from DroidRun GitHub releases. Never sideload APKs from third-party sites.\nADB grants full device access. Combined with accessibility permissions, this is effectively root-level control. Only connect devices you own and are comfortable exposing.\nWiFi ADB is unencrypted. If using TCP/WiFi mode on an untrusted network, wrap it in an SSH tunnel.\n\nBottom line: Treat the connected phone as a \"work device for AI.\" Don't leave personal accounts logged in. Don't store secrets on it. If you wouldn't hand your unlocked phone to a stranger, don't point this skill at it.\n\nLicense\n\nMIT — see LICENSE"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/harshilmathur/android-agent",
    "publisherUrl": "https://clawhub.ai/harshilmathur/android-agent",
    "owner": "harshilmathur",
    "version": "1.1.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/android-agent",
    "downloadUrl": "https://openagent3.xyz/downloads/android-agent",
    "agentUrl": "https://openagent3.xyz/skills/android-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/android-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/android-agent/agent.md"
  }
}