Workspace Lifecycle

Lifecycle overview

Workspaces are created as draft first. Draft means you have a workspace record in the control plane, but no VM/container is running yet.

States

• draft - workspace exists, not launched.
• provisioning - launch requested, provider instance being created.
• running - gateway is online and workspace is ready.
• error - provisioning or startup failed.
• destroyed - workspace removed and cleanup scheduled.

Launch preflight

Before launch, Claw42 requires at least one agent in the workspace with a valid provider key and model config. If none are valid, launch is rejected with a preflight error.

Agent startup timing

Agents created while a workspace is not running are saved and markedpending_workspace.

• When workspace status flips to running, pending agents are started automatically.
• If start succeeds, agent status becomes running.
• If start fails, agent status becomes error.

For how external channels map into agent sessions after startup, see Channels docs.