> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orgo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw

> Run OpenClaw on an Orgo cloud computer

<Frame>
  <img src="https://mintcdn.com/orgo/wJayerraXQVuhJ4i/images/openclaw.png?fit=max&auto=format&n=wJayerraXQVuhJ4i&q=85&s=712ed5b65ecab9a04ed2d125b236f03f" alt="OpenClaw" width="1228" height="694" data-path="images/openclaw.png" />
</Frame>

[OpenClaw](https://openclaw.ai) is an open-source AI agent that runs on a desktop and controls applications, automates tasks, and connects to messaging platforms through a gateway. This guide installs OpenClaw inside an Orgo cloud computer.

## Why run OpenClaw on an Orgo computer

|                              | Local laptop                                                  | Orgo cloud computer                                        |
| ---------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------- |
| Uptime                       | Off when the laptop sleeps                                    | Continuous                                                 |
| Reachable from other devices | Same network only                                             | Anywhere                                                   |
| Persistent state             | Tied to one machine                                           | Survives restarts                                          |
| Setup per device             | Reinstall each time                                           | One install, one config                                    |
| Isolation                    | Full access to your personal files, accounts, and credentials | Isolated VM. Only the files and credentials you put on it. |

The agent and its skills live on the cloud computer. Other devices connect to it.

### Isolation

OpenClaw is designed to take actions on a computer: install skills, run shell commands, control applications, hit APIs with your credentials. On a personal laptop that means the agent has the same access you do, including your home directory, browser sessions, SSH keys, and `~/.aws/credentials`. On an Orgo computer the blast radius is the VM. The agent has access to whatever you install or paste into that VM and nothing else. Delete the computer and the state is gone.

## Install

<Steps>
  <Step title="Create the computer">
    Open [orgo.ai/workspaces](https://orgo.ai/workspaces) and create a computer with at least **8 GB RAM** and **4 CPU cores**.
  </Step>

  <Step title="Open a terminal on the computer">
    Open the computer in the dashboard and launch **Terminal** from the taskbar.
  </Step>

  <Step title="Run the installer">
    ```bash theme={null}
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

    The installer detects the OS, installs Node 24 if missing, installs the `openclaw` CLI, and starts the onboarding wizard. The wizard configures a model provider, API key, and gateway port (default `18789`).
  </Step>

  <Step title="Install the background daemon">
    ```bash theme={null}
    openclaw onboard --install-daemon
    ```

    On Linux this registers a `systemd --user` service that auto-starts the gateway on every boot.
  </Step>

  <Step title="Verify">
    ```bash theme={null}
    openclaw --version
    openclaw doctor
    openclaw gateway status
    ```

    Open `http://127.0.0.1:18789/` in the computer's browser for the OpenClaw dashboard.
  </Step>
</Steps>

## Install via the Orgo SDK

Drive the install from your laptop. Every `computer.bash(...)` call runs on the cloud computer.

```python theme={null}
from orgo import Computer

computer = Computer(workspace="openclaw", ram=8, cpu=4)

computer.bash("curl -fsSL https://openclaw.ai/install.sh | bash")
computer.bash("openclaw onboard --install-daemon")

print(computer.bash("openclaw gateway status"))
```

State lives in `~/.openclaw/` on disk, so the daemon survives reboots and stop/start cycles.

## Gateway

The gateway accepts messages from Slack, Discord, Telegram, iMessage, and other platforms. Set it up once on the computer:

```bash theme={null}
openclaw gateway setup
```

A computer has no public inbound hostname - run gateways in outbound/socket mode (e.g. Slack Socket Mode, Telegram long-polling). To deliver HTTP webhooks, reach the desktop's API through the authenticated proxy `https://www.orgo.ai/api/desktops/{instance_id}/proxy/<path>` (requires your Orgo API key).

## Installing skills

OpenClaw skills are distributed through [ClawHub](https://clawhub.ai):

```bash theme={null}
npm install -g clawhub
clawhub search browser
clawhub install browser-automation
```

Skills install into `~/.openclaw/skills/` and persist across restarts.

## Sizing

| Workload                           | RAM    | CPU          |
| ---------------------------------- | ------ | ------------ |
| Single user, lightweight skills    | 8 GB   | 4 cores      |
| Multiple platforms, browser skills | 16 GB  | 4 to 8 cores |
| Multi-agent or long-running flows  | 32 GB+ | 8 cores      |

## Tips

* Config and skills live in `~/.openclaw/`.
* View logs with `journalctl --user -u openclaw -f`.