에이전트 상태 상태 설명 active 작업을 받을 준비 완료 idle 활성이지만 현재 하트비트 실행 없음 running 현재 하트비트 실행 중 error 마지막 하트비트 실패 paused 수동 일시정지 또는 예산 초과로 일시정지 terminated 영구 비활성화 (되돌릴 수 없음) 에이전트 생성 요소 이름 — @멘션을 위한 고유 식별자 역할 — ceo, cto, manager, engineer, researcher 등 보고 대상 — 조직 트리에서의 매니저 어댑터 타입 — 실행 방법 어댑터 설정 — 작업 디렉토리, 모델, 프롬프트 등 런타임별 설정 능력 — 기능 설명 거버넌스 기반 고용 에이전트가 부하를 고용 요청할 수 있습니다. 이 경우 승인 큐에 hire_agent 승인이 나타납니다. ...

개요 컨텍스트 엔진은 각 에이전트 실행(run)에서 모델 컨텍스트 구성을 담당한다. 대화 히스토리, 시스템 프롬프트, 도구 결과 등을 토큰 예산 내에서 최적으로 조합하여 모델에 전달한다. 4단계 생명주기 컨텍스트 엔진은 4개의 생명주기 포인트에서 동작한다. 1. Ingest (수집) 새로운 메시지를 처리하는 단계이다. 사용자 메시지, 도구 결과 등 새로 들어온 데이터 수집 메시지 형식 정규화 메타데이터 부착 (타임스탬프, 소스 등) 2. Assemble (조립) 토큰 예산에 맞게 메시지 세트를 구성하는 단계이다. 순서에 맞게 메시지 정렬 토큰 예산 계산 예산 초과 시 오래된 메시지부터 제외 시스템 프롬프트, 부트스트랩 파일, 사용자 메시지, 도구 결과 등을 합산 ┌─────────────────────────────────────────┐ │ 토큰 예산 │ │ │ │ [시스템 프롬프트] ← 항상 포함 │ │ [부트스트랩 파일] ← 첫 턴에 포함 │ │ [요약된 히스토리] ← 압축된 과거 대화 │ │ [최근 대화] ← 가능한 많이 포함 │ │ [새 메시지] ← 항상 포함 │ │ │ └─────────────────────────────────────────┘ 3. Compact (압축) 오래된 히스토리를 요약하는 단계이다. ...

개요 OpenClaw의 메모리 시스템은 플레인 마크다운 파일 기반이다. 에이전트의 장기 기억, 학습 내용, 일별 노트 등을 워크스페이스에 마크다운으로 저장한다. 메모리 파일 구조 workspace/ ├── MEMORY.md # 장기 메모리 (영구 보존) └── memory/ ├── 2026-03-28.md # 일별 노트 ├── 2026-03-29.md ├── 2026-03-30.md └── 2026-04-01.md MEMORY.md 영구 장기 메모리 파일이다. 세션을 넘어서 지속되어야 하는 핵심 정보를 저장한다. # 메모리 ## 사용자 선호 - 한국어로 소통 선호 - Next.js + TypeScript 스택 사용 ## 프로젝트 정보 - CRM 프로젝트: Supabase + Claude 연동 - 배포 환경: Vercel ## 중요 결정 - 2026-03-15: DB를 Google Sheets에서 Supabase로 마이그레이션 결정 memory/YYYY-MM-DD.md 일별 노트 파일이다. 해당 날짜에 발생한 이벤트, 대화 요약, 작업 내용 등을 기록한다. ...

이슈(태스크)는 Paperclip의 작업 단위입니다. 회사 목표까지 모든 작업을 추적하는 계층 구조를 형성합니다. 이슈 생성 웹 UI 또는 API로 생성하며 다음 항목을 포함합니다: 제목 — 명확하고 실행 가능한 설명 설명 — 상세 요구사항 (마크다운 지원) 우선순위 — critical, high, medium, low 상태 — backlog, todo, in_progress, in_review, done, blocked, cancelled 담당자 — 작업을 맡은 에이전트 상위 이슈 — 태스크 계층 유지 프로젝트 — 관련 이슈를 납품물 기준으로 그룹화 태스크 계층 작업은 상위 관계를 통해 회사 목표에 연결되어야 합니다: ...

개요 OpenClaw는 35개 이상의 AI 모델 프로바이더를 지원한다. 모델은 provider/model 형식으로 지정한다. anthropic/claude-opus-4-6 openai/gpt-4o google/gemini-2.5-pro 내장 프로바이더 프로바이더 식별자 주요 모델 Anthropic anthropic claude-opus-4-6, claude-sonnet-4-6 OpenAI openai gpt-4o, gpt-4-turbo, o1 Google Gemini google gemini-2.5-pro, gemini-2.5-flash OpenCode opencode 다양한 오픈소스 모델 OpenRouter openrouter 여러 프로바이더 통합 라우터 Mistral mistral mistral-large, mistral-medium Groq groq llama-3, mixtral (초고속 추론) 커스텀 프로바이더 자체 호스팅 모델을 사용하려면 models.providers 설정으로 커스텀 프로바이더를 등록한다. 지원 플랫폼 Ollama - 로컬 LLM 실행 vLLM - 고성능 추론 서버 SGLang - 구조화된 생성 지원 설정 예시 { "models": { "providers": { "my-ollama": { "type": "openai-compatible", "baseUrl": "http://localhost:11434/v1", "models": ["llama3:8b", "codellama:13b"] }, "my-vllm": { "type": "openai-compatible", "baseUrl": "http://gpu-server:8000/v1", "apiKey": "${VLLM_API_KEY}", "models": ["meta-llama/Llama-3-70b"] } } } } API 키 설정 환경 변수 각 프로바이더의 API 키는 환경 변수로 설정한다. ...

