Files
OpenClaw-On-Android/reference/oca-cli.mdx
T

114 lines
2.1 KiB
Plaintext

---
title: "oca CLI Reference"
description: "Complete reference for the oca command-line interface."
---
## Overview
The `oca` CLI is installed to `$PREFIX/bin/oca` during setup.
```bash
oca [command] [options]
```
---
## Commands
### `oca --status`
Check the current status of all OCA components.
```bash
oca --status
```
**Example output**:
```
[OK] OpenClaw gateway: running
[OK] Node.js v24.14.1 (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.
```bash
oca --update
```
---
### `oca --install`
Reinstall a specific component:
```bash
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.
```bash
oca --uninstall
```
Removes `~/.oca/`, PATH entries from `~/.bashrc`, `oca` and `ocaupdate` from `$PREFIX/bin/`.
<Warning>
Does **not** remove globally installed npm packages (Claude Code, Qwen Code, etc.).
</Warning>
---
## `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`
```bash
ocaupdate
```
Convenience alias for `oca --update`. Pulls latest OCA from GitHub and re-runs install steps.