Export and import agents
You can export any agent as a file and import it on another machine or share it with a teammate. The exported file captures the agent's configuration — not its conversation history.
Export an agent
- Open My Agents and select the agent you want to export.
- Click Export in the agent detail view.
- Choose a location to save the file.
Import an agent
- Open My Agents.
- Click Import Agent at the top of the screen.
- Select the exported file using the file picker.
- If an agent with the same name already exists, a dialog appears. Either edit the pre-filled name in the New name field to keep both agents, or check Overwrite existing agent to replace it.
- Click Import to confirm. The agent appears in your list immediately.
What the file contains
| Included | Not included |
|---|---|
| Agent name | Conversation history |
| Description | Approval records |
| Personality (system prompt) | Audit trail |
| AI model selection | Usage statistics |
Approval records and audit logs are stored in MultiClaw Cloud and are not included in the exported file. They remain accessible in your workspace regardless of agent exports.
Common use cases
- Moving an agent from your work machine to another device
- Sharing a well-configured agent with a teammate
- Backing up an agent before making significant changes to its personality or tools
- Exporting as a starting point — import, then modify for a different use case
Known limitations
Subagent references may break. If the agent delegates to subagents, those references use agent IDs. If those agents don't exist on the target machine, the subagent links will not work. Re-link them after importing.
Model may fall back to default. If the AI model used by the exported agent isn't configured on the target machine, MultiClaw falls back to the default model. Check the Profile tab after importing.
Related articles
Create an agent
Build a new agent in minutes using the creation wizard — choose a name, model, personality, and tools.
Set up an agent profile
Edit an agent's name, personality, tools, and subagents from the profile page — and delete the agent when you no longer need it.
Local agents vs cloud agents
Understand the difference between local and cloud agents, when to use each, and why your agent list sometimes looks different.