OpenClaw 新功能：3 步获取 Android 已安装应用列表

一句话总结：OpenClaw 最新提交的 installed apps 节点命令，让 AI Agent 无需 root 权限即可读取 Android 设备上的已安装应用信息，大幅提升移动自动化场景的构建效率。

在移动自动化测试、设备管理、企业安全合规等场景中，获取目标设备的应用列表是高频需求。传统方案需要编写复杂的 ADB 脚本或集成第三方 SDK，而 OpenClaw 作为开源 AI Agent 框架，通过新增的 installed apps node command，将这一能力封装为标准化节点，开发者只需几行配置即可调用。

功能背景：为什么需要这个命令？

Android 应用生态复杂多样，AI Agent 在执行任务前往往需要感知设备环境：

此前，OpenClaw 的 Android 节点主要覆盖屏幕操作、元素定位等交互能力，应用信息读取一直是能力缺口。本次更新填补了这一空白。

技术实现详解

核心能力

installed apps 命令通过 Android Accessibility Service 与 PackageManager API 组合实现，支持获取：

• 应用包名（package name）
• 应用显示名称
• 版本号
• 安装来源（系统预装/用户安装）
• 是否启用状态

基础使用示例

在 OpenClaw 工作流中，添加节点配置如下：

# OpenClaw 新功能：3 步获取 Android 已安装应用列表
nodes:
  - id: get_installed_apps
    type: android:installed_apps
    params:
      include_system_apps: false    # 是否包含系统应用
      filter_by_source: "user"       # 筛选：user | system | all
    output: apps_list               # 输出变量名

执行后，apps_list 将包含结构化数据：

[
  {
    "packageName": "com.example.app",
    "appName": "示例应用",
    "versionName": "2.5.1",
    "versionCode": 20501,
    "isSystemApp": false,
    "isEnabled": true,
    "installTime": "2024-01-15T08:30:00Z"
  }
]

与 AI 决策结合

结合 OpenClaw 的 LLM 节点，可实现智能判断：

nodes:
  - id: check_target_app
    type: android:installed_apps
    params: { filter_by_source: "all" }
    output: apps

  - id: ai_decision
    type: llm:analyze
    prompt: |
      目标应用 com.target.app 是否已安装？
      已安装应用列表：{{apps}}
      如果未安装，返回 {"action": "install", "reason": "..."}
      如果已安装但版本低于 3.0，返回 {"action": "update", "reason": "..."}
      否则返回 {"action": "launch"}

进阶配置与最佳实践

1. 性能优化：分页与缓存

设备应用数量可能超过 500+，建议启用分页：

params:
  pagination:
    enabled: true
    page_size: 100
    max_pages: 5          # 限制最大采集页数
  cache_ttl: 300          # 缓存 5 分钟，避免重复查询

2. 安全合规：敏感应用过滤

企业场景下，可配置黑名单排除敏感应用：

params:
  exclude_packages:
    - "com.android.settings"
    - "com.bank.*"        # 支持通配符
  hash_sensitive_names: true   # 对应用名做哈希处理，保护隐私

3. 命令行快速调试

通过 OpenClaw CLI 本地验证：

# 连接设备并执行
openclaw android:installed-apps \
  --device-id emulator-5554 \
  --include-system=false \
  --output-format json > apps.json

# 结合 jq 快速筛选
cat apps.json | jq '.[] | select(.installTime > "2024-06-01")'

版本兼容性与限制

完整兼容性矩阵请参考 OpenClaw 文档^[1]

常见问题 (FAQ)

Q1: 这个命令需要 root 权限吗？

不需要。installed apps 基于标准 Android API 实现，只需设备开启 USB 调试模式，并通过 adb 授权即可。但部分厂商（如华为、小米）的隐私保护机制可能限制后台应用读取，建议在自动化测试场景中配合 OpenClaw 的屏幕解锁节点使用。

Q2: 能获取应用的详细权限列表吗？

当前版本仅返回基础元数据（包名、版本等）。如需权限详情，建议组合使用 android:app_info 节点（预计 v0.9.2 发布）或调用 dumpsys package <package> 命令自行解析。

Q3: 如何过滤特定类型的应用（如游戏、金融类）？

OpenClaw 本身不提供应用分类能力，但可通过输出数据的 packageName 结合第三方库（如 Google Play Category API^[2]）或本地映射表实现分类。示例代码：

// 自定义过滤逻辑
const gameKeywords = ['game', 'play', 'arena'];
const isGame = apps.filter(app => 
  gameKeywords.some(kw => app.appName.toLowerCase().includes(kw))
);

Q4: 与 Appium、UI Automator 相比有什么优势？

Q5: 这个命令会触发应用商店的反爬机制吗？

不会。installed apps 仅读取本地 PackageManager 数据库，不产生网络请求。但如将数据批量上传至云端，建议遵守目标平台的服务条款，并对敏感字段做脱敏处理。

总结与下一步

installed apps node command 的上线，标志着 OpenClaw 在移动设备感知能力上的重要进展。核心价值在于：

1. 零代码集成：YAML 配置替代复杂 ADB 脚本
2. AI 原生设计：输出格式直接适配 LLM 推理
3. 企业级安全：内置脱敏与权限控制选项

建议下一步行动：

• 升级至 OpenClaw v0.9.1+ 体验新功能：pip install -U openclaw
• 查阅 OpenClaw Android 节点文档^[3] 了解更多能力
• 在 GitHub Discussions 分享你的使用场景

相关阅读

• OpenClaw 快速入门：搭建你的第一个 AI Agent^[4]
• Android 自动化测试最佳实践^[5]
• OpenClaw 节点开发指南：自定义扩展^[6]

参考来源

• GitHub Commit: feat(android): add installed apps node command^[7]
• OpenClaw 官方文档^[8]
• Android PackageManager API 参考^[9]
• 阅读原文：OpenClaw 教学小站^[10]

引用链接