[Local LLM 구축하기 22] OpenClaw 설치와 Gateway 확인

Local LLM 구축하기 · 22/30 · 에이전트와 연결

전체 연재와 학습 순서 · 실습 코드 ZIP

OpenClaw는 대화 화면과 모델 제공자, 도구, 메신저를 연결하는 프로그램입니다. 모델 추론을 맡는 Ollama와 따로 동작해요. 설치 뒤에는 CLI 실행, Gateway 시작, 모델 응답을 순서대로 확인합니다.

9편에서 준비한 Node와 npm의 버전·경로를 확인합니다. 모델 서버는 기존 Windows Ollama를 사용합니다.

Node 요구 조건과 CLI 설치

설치 전에 Node와 npm부터 다시 확인합니다. 2026년 10월 18일 기준 공식 문서의 요구 조건은 Node 24.16 이상 또는 26.1 이상입니다. 패키지의 engines도 함께 조회하고, 설치하는 날의 문서와 메타데이터를 기준으로 판단합니다.

node --version
npm.cmd view openclaw version engines
npm.cmd install -g openclaw@latest
openclaw --version
openclaw --help

PowerShell 정책이 openclaw.ps1을 막는다면 openclaw.cmd로 같은 명령을 실행할 수 있습니다. 전체 실행 정책을 관리자 권한으로 완화하기 전에 확인해 보세요. Node가 여러 경로에 있다면 where.exe 결과에서 실제 사용 중인 설치를 먼저 찾습니다.

Gateway와 모델 서버

Gateway는 채널과 세션, 제공자 연결을 조정합니다. 추론은 Ollama 서버나 외부 API가 맡습니다. Gateway가 켜져도 모델 서버가 꺼져 있으면 답을 받지 못하므로 두 상태를 따로 확인합니다.

구성	이 연재의 위치
Node·OpenClaw CLI	Windows 일반 사용자 환경
Gateway·대시보드	같은 PC, 기본 18789 안내 확인
모델 서버	2편의 Windows Ollama 11434
외부 채널	첫 실습에서는 연결하지 않음

첫 확인은 로컬 대시보드에서 진행합니다. 메신저를 먼저 연결하면 봇 토큰과 사용자 허용 목록, 외부 통신까지 점검할 항목이 늘어요. 대시보드에서 모델의 답을 받은 뒤 채널을 하나씩 추가합니다.

로컬 제공자 온보딩

openclaw onboard --classic

온보딩 안내를 읽으며 Ollama와 Local only를 선택합니다. 기존 로그인이나 외부 제공자를 사용하는 경로와 혼동하지 않도록 확인하세요. 주소와 모델은 다음 글에서 점검합니다. 화면의 메뉴가 바뀌었다면 현재 공식 온보딩 안내를 따릅니다.

이미 쓰던 설정이 있다면 먼저 설정과 workspace를 백업합니다. 온보딩 과정에서 제공자나 기본 모델이 바뀔 수 있습니다. 별도 프로필이나 실습용 계정에서 시작하고 민감한 업무 폴더를 workspace로 지정하지 않습니다.

상주 서비스와 응답 확인

정상 대화가 확인된 후 Gateway를 계속 실행할 목적이라면 아래 명령을 적용합니다. native Windows에서는 예약 작업 또는 안내된 로그인 시작 방식이 사용될 수 있습니다. WSL에서는 Linux 사용자 서비스 방식이므로 동작과 시작 조건이 다릅니다.

openclaw gateway install
openclaw gateway status
openclaw dashboard
# 실습 종료 시
openclaw gateway stop

대시보드가 열린 뒤에는 짧은 질문에 실제 답이 오는지 확인합니다. 로그를 공유할 때는 키와 원문을 지우고 설정 전체를 공개하지 않습니다. 다음 글에서 Ollama 주소와 도구 호출을 이어서 점검합니다.

참고 자료

• OpenClaw 시작
• OpenClaw Windows 지원
• OpenClaw 온보딩

문서·모델 태그 확인 기준: 2026년 10월 18일. 기본 실습 환경: Windows 11 x64.

---