← 返回 Skills 市场
fengyang0317

adb controller

作者 Yang Feng · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
485
总下载
0
收藏
2
当前安装
1
版本数
在 OpenClaw 中安装
/install adb-controller
功能描述
Control an Android device via ADB. Use when the user asks to control an Android device, tap, swipe, input text, or perform actions via adb. Automatically use...
使用说明 (SKILL.md)

ADB Controller

This skill allows you to execute ADB (Android Debug Bridge) commands on a connected Android device and automatically retrieve a screenshot of the result.

Configuration

The user can configure the target ADB device/server in their openclaw.json (this is automatically read by the script):

{
  "skills": {
    "entries": {
      "adb-controller": {
        "adbServer": "192.168.1.100:5555" // or device serial
      }
    }
  }
}

Usage

To run an ADB command, execute the provided Python script:

python3 ~/.openclaw/workspace/skills/adb-controller/scripts/run_adb.py shell input tap x y

You can pass any standard ADB arguments to the script. For example:

  • python3 .../run_adb.py shell input text "hello"
  • python3 .../run_adb.py shell input keyevent 26 (Power button)
  • python3 .../run_adb.py shell swipe 500 1000 500 500

Workflow (Mandatory)

  1. Understand the user's intent and determine the correct ADB command.
  2. Execute the user's requested action using the run_adb.py script via the exec tool.
  3. The script will output the path to a newly captured screenshot.
  4. Send the Image: You MUST use the message tool (with action="send" and media="\x3Cpath-to-screenshot>") to send the resulting screenshot to the user, allowing them to see the outcome of the action. Do not just output the file path.
安全使用建议
This skill's code does what its description claims (runs adb commands and captures screenshots) but there are some inconsistencies and small risks you should consider before using it: 1) The Python script requires the local 'adb' binary but the skill metadata does not declare that dependency — ensure adb is installed and available on PATH. 2) The SKILL.md says it will read openclaw.json for the target, but the script actually uses the ADB_SERVER_ADDRESS environment variable; confirm which configuration your environment will provide so it doesn't connect to an unexpected device or remote adb server. 3) Because the script may run 'adb connect <host:port>', it can connect to networked devices — only use this skill with servers/devices you trust. 4) If you don't trust the skill's source, review or run the included script in an isolated environment first. Recommended actions: ask the author to (a) declare the 'adb' binary and ADB_SERVER_ADDRESS in metadata, or (b) update the script to actually parse openclaw.json as documented; audit the script yourself before granting it access to any real devices.
功能分析
Type: OpenClaw Skill Name: adb-controller Version: 1.0.0 The adb-controller skill provides a legitimate interface for managing Android devices via the Android Debug Bridge (ADB). The script `run_adb.py` uses safe subprocess execution (passing arguments as a list) to prevent shell injection and includes a transparent workflow in `SKILL.md` that ensures the user receives visual feedback via screenshots. No evidence of malicious intent, data exfiltration, or unauthorized persistence was found.
能力评估
Purpose & Capability
Purpose (control Android via ADB, tap/swipe/input, take screenshots) aligns with included code: the Python script runs adb commands and captures screenshots. However, the skill fails to declare a required runtime dependency: the script invokes the 'adb' binary but the skill metadata lists no required binaries. Also SKILL.md says the ADB target is read from openclaw.json, while the script actually reads an environment variable (ADB_SERVER_ADDRESS) — this mismatch is unexpected.
Instruction Scope
SKILL.md instructs the agent to read openclaw.json for adbServer and to run the script and then always send the screenshot. The script does not parse openclaw.json; it reads ADB_SERVER_ADDRESS from the environment and will attempt to connect (adb connect) if the value contains a colon. That gives the skill the ability to connect to arbitrary network adb servers if the env var or agent environment is set, which is broader than documentation indicates.
Install Mechanism
This is an instruction-only skill with no install spec and a small included script. No package downloads or archive extraction are present.
Credentials
The script depends on an environment variable (ADB_SERVER_ADDRESS) but the skill metadata does not declare any required env vars. That hidden dependency can change which device/server the skill connects to at runtime. No other secrets are requested, but the unlisted env var and the ability to connect to remote adb servers are notable.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide settings. It writes screenshots to the user's ~/.openclaw/workspace directory (its own workspace), which is consistent with its function.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install adb-controller
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /adb-controller 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of adb-controller skill: - Enables control of Android devices using ADB commands executed via a provided Python script. - Automatically captures and returns a screenshot after each command. - Reads ADB server/device info from openclaw.json for automatic configuration. - Requires sending the screenshot result to the user after each action.
元数据
Slug adb-controller
版本 1.0.0
许可证
累计安装 4
当前安装数 2
历史版本数 1
常见问题

adb controller 是什么?

Control an Android device via ADB. Use when the user asks to control an Android device, tap, swipe, input text, or perform actions via adb. Automatically use... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 485 次。

如何安装 adb controller?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install adb-controller」即可一键安装,无需额外配置。

adb controller 是免费的吗?

是的,adb controller 完全免费(开源免费),可自由下载、安装和使用。

adb controller 支持哪些平台?

adb controller 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 adb controller?

由 Yang Feng(@fengyang0317)开发并维护,当前版本 v1.0.0。

💬 留言讨论