openclone은 AI 페르소나 클론을 생성, 활성화하고, 다양한 관점에서 대화할 수 있도록 지원하는 도구입니다. 이 시스템은 사용자의 로컬 환경에서 구동되며, 모든 데이터는 서버나 계정 없이 마크다운 파일 형태로 사용자 컴퓨터에 저장됩니다.

핵심 기능:

• AI 페르소나 클론 생성 및 대화:
  • 기본 클론: 설치 즉시 사용 가능한 큐레이션된 프리셋 클론 목록이 제공됩니다. 이들은 공개된 인터뷰, 발언, 글을 기반으로 구성됩니다.
  • 사용자 정의 클론: 인터뷰 방식으로 페르소나 및 지식을 축적하여 자신만의 클론을 생성할 수 있습니다.
  • 지식 주입: 활성화된 클론에 URL, 영상 자막, 문서 등을 학습시켜 특정 지식을 부여할 수 있으며, 이는 로컬 파일로 저장됩니다.
• 다중 클론 상호작용:
  • 단체 대화방 (room): 여러 클론을 한 방에 모아 질문하면, 질문에 가장 적합한 클론이 자동으로 응답합니다. 이는 $openclone room <클론1> <클론2> ...$ 명령으로 시작합니다.
  • 카테고리 패널: 특정 카테고리(예: vc, tech, founder)에 속한 모든 클론에게 동시에 질문하여 다양한 관점을 나란히 비교할 수 있습니다. $openclone panel <카테고리> "질문"$ 명령을 사용합니다.

구현 방식 및 기술 세부 사항:

openclone은 두 가지 주요 사용 경로를 제공합니다:

1. Claude Code 스킬 (A. Claude Code Skill):
   • Claude Code 환경 내에서 /openclone 슬래시 명령어를 통해 클론과 상호작용하며, 단체방, 카테고리 패널, 자연어 활성화 등 모든 기능을 활용할 수 있습니다.
   • 설치는 git clone --filter=blob:none --sparse --depth=1 https://github.com/open-clone/openclone.git ~/.claude/skills/openclone && cd ~/.claude/skills/openclone && git sparse-checkout set --no-cone '/*' '!/clones/*/knowledge/' && ./setup 명령어를 통해 이루어집니다. 이 과정은 저장소를 클론하고, 필요한 파일만 희소 체크아웃하며, 설정 스크립트를 실행하여 Claude Code 환경에 통합합니다. ~/.claude/CLAUDE.md 파일에 openclone 사용법을 추가하여 Claude Code가 기능을 인식하도록 합니다.
   • ./setup 스크립트는 Claude Code의 settings.json을 수정하여 훅(hooks)과 상태 라인(statusline)을 구성합니다.

2. Standalone CLI (B. Standalone CLI):
   • npm install -g @openclone/openclone 명령어를 통해 전역으로 설치되며, 어떤 터미널에서든 openclone 명령어로 OpenAI-compatible API, Codex OAuth, 또는 로컬 Ollama 모델을 사용하여 클론과 대화할 수 있습니다.
   • Vercel Agent Skills 통합 (권장): npx skills add open-clone/openclone --skill openclone-cli 명령으로 설치하여, Claude Code, Cursor, Copilot 등 AI 코딩 에이전트가 skills/openclone-cli/SKILL.md 및 references/*.md 파일을 읽고 openclone CLI의 사용법, 설정, 세션 관리, 문제 해결 방법을 자연어로 안내하도록 합니다.
   • Provider 설정:
     • OpenAI-compatible API: OPENCLONE_API_KEY 및 OPENCLONE_MODEL 환경 변수를 통해 API 키와 사용할 모델을 설정합니다.
     • Codex OAuth: --use-codex-auth 플래그를 사용하여 Codex CLI에 로그인된 상태에서 인증을 활용합니다. ChatGPT 백엔드의 일반 사용자 토큰 정책으로 인해 $store=false$ (응답 항목 영속성 비활성화)가 기본으로 적용됩니다. 이는 이전 messages 배열을 매 턴마다 전송하여 previous_response_id 없이도 다중 턴 대화를 가능하게 합니다.
     • 로컬 Ollama: ollama serve를 실행한 후 --provider ollama 및 --model 플래그를 사용하여 로컬 Ollama 모델과 연동합니다.
   • 인터랙티브 모드: $openclone chat <slug>$ 명령어로 진입하며, 대화 중 /help, /compact(오래된 대화를 요약), /clear(인메모리 히스토리 및 요약 비움), /bye(대화 종료) 등의 내부 명령어를 지원합니다.
   • 세션 관리: 모든 대화는 ~/.openclone/conversations/<slug>/<sessionId>.json 경로에 평문 JSON으로 저장됩니다. --resume 플래그를 통해 특정 세션 또는 가장 최근 세션을 이어갈 수 있습니다. 긴 대화는 OPENCLONE_COMPACT_MAX_CHARS (기본 24,000자)를 초과할 경우 오래된 메시지를 요약하며, 요약된 내용은 세션 JSON에 함께 저장되어 복원됩니다.

데이터 저장 및 관리:

• 모든 클론 페르소나 및 지식 파일은 로컬 디렉터리(~/.openclone/)에 마크다운 형식으로 저장됩니다.
• 자동 업데이트 기능이 내장되어 있어, 세션 시작 시 1시간 간격으로 백그라운드에서 git pull을 통해 업데이트를 수행합니다. 이 기능은 ~/.openclone/no-auto-update 파일 플래그를 통해 토글할 수 있습니다.
• 제거 시 cd ~/.claude/skills/openclone && ./uninstall 명령어를 실행하면 설치된 파일들이 제거되지만, 사용자가 생성한 클론 및 지식(~/.openclone/)은 보존됩니다.

플랫폼 지원:

• macOS, Linux, Windows (WSL2) 환경에서 정식 지원됩니다. Windows (Git Bash, cmd/PowerShell 네이티브)는 훅 실행의 환경 의존성으로 인해 미지원 또는 불안정합니다.

openclone은 AI 페르소나와의 상호작용을 로컬에서 효율적으로 관리하며, 사용자의 프라이버시를 존중하고 다양한 AI 모델 백엔드를 유연하게 통합할 수 있도록 설계되었습니다.