# 오픈클로 셋업 방법(윈도우/맥 모두 포함)

https://nodejs.org/ko/download 

### wsl 설치하기

cmd → 관리자모드로 실행하기

wsl -l 로 리스트 확인하기

`wsl --list --online` 

배포판 설치하기 우분투 24.04

`wsl --install -d 배포판이름 ` 

예) `wsl --install -d Ubuntu-24.04`

대부분 `wsl --install -d Ubuntu` 이걸로 잡으면 최신버전 우분투가 잡혀서 무리없이 설치됨 

![Image](https://upload.cafenono.com/image/slashpageHome/20260401/182940_ZXbZlUjdg2rHOYBpnH?q=80&s=1280x180&t=outside&f=webp)

설치가 안되는 경우 

- `wsl --list --online`을 입력했을때 뭔가 설치가 안되어 있다고 하고 무언가를 다운받아서 설치를 하는 경우

    - WSL 2 Linux 커널이 구버전이거나 없는상황 : msi 다운받아 설치 [https://github.com/microsoft/WSL/releases/download/2.6.3/wsl.2.6.3.0.x64.msi](https://github.com/microsoft/WSL/releases/download/2.6.3/wsl.2.6.3.0.x64.msi) 

- 가상머신 활성화가 안되어 있는경우

    - 1단계. WSL 기능 활성화

    - `dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart` 

    - 2단계. 가상 머신 플랫폼 활성화

    - `dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart` 

    - 3단계. 재부팅 후 위의 msi 파일 설치

### user / 비밀번호 설정하기

1.사용자 계정 : user(기본값)

2.비밀번호 설정하기: 4자 이상

3.비밀번호 확인하기

![Image](https://upload.cafenono.com/image/slashpageHome/20260401/183117_cdc0dK0QYaMCSPGhhv?q=80&s=1280x180&t=outside&f=webp)

⚠️ 비밀번호 입력 시 화면에 아무것도 표시되지 않는 게 정상 (보안상 의도된 동작)

![Image](https://upload.cafenono.com/image/slashpageHome/20260401/183201_vEnc4uXDyIM60PkpU4?q=80&s=1280x180&t=outside&f=webp)

wsl설치 성공시 이렇게 터미널에 초록색+파란색 글씨가 표시

- exit를 입력해 wsl 종료하기

- wsl을 완전히 종료하기: `wsl --shutdown` 

- wsl을 다시 키기: `wsl` 

![Image](https://upload.cafenono.com/image/slashpageHome/20260401/183357_uuxqpTY5unTdPu2kWH?q=80&s=1280x180&t=outside&f=webp)

---

### [ 오픈클로 설치하기 ](https://openclaw.ai/)설치하기 

공식홈페이지에서 설치 스크립트 다운받아서 설치하기

(wsl의 경우 리눅스이므로 아래 명령어 그대로 사용가능)

> curl -fsSL [https://openclaw.ai/install.sh](https://openclaw.ai/install.sh) | bash

### homebrew설치하기 

> /bin/bash -c "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/master/install.sh](https://raw.githubusercontent.com/Homebrew/install/master/install.sh))"

자동으로 온보딩이 실행되지 않는다면

`openclaw onboard`를 입력하기

윈도우에서 직접 설치했는데 openclaw가 실행이 안되는경우

> 설치 이후 wsl을 종료했지만 여전히 openclaw가 명령어로 먹지 않는 경우(이 시스템에서 ~파일을 로드할수 없습니다. 등등)  

아래 명령어를 입력해서 보안부분을 완화 시켜줘야함

`Set-ExecutionPolicy RemoteSigned` 입력 후 

`y` 누르기

![Image](https://upload.cafenono.com/image/slashpageHome/20260314/051617_JS4lbtYjUaZEV9Xn75?q=80&s=1280x180&t=outside&f=webp)

### 오픈클로 셋팅하기(준비물 chatgpt 구독계정)

`openclaw onboard`` ` 

![Image](https://upload.cafenono.com/image/slashpageHome/20260312/233527_TmEw57mP5JPZmAVNF2?q=80&s=1280x180&t=outside&f=webp)

[https://chatgpt.com/codex/settings/usage](https://chatgpt.com/codex/settings/usage) 여기서 사용량 확인가능

![Image](https://upload.cafenono.com/image/slashpageHome/20260312/233633_hcHecdcNKv9zqtdLyd?q=80&s=1280x180&t=outside&f=webp)

### 서브 에이전트 만들기 및 텔레그램 연동하기

`openclaw agents add 이름` 

텔레그램에서 봇파더 → /newbot 이용해서 봇 만들기

-봇이름(내화면에서 보이는)

-실제 봇아이디(텔레그램에서 사용하는)

-발급받은 토큰(http api)

![Image](https://upload.cafenono.com/image/slashpageHome/20260312/233808_NjRD1bwTxTvUGBT60H?q=80&s=1280x180&t=outside&f=webp)

토큰값을 넣고 바인딩 하기

![Image](https://upload.cafenono.com/image/slashpageHome/20260312/234002_9aFUmdKT2uFbTo8KF5?q=80&s=1280x180&t=outside&f=webp)

![Image](https://upload.cafenono.com/image/slashpageHome/20260312/234019_S5LgvxHqnwKK8b6nE6?q=80&s=1280x180&t=outside&f=webp)

![Image](https://upload.cafenono.com/image/slashpageHome/20260312/234046_ZObNK66Obn9SNjXRhx?q=80&s=1280x180&t=outside&f=webp)

### 텔레그램봇과 오픈클로 페어링하기

![Image](https://upload.cafenono.com/image/slashpageHome/20260312/234102_woyjvvQKfunXiqVaQh?q=80&s=1280x180&t=outside&f=webp)

기본명령어

/new 세션 초기화

/status 현재 상태(모델, 컨텍스트 용량, 추론 모드 등을 표시)

/think 추론모드를 키거나 끄거나 adaptive 등으로 변경 가능(adaptive 권장) 

/compact 대화를 많이 했는데, 대화를 계속 이어서 하고 싶을때, 요약을 한번 하는것을 권장(50%이상 차면 무조건 하는것이 나음)

/models 에이전트에게 물릴 llm을 결정하는 부분, 프로바이더 설정에 주의할것

### 윈도우에서 자동실행 하는 패치하기

GitHubGitHub - jkf87/gateway-wsl-autostart: Configure reliable auto-start for OpenClaw Gateway on Windows + WSL2 (systemd user service setup)

이거 넣고 설치하고 적용해줘 라고 하면 끝( 모델을 gpt-5.4 , thinking은 adaptive로 사용)

###  권한부여하기

- 대쉬보드에 들어가기: 127~~ : 18789 로 되어 있음

    - 들어가는 방법 모르면  터미널에 `openclaw dashboard` 입력

    - tools에서 권한 부여하고 저장하기 (게이트웨이 재시작됨)

![Image](https://upload.cafenono.com/image/slashpageHome/20260312/235329_4NUUrP7GJnJtQYy2PA?q=80&s=1280x180&t=outside&f=webp)

### 스킬 사용하기

- 기본 스킬 정리

![Image](https://upload.cafenono.com/image/slashpageHome/20260312/235439_0cp3IAang3NNBFo9V6?q=80&s=1280x180&t=outside&f=webp)

- 커스텀 스킬 (클로드코드에서 검증된 스킬을 먼저 사용)

- 한글문서 수정하는 스킬: GitHubGitHub - jkf87/hwpx-unified-skill

    - hwpx 문서만 핸들링가능

- 스킬 직접 만들기: 자주 사용하는 작업은 `스킬로 만들어줘` 라고 요청하기

    - 만들고 다른 에이전트에게 주고 테스트 여러번 해보기(재현성을 위해서)

    - 팀 내 배포해서 같이 써보고 개선하기( 팀, 회사 전체의 고유 스킬 제작 가능)

-

For the site tree, see the [root Markdown](https://slashpage.com/conanssam.md).
