Workspaces

Workspaces organize your cloud snapshots by machine or environment — like GitHub repos for your backups.

What Is a Workspace?

A workspace is a container that holds cloud snapshots for one OpenClaw installation. Each workspace has its own snapshot history, retention limits, and name.

Think of workspaces like GitHub repositories: you might have one for your personal laptop, one for your work machine, and one for a VPS. Each tracks its own history independently.

Default Workspace

When you sign up or log in for the first time, a default workspace is created automatically. All cloud backups go to your active workspace unless you switch to a different one.

# See your current workspace
npx clawon workspaces info

Creating Workspaces

Create additional workspaces to separate backups by machine, project, or environment.

# Create a named workspace
npx clawon workspaces create "Work Laptop"

# With a description
npx clawon workspaces create "VPS" --description "Production VPS backups"

Workspace names are converted to URL-friendly slugs automatically (e.g. "Work Laptop" becomes work-laptop).

Switching Workspaces

Switch your active workspace to direct cloud backups and restores to a different container.

# Switch by slug
npx clawon workspaces switch work-laptop

# Now all cloud commands target the new workspace
npx clawon backup
npx clawon restore

Listing & Inspecting

# List all your workspaces
npx clawon workspaces list

# Show details for the active workspace
npx clawon workspaces info

Workspace Strategies

• Per-machine: One workspace per device (e.g. "Personal MacBook", "Work Desktop", "Cloud VPS"). Best for most users.
• Per-environment: Separate workspaces for dev, staging, and production OpenClaw setups.
• Single workspace: Use the default workspace for everything if you only use one machine.

Tier Limits

Having trouble? Check the Troubleshooting guide.