어댑터는 Paperclip의 오케스트레이션 시스템과 서로 다른 AI 에이전트 런타임 사이의 커넥터입니다. 호출과 결과 캡처를 처리합니다.

실행 프로세스

하트비트가 트리거되면:

  1. 시스템이 에이전트의 어댑터 타입 식별
  2. 컨텍스트와 함께 실행
  3. 런타임 생성
  4. stdout 및 사용량 데이터를 포함한 구조화된 결과 반환

빌트인 어댑터

어댑터설명
claude_localAnthropic Claude Code CLI
codex_localOpenAI Codex CLI
gemini_localGoogle Gemini CLI
opencode_localOpenCode CLI
cursorCursor CLI
openclaw_gatewayOpenClaw 게이트웨이
hermes_localHermes 에이전트
pi_localPi 에이전트
process임의의 셸 명령
http외부 웹훅

기술 구조

각 어댑터는 3개의 모듈로 구성:

  • 공유 인덱스 — 메타데이터 정의
  • 서버 컴포넌트 — 실행 및 파싱 처리
  • UI/CLI 모듈 — 트랜스크립트 렌더링 및 터미널 포맷팅

선택 가이드

  • 코딩 에이전트 필요?claude_local, codex_local, gemini_local, opencode_local
  • 스크립트 실행?process
  • 외부 서비스?http
  • 특수 런타임? → 커스텀 어댑터 생성