OpenClaw 처음 설정하기｜Quick start로 게이트웨이·대시보드까지 확인하는 순서

OpenClaw를 처음 설치할 때는 채널, 플러그인, 자동화까지 한 번에 정하려고 하기보다 AI가 실제로 답할 수 있는지부터 확인하는 편이 안전하다. 이 글은 OpenClaw 공식 Getting started와 Onboarding overview를 바탕으로, 처음 실행 뒤 어디까지 확인하면 되는지 한국어로 정리한 안내다. 화면과 선택지는 버전에 따라 달라질 수 있으니, 실제 실행 전에는 공식 문서도 함께 확인한다.

먼저 준비할 것

공식 문서 기준으로 OpenClaw는 Node.js 22.22.3 이상에서 시작할 수 있고 최신 권장 런타임은 Node 26이다. node --version으로 먼저 버전을 확인한다. 이미 로그인해 둔 Claude Code 또는 Codex CLI, 혹은 사용할 모델 제공사의 API 접근 경로도 필요하다. OpenClaw는 후보를 찾은 뒤 실제 완료 응답(live completion) 으로 작동 여부를 확인하며, 이 확인을 통과한 경로만 저장한다.

가장 짧은 시작

npx openclaw@latest

처음 실행이라면 보안 안내를 읽은 뒤 Quick start를 선택한다. 사용할 수 있는 로그인이나 API 접근 경로가 발견되면 이를 확인하고 설정을 저장한 뒤 Control UI 대시보드를 연다. 발견된 경로가 동작하지 않으면 수동 제공자 설정으로 이어진다. 터미널은 이때 게이트웨이를 실행 중인 상태다. 창을 닫거나 Ctrl+C를 누르면 실행은 멈추지만, 확인을 통과해 저장된 설정까지 사라지는 것은 아니다.

설정 직후에는 이 세 가지만 확인한다

1. openclaw gateway status로 게이트웨이가 실행 중인지 확인한다. 기본 안내에서는 18789 포트에서 수신하는 상태를 볼 수 있다.
2. openclaw dashboard로 Control UI를 연다. 화면이 열린다고 해서 외부 채널까지 모두 설정된 것은 아니므로, 우선은 로컬 대시보드 연결을 확인하는 단계다.
3. Control UI 채팅에 짧은 메시지를 보내 실제 답변이 오는지 확인한다. 이 한 번의 확인이 모델 접근, 게이트웨이, 대시보드 연결을 가장 작게 점검하는 방법이다.

계속 켜 둘 때

Quick start는 터미널을 열어 둔 동안 실행하는 방식이다. 계속 쓸 계획이라면 현재 실행을 Ctrl+C로 멈춘 뒤 openclaw gateway install로 게이트웨이 서비스를 설치할 수 있다. 이후에는 openclaw dashboard로 Control UI를 다시 연다. 다만 외부 접속 범위를 넓히거나 채팅 채널을 추가하거나 다른 사람과 공유하는 설정은 별도 보안 판단이 필요한 단계다.

Quick start와 Custom setup

Quick start는 이미 준비된 AI 접근 경로가 있을 때 실제 응답 확인과 기본 게이트웨이 구성을 빠르게 끝내는 선택이다. 제공자·채널·원격 게이트웨이·플러그인을 하나씩 살펴봐야 한다면 Custom setup 또는 openclaw onboard --classic이 더 맞다. 어느 쪽이든 OpenClaw는 동작하지 않는 후보를 자동으로 확정하지 않고 실제 응답 확인이 끝난 경로를 기준으로 다음 단계로 진행한다.

문제가 생기면 먼저 진단하기

대시보드나 응답이 기대와 다르면 바로 설정 파일을 지우기보다 openclaw triage 또는 openclaw doctor로 현재 상태를 확인할 수 있다. 공식 문서에 따르면 triage는 읽기 전용 검사로 진단 내용을 만들며 민감한 값·원본 대화·원본 로그는 진단 프롬프트에서 제외하도록 설계되어 있다.

OpenClaw가 어떤 프로그램인지부터 알고 싶다면 OpenClaw란? 카톡·텔레그램으로 AI 에이전트를 부리는 셀프호스팅 게이트웨이를 먼저 읽어도 좋다.

---