본문으로 건너뛰기

OpenClaw 로컬 설치기 ― 실치에 실패가 맞을까요?

김춘식

2026.02.08

배경

왜 이걸 해보려고 했나

지피터스 스터디에서 OpenClaw를 소개받고
“Docker 기반 멀티 에이전트 + IDE 최소화”라는 설명이 꽤 흥미로워서
로컬 PC에 직접 설치해서 구조를 한번 보고 싶었습니다.

스터디 자료에는 비교적 간단하게

http://localhost:18789 에 접속하면 웹 대시보드를 볼 수 있다

라고 되어 있었고,
그래서 제 목표도 단순히 “로컬 설치 → 웹 대시보드 접속” 이었습니다.


설치 환경

  • Windows 11

  • Docker Desktop (WSL2 기반)

  • WSL: Ubuntu

  • LLM 연동: ChatGPT Plus → OpenAI Codex (OAuth)

Docker, WSL, Git 모두 사전에 정상 동작 확인된 상태였습니다.


진행 과정

(여기까지는 큰 문제 없었다고 생각합니다)

1️⃣ OpenClaw 다운로드 & 설정 스크립트 실행

처음엔 Windows PowerShell에서 실행하려다 안 돼서
WSL(Ubuntu) 환경으로 전환했습니다.

cd /mnt/c/Users/내계정/openclaw
./docker-setup.sh

설정 마법사(Onboarding)는 GPT 도움 받아서 아래처럼 진행했습니다.

  • Onboarding mode: manual

  • Gateway: Local gateway

  • Model provider: OpenAI Codex (ChatGPT OAuth)

  • Tailscale: No

  • Port: 18789

  • Auth: Token

  • Skills: 기본만

질문은 많았지만, 중간에 에러 없이 끝까지 완료되었습니다.


2️⃣ OAuth 인증 과정 (여기서 살짝 불안)

ChatGPT OAuth 선택 후
브라우저에서 로그인 → 승인까지는 정상.

이후 localhost:xxxx/auth/callback 으로 이동하면서
ERR_CONNECTION_REFUSED 페이지가 뜸.

처음엔

“어? 이거 실패한 거 아냐?”

싶었는데,
GPT 설명으로는 이 화면 자체는 중요하지 않고
👉 주소창의 callback URL을 터미널에 붙여넣는 게 핵심이라고 해서 그대로 진행했습니다.

일단 설정은 완료 메시지까지는 나왔음.


문제 발생

그런데 localhost:18789 가 안 열림

스터디 자료에 나온 대로

http://localhost:18789

접속 → ❌ 접속 불가

여기서부터 좀 애매해졌습니다.

  • 설치가 덜 된 건가?

  • Docker가 제대로 안 떠 있는 건가?

  • 내가 중간에 뭔가 잘못 선택한 건가?


헷갈렸던 포인트들

1️⃣ docker ps 결과

docker ps

아무 컨테이너도 안 떠 있음.

이 시점에서 든 생각은:

“어… 그럼 설치는 된 건데, 실행은 안 된 상태인가?”

스터디 자료에는 이 부분이 명확하게 구분돼 있지 않아서
설정 완료 = 실행 중이라고 착각했던 것 같습니다.


2️⃣ docker compose up 을 내가 해야 하는 구조?

이후에 찾아보니
Onboarding은 말 그대로 설정만 해주는 단계고
실제 서버는

docker compose up -d

를 해야 뜨는 구조처럼 보이는데,
이게 문서상으로는 살짝 애매하게 느껴졌습니다.

👉 “이걸 내가 놓친 건지, 문서가 간단화된 건지 잘 모르겠다”
이게 현재 제 상태입니다.


3️⃣ GitHub clone도 중간에 막힘

추가로 겪은 문제 하나는 GitHub clone이었습니다.

git clone https://github.com/openclaw-ai/openclaw.git

웹 로그인은 되는데
CLI에서는 계속 인증 실패.

알고 보니 GitHub가 비밀번호 인증을 완전히 막은 상태라
SSH 키 방식으로 다시 설정해야 했습니다.

이건 제 실수라기보다는
요즘 GitHub 정책 변화 영향 같았습니다.


현재 상태 요약

  • Docker / WSL: 정상

  • OpenClaw 설정(Onboarding): 완료

  • OAuth 인증: 완료된 것으로 보임

  • docker ps: 실행 중 컨테이너 없음

  • localhost:18789: 접속 불가

그래서 지금 제 결론은 이겁니다 👇

❓ 이게 내가 중간에 뭘 잘못한 건지
❓ 아니면 OpenClaw 구조가 “설정”과 “실행”이 분리된 건지
아직 명확히 판단이 안 됩니다.



한 줄 요약

“안 된 건 맞는데,
이게 내가 틀린 건지 구조가 원래 이런 건지 아직 잘 모르겠다.”


어제 바쁜일로 '모각' 에 못가고 집에서 종일 씨름을 했는데 ㅎㅎ 결국 실패를 한걸까요? '리부티너' 님 OpenClaw 써본 사례글 부러워 하다가 ... 힘빠져서 GPT 에 부탁해서 사례글 완성해서 올립니다 .... 휴 .....;;

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

리부티너 프로필 이미지
리부티너2026.02.08

그대의 모험을 응원합니다.
모든 삽질은 성장의 걸음이다!
언제든 하다 막히시면 화면 캡쳐해서 문의 주십시오.
제가 아는 선에서 도움 드릴께요. 모르는 건 ㅎㅎ

김춘식 프로필 이미지
김춘식2026.02.08

감솨합니다 ^^;; 리부티너님의 열정이 부럽고 멋지시네용 ~ ㅎ

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기