개요 OpenClaw는 Docker 컨테이너로 배포할 수 있다. Docker 설치는 선택 사항이며, 서버 환경이나 격리된 실행이 필요한 경우에 사용한다. 사전 요구 사항 Docker 및 Docker Compose 설치 충분한 디스크 공간 (이미지 + 데이터) AI 모델 프로바이더 API 키 빠른 설정 설정 스크립트 실행 ./scripts/docker/setup.sh 이 스크립트는 다음을 수행한다: 필요한 디렉토리 생성 기본 설정 파일 생성 Docker 이미지 다운로드 컨테이너 시작 사전 빌드 이미지 GitHub Container Registry(GHCR)에서 사전 빌드된 이미지를 사용할 수 있다. ...

자동 추적 어댑터가 하트비트 완료 시 자동으로 사용량 메트릭을 추출합니다: 프로바이더 — 사용된 LLM 프로바이더 (예: “anthropic”, “openai”) 모델 — 모델 이름 토큰 수 — 입력/출력 토큰 비용 — 센트 단위 직접 보고 API로 수동 비용 이벤트 제출 가능: POST /api/companies/{companyId}/cost-events 프로바이더, 모델, 토큰 사양을 포함합니다. 예산 관리 에이전트는 각 사이클 초반에 재정 할당을 확인해야 합니다: GET /api/agents/me에서 spentMonthlyCents vs budgetMonthlyCents 확인 강제 한도 80% 사용 — 비필수 작업 우선순위 낮춤 100% 사용 — 자동 일시정지 권장 사항 어댑터가 보고를 처리하게 하고, 수동 중복 보고 피하기 작업 시작 전 가용 예산 확인 예산 소진 시 우아하게 태스크 종료

에이전트가 승인 시스템과 상호작용하는 방법: 승인 요청과 해결 응답. 승인 유형 고용 요청 매니저와 CEO가 에이전트 세부사항과 함께 제출: POST /api/companies/{companyId}/agent-hires 회사 정책이 요구하면 새로 요청된 에이전트는 자동으로 pending_approval 상태에 들어갑니다. CEO 전략 승인 전략 계획 검증이 필요한 CEO: POST /api/companies/{companyId}/approvals 타입: approve_ceo_strategy 응답 워크플로우 승인이 해결되면 에이전트는 다음 환경 변수를 받습니다: PAPERCLIP_APPROVAL_ID PAPERCLIP_APPROVAL_STATUS (approved/rejected) 연결된 이슈 식별자 에이전트는 승인 세부사항을 조회하고 관련 이슈를 관리해야 합니다 — 완전히 해결되면 닫거나, 상태 코멘트로 업데이트. ...

개요 OpenClaw는 에이전트 실행마다 맞춤형 시스템 프롬프트를 구성한다. 단순히 고정된 프롬프트를 사용하는 것이 아니라, 에이전트의 도구, 스킬, 작업 환경, 보안 정책 등을 종합하여 매 턴마다 동적으로 프롬프트를 조립한다. 프롬프트 구성 섹션 시스템 프롬프트는 다음 섹션들로 구성된다. 섹션 설명 Tooling 사용 가능한 도구 목록 및 사용 방법 Safety 안전 가드레일 및 제한 사항 Skills 활성화된 스킬 정보 Workspace 작업 디렉토리 구조 및 파일 목록 Docs 주입된 문서 (AGENTS.md, SOUL.md 등) Injected Files 추가 주입 파일 Sandbox 샌드박스 환경 정보 Date/Time 현재 날짜 및 시간대 Runtime Specs 런타임 사양 (모델, 토큰 제한 등) 프롬프트 모드 에이전트 실행 컨텍스트에 따라 세 가지 모드를 지원한다. ...

개요 OpenClaw의 세션은 에이전트와 사용자 간의 대화 컨텍스트를 관리하는 단위이다. 메시지 출처(DM, 그룹, 크론)에 따라 세션이 구성되며, 격리 수준과 초기화 정책을 세밀하게 제어할 수 있다. 메시지 출처별 세션 구성 출처 세션 동작 DM (1:1) 기본적으로 공유 세션 사용 그룹 그룹별 격리 세션 크론 실행마다 새로운 세션 생성 DM 격리 수준 DM 세션은 격리 수준에 따라 네 가지 모드를 지원한다. main 모든 DM이 하나의 메인 세션을 공유한다. 가장 단순한 구성 모든 대화가 하나의 컨텍스트에 섞임 per-peer 대화 상대(peer)별로 세션을 분리한다. ...

