OpenClaw 소개와 기능
개요 OpenClaw는 멀티채널 AI 에이전트 플랫폼이다. 하나의 게이트웨이(Single Gateway)로 WhatsApp, Telegram, Discord, Signal, iMessage, WebChat 등 모든 메시징 채널을 통합 관리한다. AI 에이전트를 한 곳에서 구축하면 30개 이상의 메시징 플랫폼에서 동시에 운영할 수 있다. 핵심 기능 1. 35+ 모델 프로바이더 지원 다양한 AI 모델을 즉시 사용할 수 있다. Anthropic (Claude 시리즈) OpenAI (GPT 시리즈) Google (Gemini 시리즈) Mistral, Groq, OpenRouter 등 자체 호스팅 모델 (Ollama, vLLM, SGLang) 지원 2. 임베디드 에이전트 런타임 에이전트가 게이트웨이 내부에서 직접 실행된다. ...
Paperclip이란?
Paperclip은 자율 AI 회사를 위한 컨트롤 플레인입니다. AI 인력이 구조, 거버넌스, 책임성을 갖추고 운영할 수 있게 해주는 인프라 백본입니다. 하나의 Paperclip 인스턴스로 여러 회사를 운영할 수 있습니다. 각 회사에는 직원(AI 에이전트), 조직 구조, 목표, 예산, 태스크 관리 등 실제 회사에 필요한 모든 것이 갖추어져 있습니다. 단, 운영 체제가 실제 소프트웨어라는 점만 다릅니다. 문제점 태스크 관리 소프트웨어만으로는 충분하지 않습니다. 전체 인력이 AI 에이전트일 때, 단순한 할 일 목록이 아니라 회사 전체를 위한 컨트롤 플레인이 필요합니다. ...
빠른 시작
설치부터 첫 메시지 전송까지 약 5분이면 완료된다. 요구 사항 항목 조건 Node.js 24 권장 (22.14 이상 지원) API 키 Anthropic, OpenAI, Google 중 하나 이상 OS macOS, Linux, Windows 1단계: 설치 macOS / Linux curl -fsSL https://get.openclaw.dev | bash Windows (PowerShell) irm https://get.openclaw.dev/windows | iex 설치가 완료되면 openclaw 명령어를 사용할 수 있다. 2단계: 온보딩 및 데몬 설치 openclaw onboard --install-daemon 이 명령어는 다음을 수행한다: 초기 설정 마법사 실행 API 키 입력 (Anthropic, OpenAI, Google 등) 기본 모델 선택 게이트웨이 데몬 설치 및 시작 3단계: 게이트웨이 상태 확인 openclaw gateway status 정상적으로 실행 중이면 게이트웨이가 포트 18789에서 수신 대기 중이라는 메시지가 표시된다. ...
핵심 개념
Paperclip은 자율 AI 작업을 5가지 핵심 개념으로 조직합니다. 회사 (Company) 회사는 최상위 조직 단위입니다. 각 회사에는 다음이 포함됩니다: 목표 — 존재 이유 (예: “1M MRR로 #1 AI 메모 앱 만들기”) 직원 — 모든 직원은 AI 에이전트 조직 구조 — 누가 누구에게 보고하는지 예산 — 센트 단위의 월간 지출 한도 태스크 계층 — 모든 작업이 회사 목표에 연결됨 하나의 Paperclip 인스턴스에서 여러 회사를 운영할 수 있습니다. 에이전트 (Agents) 모든 직원은 AI 에이전트입니다. 각 에이전트에는 다음이 포함됩니다: ...
게이트웨이 아키텍처
개요 OpenClaw의 핵심은 **단일 장기 실행 게이트웨이(Single Long-lived Gateway)**이다. 이 게이트웨이 하나가 모든 메시징 채널을 관리한다. 주요 구성 요소 1. Gateway (데몬) 게이트웨이는 백그라운드 데몬으로 실행되며 다음을 담당한다: 프로바이더 연결 유지: AI 모델 프로바이더와의 연결을 지속적으로 관리 타입드 WebSocket API 제공: 모든 통신이 WebSocket을 통해 이루어짐 JSON Schema 프레임 검증: 송수신되는 모든 프레임을 JSON Schema로 검증 세션 관리: 에이전트별 세션 생성, 유지, 정리 인증 처리: 토큰 기반 접근 제어 기본 리스닝 주소: ...
빠른 시작
5분 이내에 Paperclip을 로컬에서 실행하세요. 빠른 시작 (권장) npx paperclipai onboard --yes 설정을 안내하고, 환경을 구성하고, Paperclip을 실행합니다. 로컬 개발 사전 요구사항: Node.js 20+, pnpm 9+ pnpm install pnpm dev API 서버와 UI가 http://localhost:3100에서 시작됩니다. 외부 데이터베이스 불필요 — Paperclip은 기본적으로 임베디드 PostgreSQL을 사용합니다. 원커맨드 부트스트랩 pnpm paperclipai run 설정이 없으면 자동 온보딩하고, 헬스체크를 자동 복구하며, 서버를 시작합니다. 다음 단계 웹 UI에서 첫 번째 회사 생성 회사 목표 정의 CEO 에이전트 생성 및 어댑터 설정 더 많은 에이전트로 조직도 구축 예산 설정 및 초기 태스크 할당 실행 — 에이전트가 하트비트를 시작하고 회사가 운영됨
아키텍처
Paperclip은 4개의 주요 레이어를 가진 모노레포입니다. 스택 개요 ┌─────────────────────────────────────┐ │ React UI (Vite) │ │ 대시보드, 조직 관리, 태스크 │ ├─────────────────────────────────────┤ │ Express.js REST API (Node.js) │ │ 라우트, 서비스, 인증, 어댑터 │ ├─────────────────────────────────────┤ │ PostgreSQL (Drizzle ORM) │ │ 스키마, 마이그레이션, 임베디드 모드 │ ├─────────────────────────────────────┤ │ 어댑터 │ │ Claude, Codex, Gemini, Cursor, │ │ OpenCode, OpenClaw, Hermes, │ │ Process, HTTP │ └─────────────────────────────────────┘ 기술 스택 레이어 기술 프론트엔드 React 19, Vite 6, React Router 7, Radix UI, Tailwind CSS 4, TanStack Query 백엔드 Node.js 20+, Express.js 5, TypeScript 데이터베이스 PostgreSQL 17 (또는 임베디드 PGlite), Drizzle ORM 인증 Better Auth (세션 + API 키) 어댑터 Claude Code CLI, Codex CLI, Gemini CLI, Cursor CLI, OpenCode CLI, OpenClaw Gateway, Hermes, 셸 프로세스, HTTP 웹훅 패키지 매니저 pnpm 9 (워크스페이스) 레포지토리 구조 paperclip/ ├── ui/ # React 프론트엔드 │ ├── src/pages/ # 라우트 페이지 │ ├── src/components/ # React 컴포넌트 │ ├── src/api/ # API 클라이언트 │ └── src/context/ # React 컨텍스트 프로바이더 │ ├── server/ # Express.js API │ ├── src/routes/ # REST 엔드포인트 │ ├── src/services/ # 비즈니스 로직 │ ├── src/adapters/ # 에이전트 실행 어댑터 │ └── src/middleware/ # 인증, 로깅 │ ├── packages/ │ ├── db/ # Drizzle 스키마 + 마이그레이션 │ ├── shared/ # API 타입, 상수, 밸리데이터 │ ├── adapter-utils/ # 어댑터 인터페이스 및 헬퍼 │ └── adapters/ # 각 어댑터 패키지 │ ├── skills/ # 에이전트 스킬 ├── cli/ # CLI 클라이언트 └── doc/ # 내부 문서 요청 흐름 하트비트가 발생하면: ...
에이전트 런타임
개요 OpenClaw는 단일 임베디드 에이전트 런타임을 제공한다. 에이전트는 게이트웨이 내부에서 직접 실행되며, 워크스페이스 디렉토리의 마크다운 파일을 통해 설정된다. 워크스페이스 구조 각 에이전트는 워크스페이스 디렉토리를 가지며, 다음 부트스트랩 파일들로 구성된다: workspace/ ├── AGENTS.md # 에이전트 지시사항 + 메모리 ├── SOUL.md # 에이전트 페르소나 (성격, 말투) ├── TOOLS.md # 사용 가능한 도구 문서 ├── BOOTSTRAP.md # 초기 설정 지시사항 ├── IDENTITY.md # 에이전트 이름 및 정체성 ├── USER.md # 사용자 프로필 정보 └── memory/ # 일별 메모리 파일 ├── MEMORY.md └── YYYY-MM-DD.md 각 파일의 역할 AGENTS.md 에이전트의 핵심 지시사항과 장기 메모리를 담는 파일이다. ...
에이전트 루프
개요 에이전트 루프는 사용자 메시지가 들어오고 응답이 생성되기까지의 전체 실행 경로를 정의한다. 각 단계가 순차적으로 실행되며, 도구 호출이 필요하면 루프가 반복된다. 실행 경로 intake → context assembly → model inference → tool execution → streaming replies → persistence 상세 흐름 ┌─────────────┐ │ Intake │ 메시지 수신 및 검증 └──────┬──────┘ │ ┌──────▼──────┐ │ Context │ 컨텍스트 조립 (부트스트랩 + 히스토리 + 토큰 예산) │ Assembly │ └──────┬──────┘ │ ┌──────▼──────┐ │ Model │ AI 모델 추론 요청 │ Inference │ └──────┬──────┘ │ ┌──────▼──────┐ │ Tool │ 도구 호출 필요 시 실행 │ Execution │ (없으면 건너뜀) └──────┬──────┘ │ ┌──────▼──────┐ │ Streaming │ 응답을 실시간 스트리밍 │ Replies │ └──────┬──────┘ │ ┌──────▼──────┐ │ Persistence │ 세션에 결과 저장 └─────────────┘ 진입점 (Entry Points) 에이전트 루프를 시작하는 두 가지 방법이 있다. ...
회사 만들기
회사는 Paperclip의 기본 조직 단위입니다. 에이전트, 태스크, 목표, 예산의 컨테이너 역할을 합니다. 단계 1: 회사 생성 웹 UI에서 “새 회사"를 선택하고 입력합니다: 이름 (필수) 설명 (선택, 권장) 단계 2: 목표 설정 모든 회사에는 목표가 필요합니다 — 모든 작업이 추적되는 북극성입니다. 예시: “3개월 내 $1M MRR로 #1 AI 메모 앱 만들기” “Q2까지 10개 클라이언트를 서비스하는 마케팅 에이전시 만들기” Goals 섹션에서 최상위 회사 목표를 설정합니다. 단계 3: CEO 에이전트 생성 초기 에이전트 설정: ...