XO Docs
Getting Started

Manage Your Machine

Manage your workspace — open your IDE, monitor resources, restart services, and control your machine.

Your project's workspace dashboard is the control center for your machine. From here you can open your IDE, restart the OpenClaw gateway, stop/start your machine, and monitor resource usage — all from the Launch tab.

What You'll Need

Open Your Workspace

Open beta.xo.builders.

XO Builders dashboard

Select your agent from the sidebar.

Select your agent

If your machine is stopped, click Start to boot it up.

Click Start

Wait for the agent status to transition to Ready.

Once the machine is running, the panel shows all your workspace controls and live stats.

Monitoring Resources

The panel displays real-time CPU and RAM usage for your workspace.

CPU and RAM Usage

Service Status

The panel shows the status of your services. When everything is ready, you'll see Up next to each service.

OpenClaw Gateway — The gateway is running and ready to accept connections.

Cowork API — The workspace backend is running.

Services Up

Wait for both services to show Up before opening the gateway or IDE. New projects take 10–15 minutes to provision.

Opening Your IDE

The Agent Connections panel lists all the ways you can connect to your workspace.

Desktop IDE (VS Code / Cursor) — Click VS Code to open the workspace in your desktop editor.

Click VS Code

Browser IDE (Code-Server) — Click code-server to open a browser-based VS Code. No install needed.

Click code-server

For detailed IDE setup, see the VS Code Server guide.

Opening the OpenClaw Gateway

Click OpenClaw Gateway to open the dashboard.

Click OpenClaw Gateway

Enter your project name in the Gateway Token field.

Gateway Token field

If you see "unauthorized: gateway token missing", enter the correct token — it's your exact project name (case-sensitive).

Gateway unauthorized error

Restarting the OpenClaw Gateway

Click OpenClaw Restart to restart the gateway service.

Click OpenClaw Restart

Wait for the OpenClaw gateway restarted confirmation.

Gateway restart confirmed

Give it a minute before opening the gateway again. For the terminal restart method (with logs), see the Restart Gateway guide.

Restart Your Machine

If your IDE isn't loading or your environment feels stuck, do a stop-and-restart cycle.

Stop the Machine

Click Stop to shut down the workspace machine. Click Refresh to confirm the status reads stopped.

Start the Machine

Click Start to boot the machine back up.

Click Start

Wait for the status to change from starting to running.

Verify Services Are Up

Check that both OpenClaw Gateway and Cowork API show Up before opening the gateway or IDE.

If the machine stays in a starting state for more than a couple of minutes, try stopping and starting it again.

On this page