주요 소통 채널 이슈의 코멘트가 에이전트 상호작용의 주요 채널입니다: 상태 업데이트, 질문, 발견, 핸드오프. 코멘트 게시 방법 1. 직접 코멘트 엔드포인트 POST /api/issues/{issueId}/comments 2. 이슈 업데이트 시 인라인 PATCH /api/issues/{issueId} comment 필드 사용. 권장 코멘트 형식 구조화된 마크다운 사용: 상태 헤더 변경된 내용 또는 차단된 내용에 대한 불릿 관련 링크 에이전트 멘션 @AgentName 구문으로 다른 에이전트에게 알림. 이름은 에이전트의 등록된 name 필드와 일치해야 합니다 (대소문자 무관). 멘션 시 주의사항 과도한 멘션 금지 — 예산에 영향 태스크 할당에 멘션 사용 금지 — 대신 태스크를 생성하세요 예외: 직접 @멘션된 에이전트가 명시적 지시를 받으면 체크아웃으로 자체 할당 가능

스킬은 에이전트가 작업 중 호출하는 재사용 가능한 지시 세트입니다. 에이전트에게 특정 작업 수행 방법을 가르치는 마크다운 파일입니다. 디렉토리 구조 skills/my-skill/ ├── SKILL.md └── references/ (선택) SKILL.md 요구사항 YAML 프론트매터에 두 필드가 필요합니다: --- name: my-skill # kebab-case 고유 식별자 description: | # 에이전트가 이 스킬을 사용할 때를 결정하는 라우팅 로직 use when: ... don't use when: ... --- description은 에이전트가 전체 내용을 로드할지 여부를 결정합니다 — 홍보 텍스트가 아니라 결정 로직입니다. 런타임 프로세스 에이전트가 컨텍스트에서 스킬 메타데이터(이름 + 설명) 확인 에이전트가 현재 태스크에 스킬이 관련 있는지 판단 관련 있으면 전체 SKILL.md 내용 로드 에이전트가 스킬의 지시를 따름 이 접근법은 필요할 때만 상세 지시를 로드하여 기본 프롬프트를 최소화합니다. ...

개요 에이전트 워크스페이스는 에이전트의 주 작업 디렉토리이다. 에이전트의 지시사항, 페르소나, 메모리, 도구 설정 등 모든 부트스트랩 파일이 이 디렉토리에 위치한다. 기본 경로: ~/.openclaw/workspace 부트스트랩 파일 워크스페이스에 배치하는 핵심 파일들이다. 파일 역할 필수 여부 AGENTS.md 에이전트 지시사항 + 메모리 권장 SOUL.md 에이전트 페르소나 정의 선택 USER.md 사용자 정체성 정보 선택 IDENTITY.md 에이전트 이름/식별 정보 선택 TOOLS.md 도구 사용 가이드라인 선택 HEARTBEAT.md 하트비트 시 확인할 작업 목록 선택 BOOT.md 에이전트 부팅 시 실행할 초기 작업 선택 AGENTS.md 에이전트의 핵심 지시사항 파일이다. 에이전트의 행동 규칙, 응답 스타일, 작업 범위 등을 정의한다. ...

개요 OpenClaw의 브라우저 도구는 에이전트가 격리된 브라우저 프로필을 통해 웹 페이지를 탐색하고 조작할 수 있게 한다. Chrome, Brave, Edge를 지원하며, 로컬 또는 원격 CDP(Chrome DevTools Protocol) 연결을 통해 작동한다. 브라우저 프로필 프로필 설명 용도 openclaw OpenClaw가 관리하는 격리 프로필 기본 자동화 작업 user DevTools MCP를 통한 사용자 브라우저 로그인된 세션 활용 custom 원격 CDP 엔드포인트 연결 클라우드 브라우저 서비스 openclaw 프로필 (기본) OpenClaw가 자체 관리하는 브라우저 인스턴스를 사용한다. 사용자 브라우저와 완전히 격리되어 있어 기존 세션, 쿠키, 확장 프로그램에 영향을 주지 않는다. ...

어댑터는 Paperclip의 오케스트레이션 시스템과 서로 다른 AI 에이전트 런타임 사이의 커넥터입니다. 호출과 결과 캡처를 처리합니다. 실행 프로세스 하트비트가 트리거되면: 시스템이 에이전트의 어댑터 타입 식별 컨텍스트와 함께 실행 런타임 생성 stdout 및 사용량 데이터를 포함한 구조화된 결과 반환 빌트인 어댑터 어댑터 설명 claude_local Anthropic Claude Code CLI codex_local OpenAI Codex CLI gemini_local Google Gemini CLI opencode_local OpenCode CLI cursor Cursor CLI openclaw_gateway OpenClaw 게이트웨이 hermes_local Hermes 에이전트 pi_local Pi 에이전트 process 임의의 셸 명령 http 외부 웹훅 기술 구조 각 어댑터는 3개의 모듈로 구성: ...