본문으로 건너뛰기

OpenClaw 설치하기

nilbox Store에서 OpenClaw를 설치하고 설치 후 초기 셋업까지 완료하는 과정을 안내합니다. 버튼 한 번만 누르면 나머지는 nilbox가 알아서 처리합니다.

Before You Start​

  • nilbox 데스크톱 앱이 설치되어 실행 가능한 상태여야 합니다.
  • 첫 실행 시 Linux for nilbox 설치가 완료되어 있어야 합니다.
  • 스토어에서 앱을 설치하려면 nilbox 계정이 필요합니다.

위 항목이 아직 준비되지 않았다면 먼저 Installation 문서를 완료하세요.

1단계: 스토어 열기​

  1. nilbox 화면 오른쪽 위의 Start 버튼을 눌러 실행을 시작합니다.

    Start VM

  2. 실행이 준비되면 왼쪽 사이드바에서 Store 메뉴를 선택합니다.

    Store Menu

2단계: OpenClaw 선택​

스토어 목록에서 OpenClaw를 찾아 선택하면 상세 화면이 열립니다.

Store OpenClaw

상세 화면에는 OpenClaw 설명, 버전, 그리고 설치 버튼이 표시됩니다.

3단계: 설치 버튼 누르기​

  1. OpenClaw 상세 화면에서 설치 버튼을 누릅니다.
  2. 로그인되어 있지 않다면 nilbox 계정으로 회원가입 또는 로그인을 진행합니다.
  3. 인증이 완료되면 설치가 자동으로 시작됩니다.

이때 nilbox가 내부적으로 수행하는 작업은 다음과 같습니다.

  • OpenClaw 실행에 필요한 리눅스 의존성을 먼저 준비합니다.
  • 공식 OpenClaw 설치 파일을 OpenClaw 제공사 공식 사이트에서 직접 내려받습니다.
  • Linux for nilbox 내부에서 설치 프로그램을 자동으로 실행합니다.
설치 파일은 어디에서 오나요?

nilbox Store는 OpenClaw 설치 파일을 호스팅하지 않습니다. 검증된 설치 스크립트만 제공하며, 실제 파일은 OpenClaw 제공사 사이트에서 다운로드됩니다. 자세한 내용은 nilbox Store 문서를 참고하세요.

4단계: 설치 프로그램 실행​

OpenClaw 설치 프로그램 화면이 nilbox 안에 자동으로 표시됩니다. 화면 안내에 따라 진행하세요.

  1. 설치 프로그램 실행을 확인합니다. Setup OpenClaw

  2. 라이선스 동의 화면이 나오면 동의합니다. License OpenClaw

  3. QuickStart 선택합니다. Quick start

  4. 예시로 OpenAI Codex를 선택합니다. OpenAI OpenAI OAuth OpenAI OAuth Complete

  5. Channel 선택 통과 / Search Provider 통과 / Skill 통과 / Hook 통과

  6. 종료 확인 후 dashboard 선택 Dashboard Dashboard URL

  7. Dashboard 접속 URL 등록하기: Private Browser 화면에서 Plus(+) 버튼 눌러서 등록 Private Browser Add Dashboard

  8. Dashboard를 선택하면 OpenClaw 관리자 화면으로 접속 Select Dashboard Private Dashboard

호스트 OS에는 영향이 없습니다

OpenClaw는 Linux for nilbox 내부에 설치됩니다. 사용자의 Windows, macOS, Linux 호스트에는 어떤 파일도 쓰이지 않습니다. nilbox를 삭제하면 OpenClaw도 함께 제거됩니다.

API 토큰 보안에 관하여

입력한 API 토큰은 nilbox의 Zero Token Architecture로 보호됩니다. 실제 토큰 값은 nilbox 안에 암호화되어 저장되며, Linux for nilbox 내부의 OpenClaw에는 자리표시자 값만 전달됩니다. 자세한 동작은 Running OpenClaw Safely 문서를 참고하세요.

설치 확인​

다음 항목이 보이면 OpenClaw 설치 및 셋업이 정상적으로 완료된 것입니다.

  1. Private Browser 메뉴에서 OpenClaw 관리자 화면으로 접속 및 로그인
  2. 간단한 명령이나 프롬프트를 입력하면 연결된 LLM으로부터 응답을 받습니다.

문제 해결​

  • 설치 버튼이 비활성화되어 있어요 — nilbox에 로그인했는지, 그리고 Start 버튼을 눌러 런타임이 실행 중인지 확인하세요.
  • 설치 파일 다운로드가 실패합니다 — 네트워크 연결을 확인하세요. 실제 설치 파일은 OpenClaw 제공사 사이트에서 내려받으므로 호스트 네트워크에서 해당 사이트에 접속할 수 있어야 합니다.
  • 설치 중 디스크 공간 부족 오류 — Linux for nilbox의 디스크 크기를 늘려 주세요. 자세한 내용은 Installation 문서의 디스크 크기 안내를 참고하세요.
  • 초기 셋업 화면이 보이지 않아요 — OpenClaw를 종료하고 nilbox에서 다시 실행해 보세요. 초기 셋업 화면은 최초 1회만 표시됩니다.