Skip to main content

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]
ComponentDescription
nodejsReinstall Node.js v24 linux-arm64
glibcReinstall glibc-runner
openclawReinstall OpenClaw npm package
sshReconfigure SSH server
bootReconfigure 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

CommandDescription
openclaw startStart the gateway server
openclaw start --verboseStart with verbose output
openclaw stopStop the gateway
openclaw statusCheck gateway health
openclaw updateUpdate to latest version
openclaw gateway tokenGet auth token for cluster nodes

Environment Variables

VariableDescription
OCA_DIROCA root directory (~/.oca)
OCA_GLIBCSet to 1 when glibc Node is active
GLIBC_NODE_DIRPath to glibc Node.js installation
NODE_OPTIONSPreloads glibc-compat.js polyfill
TMPDIRSet to $PREFIX/tmp

ocaupdate

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