에이전트 부트스트래핑

부트스트래핑은 에이전트 작업 영역을 준비하고 신원 세부 정보를 수집하는 최초 실행 절차입니다. 온보딩 후 에이전트가 처음 시작될 때 발생합니다.

# 부트스트래핑이 하는 일

첫 에이전트 실행 시 OpenClaw는 작업 영역(기본값 ~/.openclaw/workspace)을 부트스트랩합니다.

• AGENTS.md, BOOTSTRAP.md, IDENTITY.md, USER.md를 시드합니다.
• 짧은 질의응답 절차를 실행합니다(한 번에 한 질문씩).
• 신원 + 기본 설정을 IDENTITY.md, USER.md, SOUL.md에 씁니다.
• 완료되면 BOOTSTRAP.md를 제거하여 한 번만 실행되도록 합니다.

임베디드/로컬 모델 실행의 경우, OpenClaw는 BOOTSTRAP.md를 권한 있는 시스템 컨텍스트에서 제외합니다. 기본 대화형 최초 실행에서는 read 도구를 안정적으로 호출하지 않는 모델도 절차를 완료할 수 있도록 여전히 사용자 프롬프트에 파일 내용을 전달합니다. 현재 실행에서 작업 영역에 안전하게 접근할 수 없는 경우, 에이전트는 일반 인사말 대신 제한된 부트스트랩 노트를 받습니다.

# 부트스트래핑 건너뛰기

미리 시드된 작업 영역에서 이를 건너뛰려면 openclaw onboard --skip-bootstrap를 실행하세요.

# 실행 위치

부트스트래핑은 항상 Gateway 호스트에서 실행됩니다. macOS 앱이 원격 Gateway에 연결되는 경우 작업 영역과 부트스트래핑 파일은 해당 원격 머신에 있습니다.

# 관련 문서

• macOS 앱 온보딩: 온보딩
• 작업 영역 레이아웃: 에이전트 작업 영역