에이전트로 마이그레이션
이 페이지의 내용
노트북, 서버, 다른 플랫폼 등 다른 곳에서 AI 어시스턴트를 실행해 온 경우 처음부터 다시 시작할 필요가 없습니다. AI Agent에는 이전 어시스턴트가 쌓아온 모든 수명(대화, Memory, 파일, 스킬, 일정)을 어플라이언스로 이동시켜 주는 기본 제공 마이그레이션 스킬이 탑재되어 있습니다. 몇 달 동안 구축하는 데 걸렸던 작업이 하나의 가이드 세션으로 완료됩니다.
마이그레이션으로 가져오는 항목
| 가져오는 항목 | 남겨두는 항목 (의도적으로) |
|---|---|
| 채팅 기록 — 과거 대화 | 모델/API 키 구성 — 어플라이언스의 사전 연결된 모델로 대체됨 |
| Memory — 기존 어시스턴트가 알던 내용 | 메시징 플랫폼 연동(텔레그램 봇 등) — 여기의 알림은 Performance Hub 푸시를 통해 작동함 |
| 작업 공간 파일 및 문서 | 호스팅/인프라 플러밍 — 어플라이언스 자체가 인프라임 |
| 생성했던 스킬 | |
| 예약된 작업 | |
| 성격 |
이러한 구분이 핵심입니다. 마이그레이션은 기존의 플러밍이 아닌 데이터와 노하우를 가져옵니다. 턴키 어플라이언스가 이미 처리하는 모든 것(모델, 연결, 백업, 웹 인터페이스)은 어플라이언스의 사전 설정된 상태로 유지되므로, 기존 유지 관리 부담은 전혀 없이 기록만 그대로 가져올 수 있습니다.
작동 방식
전체 흐름은 새 에이전트스와의 대화로 진행됩니다:
- 에이전트에 마이그레이션 요청. *"내 Mac에서 기존 어시스턴트를 마이그레이션하고 싶어"*와 같은 방식으로 스킬을 시작합니다. 기존 어시스턴트가 있는 위치에 대해 몇 가지 질문을 합니다.
- 기존 컴퓨터에서 한 줄 실행. 에이전트는 기존 어시스턴트가 있는 머신에서 실행할 단일 명령어를 제공합니다. macOS 및 Ubuntu의 터미널 앱 또는 Windows의 PowerShell에서 실행한 다음, 마이그레이션이 완료될 때까지 해당 창을 열어두기만 하면 됩니다. 기존 측의 설치는 이것으로 전부이며 설치할 필요가 없습니다. 터미널을 사용해 본 적이 없나요? Windows, macOS 및 Ubuntu용 단계별 지침과 스크린샷은 터미널 열기를 참고하세요.
- 에이전트가 스캔하고 계획 제안. 발견된 내용(대화 수, Memory 양, 파일, 스킬)을 검토하고 승인을 위한 마이그레이션 계획을 제시합니다. 사용자가 승인하기 전에는 아무것도 이동하지 않습니다.
- 재개 기능과 함께 전송 실행. 데이터는 암호화되어 이동하며, 중간에 연결이 끊어지더라도 처음부터 다시 시작하지 않고 중단된 지점부터 재개됩니다.
- 설치 및 핸드오프. 에이전트가 가져온 항목(기록, Memory, 파일, 스킬, 일정)을 설치한 다음, 짧은 설정 과정을 통해 모든 항목이 제대로 들어왔는지 확인하고 이미 설정해 둔 항목(성격 등)과 병합할 내용을 조율합니다.
데이터 전송 방식
전송은 피어 투 피어(P2P) 방식으로 이루어집니다. 기존 컴퓨터와 에이전트가 글로벌 릴레이 포인트 네트워크를 통과하는 안전하고 암호화된 터널을 통해 서로 통신합니다. 이것이 전송이 매우 안정적인 이유입니다.
- 동일 네트워크? 기존 컴퓨터와 Physical Agent가 동일 네트워크 상에 있는 경우, 전송은 보통 두 기기 간 직접 이루어지며 데이터가 건물 밖으로 전혀 나가지 않는 경우가 많습니다.
- 서로 다른 네트워크? 가능한 경우 양쪽이 인터넷을 통해 직접 피어투어(P2P) 연결을 협상합니다.
- 직접 연결 차단됨? (엄격한 방화벽, 캐리어급 NAT 등으로 인해) 직접 연결이 불가능한 경우, 실패하는 대신 가장 가까운 릴레이 지점을 통해 데이터가 자동으로 중계됩니다.
어떤 방식을 선택할지 고민할 필요가 없습니다. 연결은 항상 스스로 가장 적합한 경로를 찾아냅니다.
마이그레이션 가능 항목
마이그레이션 스킬은 다음과 같은 다양한 인기 AI 어시스턴트와 도구를 기본적으로 지원합니다.
- Hermes 및 OpenClaw / Clawbot 에이전트 (동일 계열의 이전 에이전트 포함)
- Claude Code 및 Claude Desktop
- ChatGPT Desktop 및 Codex (ChatGPT CLI) — 공식 ChatGPT 및 Claude 대화 내보내기 아카이브 포함
- Cursor
- Gemini
- Aider
- GitHub Copilot
스캔 단계에서는 각 소스에서 추출할 수 있는 항목과 그렇지 않은 항목을 명확히 안내합니다.
또한 전체 마이그레이션 흐름이 AI 네이티브 방식(에이전트 자체가 검색, 계획, 설치를 주도함)으로 작동하므로 위 목록에만 국한되지 않습니다. 기존 어시스턴트나 데이터 소스가 위 목록에 없더라도 에이전트가 직접 탐색하도록 지시할 수 있습니다. 기존 어시스턴트의 위치를 알려준 뒤 프롬프트를 입력하고 협력하여 필요한 모든 항목을 찾아 가져오도록 하세요.
일부만 마이그레이션하기
모든 것을 가져올 필요는 없습니다. 마이그레이션 계획은 항목별로 나뉘므로 원하는 항목만 선택할 수 있습니다. 대화 기록만 가져오거나, 스킬 및 예약된 작업만 가져오거나, Memory 및 페르소나만 가져오는 등 어떤 조합이든 가능합니다. 이는 기존 어시스턴트의 노하우는 유지하면서 불필요한 데이터를 제외하고 싶거나, 여러 소스에서 선별된 조각들을 가져오고 싶을 때 유용합니다.
시작하기 전
- 먼저 백업을 진행하세요. 새 에이전트에 이미 중요한 상태가 저장되어 있는 경우, 메모와 함께 지금 백업을 실행하세요. 마이그레이션 과정에서 상당한 양의 콘텐츠가 추가되므로 복원 지점이 있으면 전체 작업을 되돌릴 수 있습니다. 백업 문서를 참조하세요.
- 두 기기 모두 온라인 상태 유지. 전송을 위해 기존 컴퓨터가 인터넷에 연결되어 있어야 하며, 나머지는 에이전트가 처리합니다.
- 예산 여유 확인. 대용량 Memory 아카이브를 설치할 때는 모델 작업이 수반되므로, 지출 한도를 엄격하게 설정해 둔 경우라면 이를 확인하는 것이 좋습니다.
마이그레이션, 복원 또는 교체?
에이전트 상태를 이동하는 데 사용되는 세 가지 도구입니다. 상황에 맞는 올바른 도구를 선택하세요.
| 상황 | 사용 방법 |
|---|---|
| 다른 플랫폼/컴퓨터에서 어시스턴트의 데이터를 가져오는 경우 | 마이그레이션 (현재 페이지) |
| 현재 기기를 이전 상태로 되돌리는 경우 | 복원 |
| 이 에이전트를 새 하드웨어로 이동하는 경우 | Replace this device |
| 제거된 기기의 백업에서 새 에이전트를 생성(시딩)하는 경우 | 에이전트를 추가할 때 고급 설정의 백업에서 복원 사용 |
마이그레이션 후
온보딩 대화를 진행할 때처럼 처음 하루 이틀은 에이전트에게 어떤 내용을 기억하고 있는지 물어보고, 마이그레이션된 Memory를 무작위로 확인하고, 작업 공간 파일 목록을 훑어보고, 마이그레이션된 예약된 작업이 새 환경(상시 가동되는 에이전트, 시설의 시간대 기준)에서 여전히 올바르게 작동하는지 확인하세요. 그런 다음 매시간 진행되는 백업을 통해 모든 데이터를 안전하게 보호하세요.
추가로 권장하는 단계는 에이전트에게 마이그레이션된 모든 데이터를 장기 Memory에 다시 색인(re-index)하도록 요청하는 것입니다. 에이전트의 Memory는 일반적으로 대화가 진행되는 동안 실시간으로 색인화하므로, 가져온 아카이브가 자동으로 회상 기능에 포함되지는 않습니다. *"마이그레이션된 기록을 장기 Memory에 다시 색인해 줘"*와 같이 요청하세요. 모델 작업이 수반되므로(크레딧을 사용하기 전에 에이전트가 확인을 요청합니다) 작업이 완료되면 이후의 대화에서 기존 어시스턴트가 알던 모든 맥락을 파악할 수 있게 됩니다.