Skip to content

quickstart.mdx

Latest commit

 

History

History
148 lines (108 loc) · 4.2 KB

quickstart.mdx

File metadata and controls

148 lines (108 loc) · 4.2 KB
Raw
title Quick Start
description From zero to a running OpenClaw gateway in under 5 minutes.

Prerequisites

Install Termux from **[F-Droid](https://f-droid.org/packages/com.termux/)** — NOT the Google Play Store. The Play version is severely outdated and will cause failures.
  1. Install Termux from F-Droid
  2. Open Termux and run termux-setup-storage (required for storage permissions)
  3. Ensure you have a stable internet connection

🆓 Free AI Models

OCA works with multiple free AI providers — no credit card needed to get started.

Provider Free Models Free Limit
GitHub Copilot GPT-4.1, Claude Sonnet 2,000/mo · 50/day
Gemini CLI Gemini 2.0 Flash 1,500 req/day
Groq Llama 3.1, Gemma 2, Qwen 14,400 req/day
OpenRouter 50+ models (:free suffix) Varies
OpenCode/Zen MiniMax, Kimi, GLM 200 req/5hr

→ Full guide with setup instructions

Step 1 — Run the bootstrap

Open Termux and first refresh the packages that curl links against:

pkg update -y && pkg upgrade -y
pkg install -y curl openssl libngtcp2 ca-certificates

If you see CANNOT LINK EXECUTABLE "curl" or SSL_set_quic_tls_transport_params, the Termux curl/OpenSSL packages are out of sync. Run the two commands above, then run hash -r or reopen Termux.

Then paste this install command:

BOOTSTRAP="${TMPDIR:-/tmp}/oca-bootstrap.sh"
curl -fsSL https://raw.githubusercontent.com/PsProsen-Dev/OpenClaw-On-Android/master/bootstrap.sh -o "$BOOTSTRAP" \
  && bash "$BOOTSTRAP" \
  && [ -f "$HOME/.bashrc" ] && source "$HOME/.bashrc"

This avoids the classic curl | bash && source ~/.bashrc trap: if curl fails before downloading anything, bash can otherwise receive empty input and return success, which makes the shell try to source a .bashrc that the installer never created.

Step 2 — Answer the prompts

The installer walks you through 8 steps with yes/no prompts:

Prompt Recommendation
Install tmux? ✅ Yes — keeps sessions alive
Install ttyd (web terminal)? Optional
Install dufs (file server)? Optional
Install android-tools (adb)? ✅ Yes — useful for debugging
Install code-server (browser IDE)? Optional
Install OpenCode (AI assistant)? Optional
Install Claude Code CLI? Your choice
Install Gemini CLI? Your choice
Install Codex CLI? Your choice
Install Qwen Code CLI? ✅ Yes — works great on Android
Setup Termux:Boot auto-start? ✅ Yes — for 24/7 operation
Install Termux:API tools? Optional

Step 3 — Automatic glibc extras layer

On the OpenClaw platform, OCA automatically installs Homebrew (Linuxbrew) and the Go toolchain after the glibc runtime is ready. You do not need to answer separate prompts for them.

Why this is automatic:

  • glibc-runner provides the glibc dynamic linker required by standard Linux binaries on Android
  • OCA's Node.js/OpenClaw stack already depends on that glibc layer
  • Homebrew and many go install workflows naturally belong on the same layer

Recommended post-install check:

source ~/.bashrc && brew --version

Step 4 — Verify installation

oca --status

Expected output:

[OK] OpenClaw gateway: running
[OK] Node.js v24.x.x (glibc, grun wrapper)
[OK] platform: linux

If you enabled Homebrew and Go during setup, reload your shell and verify them:

source ~/.bashrc && brew --version && go version

Step 5 — Start the gateway

openclaw start

Dashboard available at http://127.0.0.1:18789/

What's next?

Connect to your Android server from your PC Set up Claude Code, Qwen Code, Gemini CLI Keep OpenClaw running 24/7 Fix common install errors