Spaces:
Running
Running
| # Migrate Agents | |
|  | |
| Migrate Agents is a bundled Agent Zero plugin for bringing retained work | |
| home from the five most-used open agent harnesses: | |
| - OpenClaw | |
| - Hermes Agent | |
| - OpenCode | |
| - Claude Code | |
| - Codex | |
| The plugin checks an export before importing it. You choose which chats, | |
| projects, memories, instructions, and skills to bring into Agent Zero. | |
| Credentials, authentication files, and hidden reasoning are excluded. | |
| ## Enable | |
| Enable **Migrate Agents** in Plugins, then use its **Open** button. | |
| ## Prepare an export | |
| | Source | Recommended input | | |
| | --- | --- | | |
| | OpenClaw | `openclaw backup create --verify`, an agent SQLite snapshot, or legacy transcript JSONL | | |
| | Hermes Agent | `hermes sessions export backup.jsonl --redact`, `~/.hermes/state.db`, or a folder/archive containing memories and skills | | |
| | OpenCode | `opencode export <session-id> > session.json`, repeated for each session you want | | |
| | Claude Code | A folder/archive from `~/.claude/projects`, plus any `CLAUDE.md` and skills you want | | |
| | Codex | The `sessions/` and `archived_sessions/` folders beneath `CODEX_HOME` (normally `~/.codex`) | | |
| You can choose individual files, a whole directory, ZIP, TAR, or TAR.GZ. The | |
| preview is read-only. Import does not start until you review the manifest and | |
| confirm it. | |
| ## What maps cleanly | |
| | Source material | Agent Zero destination | Notes | | |
| | --- | --- | --- | | |
| | User and assistant messages | Native chats | Source ID, timestamps, and workspace metadata are retained when available. | | |
| | Retained workspace paths | Native projects | Chats from the same retained workspace are attached to the same imported project. Project files are not reconstructed from transcript metadata alone. | | |
| | Tool activity | Historical tool records | Sanitized and inert; never replayed as commands. | | |
| | Memory Markdown | `usr/knowledge/_migrate_agents/<source>/memories/` | Each document receives a provenance header. | | |
| | `SOUL.md`, `USER.md`, `CLAUDE.md`, `AGENTS.md`, and related instructions | `usr/knowledge/_migrate_agents/<source>/instructions/` | Instructions remain separately selectable from memories. | | |
| | Agent Skills containing `SKILL.md` | `usr/skills/_migrate_agents/<source>/` | Complete skill folders are copied under unique names. | | |
| | Attachment references | Chat metadata or text | Binary attachment copying is not automatic. | | |
| ## Deliberate privacy boundary | |
| Migrate Agents never imports provider keys, credentials, authentication | |
| state, channel bindings, schedules, hidden reasoning, or live services. It | |
| redacts obvious secret assignments, bearer tokens, private keys, and embedded | |
| data URLs from imported text and tool records. This is defense in depth, not a | |
| guarantee; review migrated material before sharing it. | |
| The Codex adapter follows the preservation and privacy rules of the | |
| `convert-codex-chats` utility skill: public user/commentary/final events are | |
| retained, tool calls and results are paired when available, encrypted or hidden | |
| reasoning is excluded, and historical actions are not presented as replayable. | |
| ## Limits | |
| - 5,000 expanded files per migration | |
| - 100 MiB per file | |
| - 256 MiB expanded total | |
| - Preview lists are capped at 200 rows, while import still processes the full accepted bundle | |
| - Modern OpenClaw conversation imports require its per-agent database or transcript artifacts; the global control-plane database does not contain chats | |
| ## Development | |
| No third-party Python or JavaScript packages are required. | |
| ```bash | |
| python -m pytest plugins/_migrate_agents/tests -q | |
| ``` | |
| Harness logo SVGs are bundled locally under `webui/assets/`; provenance and | |
| license details are recorded in `webui/assets/ATTRIBUTION.md`. | |