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

wsl 설치하기

cmd → 관리자모드로 실행하기
wsl -l 로 리스트 확인하기
wsl --list --online
배포판 설치하기 우분투 24.04
wsl --install -d 배포판이름
예) wsl --install -d Ubuntu-24.04
대부분 wsl --install -d Ubuntu 이걸로 잡으면 최신버전 우분투가 잡혀서 무리없이 설치됨
설치가 안되는 경우
wsl --list --online을 입력했을때 뭔가 설치가 안되어 있다고 하고 무언가를 다운받아서 설치를 하는 경우
WSL 2 Linux 커널이 구버전이거나 없는상황 : 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.비밀번호 확인하기
⚠️ 비밀번호 입력 시 화면에 아무것도 표시되지 않는 게 정상 (보안상 의도된 동작)
wsl설치 성공시 이렇게 터미널에 초록색+파란색 글씨가 표시
exit를 입력해 wsl 종료하기
wsl을 완전히 종료하기: wsl --shutdown
wsl을 다시 키기: wsl
공식홈페이지에서 설치 스크립트 다운받아서 설치하기
(wsl의 경우 리눅스이므로 아래 명령어 그대로 사용가능)

homebrew설치하기

자동으로 온보딩이 실행되지 않는다면
openclaw onboard를 입력하기
윈도우에서 직접 설치했는데 openclaw가 실행이 안되는경우
설치 이후 wsl을 종료했지만 여전히 openclaw가 명령어로 먹지 않는 경우(이 시스템에서 ~파일을 로드할수 없습니다. 등등)
아래 명령어를 입력해서 보안부분을 완화 시켜줘야함
Set-ExecutionPolicy RemoteSigned 입력 후
y 누르기

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

openclaw onboard
https://chatgpt.com/codex/settings/usage 여기서 사용량 확인가능

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

openclaw agents add 이름
텔레그램에서 봇파더 → /newbot 이용해서 봇 만들기
-봇이름(내화면에서 보이는)
-실제 봇아이디(텔레그램에서 사용하는)
-발급받은 토큰(http api)
토큰값을 넣고 바인딩 하기

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

기본명령어
/new 세션 초기화
/status 현재 상태(모델, 컨텍스트 용량, 추론 모드 등을 표시)
/think 추론모드를 키거나 끄거나 adaptive 등으로 변경 가능(adaptive 권장)
/compact 대화를 많이 했는데, 대화를 계속 이어서 하고 싶을때, 요약을 한번 하는것을 권장(50%이상 차면 무조건 하는것이 나음)
/models 에이전트에게 물릴 llm을 결정하는 부분, 프로바이더 설정에 주의할것

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

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

권한부여하기

대쉬보드에 들어가기: 127~~ : 18789 로 되어 있음
들어가는 방법 모르면 터미널에 openclaw dashboard 입력
tools에서 권한 부여하고 저장하기 (게이트웨이 재시작됨)

스킬 사용하기

기본 스킬 정리
커스텀 스킬 (클로드코드에서 검증된 스킬을 먼저 사용)
한글문서 수정하는 스킬: GitHubGitHub - jkf87/hwpx-unified-skill
hwpx 문서만 핸들링가능
스킬 직접 만들기: 자주 사용하는 작업은 스킬로 만들어줘 라고 요청하기
만들고 다른 에이전트에게 주고 테스트 여러번 해보기(재현성을 위해서)
팀 내 배포해서 같이 써보고 개선하기( 팀, 회사 전체의 고유 스킬 제작 가능)