Agent Bootstrapping 시작하기

새로운 툴을 설치하고 가장 귀찮은 순간은 역시 초기 설정이죠. 환경 변수를 맞추고, 파일 구조를 짜고, 내 정보를 일일이 입력하다 보면 정작 중요한 개발은 시작도 하기 전에 지치곤 합니다.

OpenClaw는 이 과정을 Bootstrapping이라는 단계로 자동화했어요. 에이전트가 처음 실행될 때 워크스페이스를 알아서 준비하고 필요한 정보를 수집하는 일종의 ‘첫 실행 의식’이라고 생각하면 됩니다.

필요한 것

• macOS 앱 Onboarding 완료

빠른 시작

에이전트를 처음 실행하면 5분 안에 초기 설정이 끝납니다.

1. 에이전트를 처음으로 실행하세요.
2. OpenClaw가 기본 워크스페이스 경로(~/.openclaw/workspace)에 다음 파일들을 생성합니다:
   • AGENTS.md, BOOTSTRAP.md, IDENTITY.md, USER.md
3. 터미널에 나타나는 짧은 Q&A에 답하세요. 질문은 한 번에 하나씩 진행됩니다.
4. 입력한 정체성 정보와 설정값은 IDENTITY.md, USER.md, SOUL.md 파일에 저장됩니다.
5. 모든 과정이 끝나면 BOOTSTRAP.md 파일이 삭제됩니다. 이 파일이 사라지면 초기화가 성공적으로 완료된 것입니다.

문제 해결

• 워크스페이스 파일을 찾을 수 없나요? Bootstrapping은 항상 Gateway host에서 실행됩니다. 만약 macOS 앱을 원격 Gateway에 연결했다면, 워크스페이스 파일은 로컬 PC가 아닌 원격 서버(예: user@gateway-host:~/.openclaw/workspace)에 생성됩니다.
• 설정 과정이 다시 실행되지 않나요? BOOTSTRAP.md 파일은 첫 실행이 끝나면 자동으로 삭제됩니다. 초기 설정은 딱 한 번만 수행되도록 설계되어 있으니 안심하세요.

도움이 더 필요하다면 AI Setup Assistant에게 물어보세요.

다음 단계

• Onboarding
• Agent workspace