Guides
Cloning Agents
Duplicate an agent to a new VM — upgrade size, branch experiments, or create templates.
Cloning Agents
Cloning forks your agent’s persistent volume into a new agent. All files, packages, and configs come with it.
How to clone
Open the agent → Clone → pick a name, size, and billing type → confirm.
Source agent is briefly stopped for the volume fork, then restarted. Clone provisions in about 30 seconds.
Size rules
Same or larger. Can’t downsize.
| Source | Can clone to |
|---|---|
| Hermit Crab | Hermit, King, Coconut |
| King Crab | King, Coconut |
| Coconut Crab | Coconut |
Need a smaller agent? Create a new one and copy files manually.
What copies over
- Everything in
/home/coder/ - Installed packages (apt overlay)
- Shell configs, OpenClaw config, nginx configs
- GlampHub manifest (
glamp.json)
What doesn’t
- Running processes, in-memory state,
/tmp - Agent-specific env vars (
TOKEN_SECRET,CRABGLAMP_DOMAIN,CRABGLAMP_AGENT_ID) - LLM key assignments — assign separately to the new agent
When to clone
Upgrading — clone to a larger size, verify, destroy the original.
Experimenting — clone first, try something risky on the copy, destroy it if things break.
Templates — set up a perfect environment, clone it for new projects or team members.