oca CLI Reference

Complete reference for the oca command-line interface.

Overview

The oca CLI is installed to $PREFIX/bin/oca during setup.

oca [command] [options]

---

Commands

oca --status

Check the current status of all OCA components.

oca --status

Example output:

[OK] OpenClaw gateway: running
[OK] Node.js v24.14.0 (glibc, grun wrapper)
[OK] platform: linux
[OK] npm: 10.9.2
[OK] SSH server: running (port 8022)
[OK] tmux session: openclaw

---

oca --update

Update OCA scripts, Node.js, and the OpenClaw package.

oca --update

---

oca --install

Reinstall a specific component:

oca --install [component]

Component	Description
nodejs	Reinstall Node.js v24 linux-arm64
glibc	Reinstall glibc-runner
openclaw	Reinstall OpenClaw npm package
ssh	Reconfigure SSH server
boot	Reconfigure Termux:Boot

---

oca --uninstall

Remove OCA completely.

oca --uninstall

Removes ~/.oca/, PATH entries from ~/.bashrc, oca and ocaupdate from $PREFIX/bin/.

Does not remove globally installed npm packages (Claude Code, Qwen Code, etc.).

---

openclaw Commands

Command	Description
openclaw start	Start the gateway server
openclaw start --verbose	Start with verbose output
openclaw stop	Stop the gateway
openclaw status	Check gateway health
openclaw update	Update to latest version
openclaw gateway token	Get auth token for cluster nodes

---

Environment Variables

Variable	Description
OCA_DIR	OCA root directory (~/.oca)
OCA_GLIBC	Set to 1 when glibc Node is active
GLIBC_NODE_DIR	Path to glibc Node.js installation
NODE_OPTIONS	Preloads glibc-compat.js polyfill
TMPDIR	Set to $PREFIX/tmp

---

ocaupdate

ocaupdate

Convenience alias for oca --update. Pulls latest OCA from GitHub and re-runs install steps.