배경
왜 이걸 해보려고 했나
지피터스 스터디에서 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:
manualGateway: 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 에 부탁해서 사례글 완성해서 올립니다 .... 휴 .....;;
