OpenClaw on Android
一条命令在 Android 上运行 OpenClaw，无需 proot 或完整 Linux 发行版。
- Star 数
- ★ 1.8k
- 最近更新
- 5 天前
- License
- MIT
- 主语言
- Kotlin
- FA 评分
- 46/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 希望在旧 Android 手机上运行 AI 代理网关，以实现低功耗 24/7 部署的用户。
- 不适合
- 没有 Android 手机或平板、想在桌面或服务器上运行的用户
- 不愿调整开发者选项和电池设置、希望进程长期稳定后台运行的用户
这个 Agent 能做什么，适合哪些场景？
OpenClaw on Android 是一个安装器和运行时环境，让 AI 代理平台 OpenClaw 能在 Android 设备上通过 Termux 运行。它通过安装 glibc 动态链接器（而不是完整的 proot-distro Linux）来消除传统方法所需的 700MB-1GB 开销，实现了原生性能。该项目包括一个一键安装脚本（curl | bash），一个命令行管理工具（oa），以及一个独立的 Claw App APK，内置终端模拟器和基于 WebView 的界面，无需 Termux。它自动处理路径转换、Node.js 设置、临时文件夹配置，并绕过 systemd 和 phantom process killer 限制。用户可以通过 openclaw gateway 命令启动网关，并通过 oa --update、oa --backup 和 oa --restore 管理安装。
安装器执行自动设置：检测 Termux 环境、安装 glibc-runner（提供 ld-linux-aarch64.so.1）、下载 Node.js v22 linux-arm64 并将其包装在 ld.so 加载器脚本中、将标准 Linux 路径（/tmp、/bin/sh、/usr/bin/env）转换为 Termux 路径、配置临时文件夹并绕过 systemd。它使用 --ignore-scripts 安装 OpenClaw（通过 npm install -g openclaw@latest），以避免编译 llama.cpp 后安装脚本导致的失败。它还安装 clawdhub（技能管理器）和可选的工具，如 tmux、ttyd、dufs、android-tools、code-server、OpenCode、Chromium、Playwright、Claude Code、Gemini CLI 和 Codex CLI。安装后，用户可以运行 'openclaw onboard' 完成初始设置，然后运行 'openclaw gateway' 启动网关。'oa' 命令提供更新、备份（oa --backup）、恢复（oa --restore）、状态和卸载功能。
- 希望在旧 Android 手机上运行 AI 代理网关，以实现低功耗 24/7 部署的用户。
- 想避免传统方法 20-30 分钟设置时间和 1-2GB 存储开销的自托管爱好者。
- 需要在移动设备上本地运行代码服务器或 AI CLI 工具（如 Claude Code）的开发人员。
- 希望在没有 Termux 的情况下，通过独立 APK（Claw App）拥有内置终端和仪表板的 UI 的用户。
- 希望在多台 Android 设备上管理 OpenClaw 实例并使用 Dashboard Connect 从 PC 访问的用户。
如何安装或部署这个 Agent？
- 从 F-Droid 安装 Termux（Play Store 版本已停用）。2. 打开 Termux，运行：pkg update -y && pkg install -y curl。3. 运行安装命令：curl -sL myopenclawhub.com/install | bash && source ~/.bashrc。安装通常需要 3-10 分钟。系统会提示选择可选工具（tmux、code-server 等）。或者，可以从 Releases 页面下载 Claw App APK 并安装，不需要 Termux。
如何使用这个 Agent？
安装后，运行 'openclaw onboard' 完成初始设置。然后打开新终端标签页并运行 'openclaw gateway' 启动网关。在手机 Termux 应用中直接运行网关，而不是通过 SSH。使用 'oa' 命令管理安装：oa --update 更新所有组件，oa --backup 创建备份，oa --restore 恢复备份，oa --status 显示状态。要访问仪表板或使用 SSH，请参阅 Termux SSH 设置指南。
这个 Agent 有哪些优点和局限？
- 无需完整 Linux 发行版：通过仅使用 glibc 动态链接器，相比 proot-distro 方法可节省约 800MB 空间和 20 分钟安装时间。
- 安装自动化：单条命令处理所有兼容性（路径、Node.js、systemd 绕过）。
- 维护工具：oa CLI 支持更新、备份、恢复和卸载，简化持续管理。
- 仅限 Android：需要 Termux（或 Claw App），仅限于 Android 7.0+。
- 潜在后台终止：由于 Phantom Process Killer，Android 可能会杀死进程；需要参考文档调整设置。
- 本地 LLM 性能受限：设备上推理速度慢且受 RAM/存储限制；建议使用云 LLM API。
这个 Agent 与同类方案有什么区别？
该 README 明确对比了标准 proot-distro 方法（完整 Linux 发行版）与本项目，突出了存储开销（1-2GB 对比 ~200MB）、设置时间（20-30 分钟对比 3-10 分钟）和性能。没有提到其他替代方案。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| OpenClaw on Android 当前 | 46 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.8k | 5 天前 | Kotlin | — |
| Myrlin Workbook | 69 · 存在缺口 | 命令行工具免费 | ★ 386 | 23 天前 | JavaScript | Codex · Claude Code |
| OpenCode Mobile | 71 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 232 | 2 个月前 | TypeScript | OpenAI API · Claude API |
| Aster | 77 · 表现良好 | 命令行工具免费 + 模型费 | ★ 129 | 今天 | Rust | OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示安装脚本会执行远程代码（curl | bash），但未提供脚本内容的审计或校验。用户确认方面，安装过程有交互式提示（Y/n），但未明确说明权限请求。数据流透明度不足，未说明数据如何被收集或传输。敏感数据处理未提及。依赖安全方面，使用npm包和外部二进制，但未提供完整性校验。外部影响方面，安装会修改系统路径和环境变量，但未明确说明。回滚方面，提供了卸载和备份命令，但未验证。来源归属方面，未验证发布者身份。
自洽性较好，README与脚本结构一致，但存在一些不一致（如README提到openclaw onboard，但未在脚本中验证）。依赖可用性方面，依赖外部服务（myopenclawhub.com）和npm，但未提供镜像或备用方案。失败消息方面，提供了错误处理和验证脚本，但未覆盖所有失败场景。
目标受众明确（Android用户），场景覆盖安装、更新、备份等。能力边界清晰，列出了可选工具和限制。触发精度方面，安装命令明确，但更新和卸载命令可能不够精确。环境适配方面，支持Android 7.0+和Termux，但未覆盖所有设备变体。
信息架构清晰，有README、文档和项目结构。安装说明详细，但依赖外部URL。命名稳定性方面，命令和文件名基本稳定，但存在版本迁移。示例和FAQ方面，有示例和故障排除文档。已知限制方面，列出了性能、本地LLM等限制。许可证为MIT，但版权年份为2026，可能不准确。版本变更日志缺失。维护责任方面，未明确维护者。
输出可用性方面，提供了CLI和APK，但未验证实际输出。边际价值方面，解决了proot的痛点，有明确优势。成本效益方面，安装时间短，但依赖外部服务。
声明可追溯性方面，README中的声明未完全对应到代码。跨来源佐证方面，未提供外部验证。事实与推断分离方面，部分声明（如性能）未提供基准测试。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 安装脚本从远程URL执行，存在供应链风险，建议审查脚本内容。
- 依赖外部服务（myopenclawhub.com）和npm包，未提供完整性校验。
- 未提供版本变更日志，维护责任不明确。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Fixed - On phones whose Android System WebView is old (version 91 and earlier, for example an Android 10 or 11 phone that does not update it), the app showed a blank screen every time it was opened after the installation had finished. The page is now always loaded from inside the app package, as it already was during the installation, so it works with these WebView versions. The app's language setting is kept. Scripts …在 GitHub 查看 ↗ -
发布说明摘录
Fixed - Opening or closing several terminal tabs in quick succession could stop the app and the gateway with it (a list of sessions was changed while it was being read). Terminal sessions are now created on the app's UI thread and the list is safe to read while it changes. - A command the app runs and stops after its time limit left the programs it had started running in the background; they are now stopped with it. - Entering and leaving split-screen mode no longer recreates the app's screen and terminal, and a screen that was closed now releases its web view. …在 GitHub 查看 ↗ -
发布说明摘录
Fixed - When an install was finished in the terminal while the continue or failure screen was open, going back to the app with the Home button, from the notification shade, from the recent apps screen or after unlocking the phone left that screen in place; it showed the dashboard only after going back from the app's terminal. The screen now checks again whenever you go back to the app and opens the dashboard. Scripts …在 GitHub 查看 ↗