Troubleshooting

Common errors and fixes for OCA on Termux + Android.

Installation Errors

EAI_AGAIN — DNS resolution failed

Error: npm ERR! code ENOTFOUND or getaddrinfo EAI_AGAIN registry.npmjs.org

Cause: glibc DNS resolver can’t find /etc/resolv.conf (doesn’t exist in Android 12+).

Fix:

mkdir -p $PREFIX/glibc/etc
printf 'nameserver 8.8.8.8\nnameserver 1.1.1.1\n' > $PREFIX/glibc/etc/resolv.conf

[Process completed (signal 9)]

Cause: Android 12+ Phantom Process Killer terminated Termux.

Fix: See the Phantom Process Killer guide.

Quick fix (from PC with ADB):

adb shell "/system/bin/device_config put activity_manager max_phantom_processes 2147483647"

node: not found / command not found

Fix:

source ~/.bashrc
which node && node --version

If still failing:

export PATH="$HOME/.oca/node/bin:$PREFIX/bin:$PATH"

npm ERR! code EACCES / permission denied

Fix:

npm config set prefix "$HOME/.oca/node"

glibc dynamic linker not found

Fix:

pkg install glibc-runner
bash ~/.oca/scripts/install-glibc.sh

node-pty build failed / @lvce-editor/ripgrep unrecognized platform

Fix: Always install Qwen Code with --ignore-scripts:

npm install -g @qwen-code/qwen-code@latest --ignore-scripts

openclaw update hangs for 20+ minutes

openclaw update builds native modules from source — 5–15 mins is normal on a mid-range phone. Only cancel after 20+ minutes and check logs:

cat ~/.openclaw/logs/update.log | tail -30

---

Runtime Errors

OpenClaw gateway won't start

openclaw start --verbose
cat ~/.openclaw/logs/gateway.log | tail -50

Port conflict check:

lsof -i :18789

SSH connection refused

sshd
pgrep sshd && echo "running"

os.cpus() crash / V8 engine panic

# Verify NODE_OPTIONS:
echo $NODE_OPTIONS
# Must include: -r ~/.oca/patches/glibc-compat.js

source ~/.bashrc

---

Diagnostics

oca --status

# Manual checks:
node --version
node -e "console.log(process.platform)"  # Should print: linux
npm --version
openclaw --version
cat $PREFIX/glibc/etc/resolv.conf
echo $PATH | tr ':' '\n'

---

Still stuck?

• GitHub Issues
• GitHub Discussions
• r/termux