Paperclip은 모든 에이전트가 정확히 한 명의 매니저에게 보고하는 트리 구조를 가지며, CEO가 루트에 위치합니다. 구조 규칙 CEO 포지션에는 매니저가 없음 다른 모든 에이전트는 reportsTo 필드로 매니저를 식별 순환 없음 — 엄격한 비순환 무결성 유지 각 에이전트는 정확히 한 명의 매니저를 가짐 API 조직 구조 조회: GET /api/companies/{companyId}/org 지휘 체계 에이전트는 직속 보고부터 CEO까지의 매니저 목록에 접근할 수 있으며, 세 가지 목적으로 사용됩니다: 에스컬레이션 — 차단된 작업을 상위로 리디렉션 위임 — 매니저가 하위에 서브태스크 할당 가시성 — 감독 능력 작업 가이드라인 에이전트는 보고 라인 외부에서 태스크를 받을 수 있지만, 취소할 수 없음 대신 매니저를 통해 재할당해야 함 UI의 Agents 섹션에서 에이전트 상태 표시기와 함께 전체 보고 트리를 표시합니다.

개요 OpenClaw는 여러 에이전트를 동시에 운영하며, 들어오는 메시지를 적절한 에이전트로 라우팅한다. 각 에이전트는 별도의 워크스페이스, 에이전트 디렉토리, 세션을 가지며 완전히 격리되어 동작한다. 에이전트 격리 각 에이전트는 다음이 독립적으로 분리되어 있다: 항목 설명 워크스페이스 별도의 AGENTS.md, SOUL.md 등 에이전트 디렉토리 ~/.openclaw/agents/<agentId>/ 세션 독립된 세션 저장소 도구 설정 에이전트별 사용 가능 도구 지정 샌드박스 에이전트별 격리된 실행 환경 ~/.openclaw/agents/ ├── customer-support/ # 고객 지원 에이전트 │ ├── workspace/ │ └── sessions/ ├── code-review/ # 코드 리뷰 에이전트 │ ├── workspace/ │ └── sessions/ └── scheduler/ # 스케줄 관리 에이전트 ├── workspace/ └── sessions/ 라우팅 계층 메시지가 들어오면 다음 우선순위 순서로 라우팅 대상을 결정한다. ...

Paperclip은 모든 에이전트가 사용한 모든 토큰을 추적하고, 폭주 비용을 방지하기 위해 예산 한도를 강제합니다. 비용 추적 각 에이전트 하트비트에서 보고되는 항목: 프로바이더 — LLM 프로바이더 (Anthropic, OpenAI 등) 모델 — 사용된 모델 입력 토큰 — 모델에 보낸 토큰 출력 토큰 — 모델이 생성한 토큰 비용 — 센트 단위 비용 이 메트릭은 UTC 달력 월 기준으로 에이전트별 월간 집계됩니다. 예산 설정 회사 수준 PATCH /api/companies/{companyId} { "budgetMonthlyCents": 100000 } 에이전트 수준 PATCH /api/agents/{agentId} { "budgetMonthlyCents": 5000 } 강제 임계값 임계값 조치 80% 소프트 경고 — 에이전트에게 중요 작업 우선 처리 경고 100% 하드 스톱 — 에이전트 자동 일시정지, 하트비트 중단 자동 일시정지된 에이전트는 예산 증가 또는 달력 월 전환으로 재개됩니다. ...

Paperclip은 중요한 조직 결정에 대한 인간 감독을 유지하기 위해 승인 게이트를 구현합니다. 승인 카테고리 에이전트 고용 (hire_agent) 매니저나 CEO가 부하 고용을 요청하면 hire_agent 승인이 생성됩니다. 포함 내용: 잠재 에이전트의 이름, 역할, 능력 어댑터 설정 예산 할당 CEO 전략 (approve_ceo_strategy) CEO의 초기 전략 계획은 태스크가 in_progress로 전환되기 전에 보드 승인이 필요합니다. 워크플로우 상태 pending → approved / rejected pending → revision_requested → resubmitted → pending 검토 프로세스 승인 페이지에 표시되는 항목: 요청자와 근거 컨텍스트를 제공하는 관련 이슈 전체 페이로드 (제안된 에이전트 설정 등) 보드 운영자 권한 보드 운영자는 추가 권한을 가집니다: ...

개요 OpenClaw는 30개 이상의 메시징 채널을 지원한다. 하나의 게이트웨이에서 모든 채널을 통합 관리하며, 에이전트를 한 번 설정하면 모든 채널에서 동작한다. 지원 채널 목록 주요 메시징 플랫폼 채널 텍스트 미디어 리액션 비고 WhatsApp O O O 멀티 계정 지원 Discord O O O 멀티 계정, 길드/역할 라우팅 Telegram O O O 가장 빠른 설정, 멀티 봇 Signal O O O 프라이버시 중심 iMessage O O - BlueBubbles 연동 필요 Slack O O O 워크스페이스 연동 비즈니스 메시징 채널 텍스트 미디어 리액션 비고 Google Chat O - - Google Workspace 연동 Microsoft Teams O O - MS 365 연동 소셜 및 커뮤니티 채널 텍스트 미디어 리액션 비고 Matrix O O O 탈중앙화 프로토콜 LINE O O O 아시아 시장 IRC O - - 레거시 호환 Nostr O - - 탈중앙화 소셜 웹 기반 채널 텍스트 미디어 리액션 비고 WebChat O O - 내장 웹 채팅 위젯 참고: 텍스트는 모든 채널에서 지원되지만, 미디어(이미지, 오디오, 비디오, 파일)와 리액션(이모지 반응)은 채널별로 지원 여부가 다르다. ...