Skip to main content

​
Installation Errors

Error: npm ERR! code ENOTFOUND or getaddrinfo EAI_AGAIN registry.npmjs.orgCause: 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
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"
Fix:
source ~/.bashrc
which node && node --version
If still failing:
export PATH="$HOME/.oca/node/bin:$PREFIX/bin:$PATH"
Fix:
npm config set prefix "$HOME/.oca/node"
Fix:
pkg install glibc-runner
bash ~/.oca/scripts/install-glibc.sh
Fix: Always install Qwen Code with --ignore-scripts:
npm install -g @qwen-code/qwen-code@latest --ignore-scripts
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 start --verbose
cat ~/.openclaw/logs/gateway.log | tail -50
Port conflict check:
lsof -i :18789

sshd
pgrep sshd && echo "running"

# 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?