——
OpenClaw 新功能：3 步获取 Android 已安装应用列表
一句话总结：OpenClaw 最新提交的 installed apps 节点命令，让 AI Agent 无需 root 权限即可读取 Android 设备上的已安装应用信息，大幅提升移动自动化场景的构建效率。
在移动自动化测试、设备管理、企业安全合规等场景中，获取目标设备的应用列表是高频需求。传统方案需要编写复杂的 ADB 脚本或集成第三方 SDK，而 OpenClaw 作为开源 AI Agent 框架，通过新增的 installed apps node command，将这一能力封装为标准化节点，开发者只需几行配置即可调用。
—
功能背景：为什么需要这个命令？
Android 应用生态复杂多样，AI Agent 在执行任务前往往需要感知设备环境：
| 应用场景 | 具体需求 |
|———|———|
| 自动化测试 | 判断被测应用是否已安装，决定安装/启动策略 |
| 企业 MDM | 扫描违规应用，生成合规报告 |
| 智能客服 | 根据用户已装应用推荐解决方案 |
| 竞品分析 | 批量采集设备应用分布数据 |
此前，OpenClaw 的 Android 节点主要覆盖屏幕操作、元素定位等交互能力，应用信息读取一直是能力缺口。本次更新填补了这一空白。
—
技术实现详解
核心能力
installed apps 命令通过 Android Accessibility Service 与 PackageManager API 组合实现，支持获取：
- 应用包名（package name）
- 应用显示名称
- 版本号
- 安装来源（系统预装/用户安装）
- 是否启用状态
基础使用示例
在 OpenClaw 工作流中，添加节点配置如下：
workflow.yaml
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")'
—
版本兼容性与限制
| 项目 | 说明 |
|—–|——|
| 最低 Android 版本 | API 21 (Android 5.0) |
| 特殊权限 | 无需 root，需开启 USB 调试 |
| 系统应用读取 | 部分厂商定制 ROM 可能限制 |
| 并行性能 | 单设备建议 QPS < 10 |
> 完整兼容性矩阵请参考 OpenClaw 文档
—
常见问题 (FAQ)
Q1: 这个命令需要 root 权限吗？
不需要。installed apps 基于标准 Android API 实现，只需设备开启 USB 调试模式，并通过 adb 授权即可。但部分厂商（如华为、小米）的隐私保护机制可能限制后台应用读取，建议在自动化测试场景中配合 OpenClaw 的屏幕解锁节点使用。
Q2: 能获取应用的详细权限列表吗？
当前版本仅返回基础元数据（包名、版本等）。如需权限详情，建议组合使用 android:app_info 节点（预计 v0.9.2 发布）或调用 dumpsys package 命令自行解析。
Q3: 如何过滤特定类型的应用（如游戏、金融类）？
OpenClaw 本身不提供应用分类能力，但可通过输出数据的 packageName 结合第三方库（如 Google Play Category API）或本地映射表实现分类。示例代码：
// 自定义过滤逻辑
const gameKeywords = ['game', 'play', 'arena'];
const isGame = apps.filter(app =>
gameKeywords.some(kw => app.appName.toLowerCase().includes(kw))
);
Q4: 与 Appium、UI Automator 相比有什么优势？
| 特性 | OpenClaw | Appium |
|—–|———|——–|
| 应用列表获取 | 原生节点，一行配置 | 需自定义 driver.execute_script |
| 与 LLM 集成 | 内置 LLM 节点 | 需额外开发 |
| 学习曲线 | 低（YAML 配置） | 中（需熟悉 WebDriver） |
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 节点文档 了解更多能力
- 在 GitHub Discussions 分享你的使用场景
—
相关阅读
—
参考来源
