解决Android Termux Openclaw Browser控制问题

[giturass]

https://linux.do/t/topic/1703747

[simonsbot]

你好！感谢你的关注。

你链接的 linux.do 帖子我无法直接查看，但从标题来看，你遇到的是 Termux 环境下的浏览器控制问题。这是一个已知的限制——Android Termux 没有原生的桌面浏览器环境（如 Chrome/Chromium），因此像 Puppeteer 或 Playwright 这类需要控制浏览器的工具在 Termux 上无法直接运行。这不是 openclaw-android 本身的 bug，而是 Android/Termux 平台的固有限制。如果你的使用场景需要浏览器自动化，建议在 PC/服务器环境下运行完整版的 OpenClaw。如果你能在 issue 中直接描述具体的问题细节（而不是外部链接），会更方便社区成员理解和讨论。

[giturass]

我觉得这是可解的

• pkg install x11-repo && pkg install chromium
• 然后给openclaw.json写入：
  "browser": {
  "executablePath": "/data/data/com.termux/files/usr/bin/chromium-browser",
  "headless": true,
  "noSandbox": true
  },
  

---

[simonsbot]

感谢 @giturass 的分享！这确实是一个很有价值的思路。通过 x11-repo 安装 Chromium 并在 openclaw 配置中指定 executablePath，理论上可以让浏览器自动化工具在 Termux 中以 headless 模式运行。

不过需要注意的是，浏览器相关的配置取决于上游 OpenClaw 框架本身是否支持这种自定义 browser 配置项（如 executablePath、noSandbox 等）。openclaw-android 项目本身主要负责环境搭建和部署，并不直接管理浏览器配置。另外，Chromium 在 Termux 上的稳定性和资源占用也值得关注——在内存较小的设备上 headless Chromium 可能会比较吃力。如果有人实际验证了这个方案的可行性，欢迎在这里分享具体的测试结果。

[AidanPark]

@giturass You were right — we tested your approach and confirmed it works on Termux.

v1.0.5 now officially supports Chromium browser automation. Here's what changed:

1. Automated install — Chromium is now an optional component during installation (via x11-repo). The installer auto-configures openclaw.json with the correct browser settings (executablePath, headless, noSandbox).
2. Fixed image processing — The sharp module couldn't load its native binary on Android. We added a WebAssembly fallback that works out of the box.
3. Full lifecycle support — Chromium is integrated into install, update, status, and uninstall flows.

Verified on device:

• ✅ Chromium headless runs correctly on Termux
• ✅ glibc Node.js can spawn Termux's Chromium via fork+exec
• ✅ OpenClaw reads the custom browser config (gateway logs show (custom) tag)
• ✅ Screenshot → image optimization → delivery — full pipeline tested

For existing users:

# Update to v1.0.5
oa --update && source ~/.bashrc

# Install Chromium (~400MB)
oa --install

⚠️ Chromium uses ~300–500MB RAM at runtime. Devices with 4GB+ RAM recommended.