Workspaces

Workspaces are how xCloud turns many agents into an organized operating system.

You can have a personal agent for fitness, finances, or productivity, and a separate business workspace where specialist agents work together by area.

Workspace Model

Workspace
  Main workspace agent
  Specialist agents
  Shared project context
  Shared files and memory
  Visual canvas

The workspace main agent coordinates the project. Specialist agents own specific responsibilities such as engineering, sales, marketing, operations, research, design, or customer support.

Personal Agent vs Workspace

Use	Best structure
Fitness coach	One personal agent with its own UI
Personal finance	One personal agent with memory and integrations
Startup or agency	Workspace with agents by function
Product launch	Workspace with marketing, design, engineering, and ops agents
Client project	Workspace scoped to that client

Create A Workspace

Use the workspace action in the sidebar.
Name the workspace.
Open the workspace chat.
Ask the workspace main agent to create specialist agents.

Example:

Create a workspace team for my SaaS launch.
I need specialists for engineering, growth, content, support, and operations.
Each agent should have a clear responsibility and its own project brief.

Specialist Agents

Specialist agents are normal OpenClaw agents with a workspace-scoped identity. They can still have:

Their own model.
Their own memory.
Their own channels.
Their own UI.
Their own files.

The difference is organization: they are grouped under the workspace and should share the same project context.

Canvas

The workspace canvas helps you see how agents, integrations, models, memory, and tools fit together.

Use it to answer:

Which agents exist in this workspace?
Which integrations are connected?
Which agent owns which part of the system?
What is currently active or changing?

Best Practices

Keep one workspace per business, client, or large project.
Give every specialist a narrow responsibility.
Put shared goals in the workspace brief.
Use Agent UI for agents that need a product-like interface.
Use channels only on the agents that should receive external messages.

Common Problems

Problem	Fix
Agents appear outside the workspace	Check that their ids use the workspace prefix
Workspace main agent is missing	Refresh agents or repair the remote helper
Specialist has no context	Ask the workspace main agent to update its project brief
Wrong agents after switching engines	Workspaces belong to the active engine