오픈클로란? — 설치 전 3가지만 확인하세요

오픈클로가 뭔가요? — 1분 요약

한 문장으로 설명하면 이렇습니다.

Slack에서 AI에게 메시지를 보내면, AI가 대신 일해주는 시스템입니다.

예를 들어 Slack에서 봇에게 "오늘 회의록 요약해줘"라고 메시지를 보내면, 몇 초 뒤에 AI가 요약한 내용이 Slack으로 돌아옵니다. ChatGPT 사이트를 따로 열 필요가 없습니다. Slack 하나로 끝납니다.

오픈클로로 실제로 할 수 있는 일

왜 내 컴퓨터에 설치해야 하나요?

ChatGPT 사이트나 앱을 쓰면 되지, 왜 굳이 설치하냐고 생각할 수 있습니다. 차이는 이렇습니다.

• ChatGPT 사이트: 매번 사이트를 열고, 복사 붙여넣기를 반복해야 합니다. 자동화가 안 됩니다.
• 오픈클로: Slack에서 한 번 설정해두면, 이후는 자동으로 돌아갑니다. 반복 작업을 AI에게 완전히 맡길 수 있습니다.

그리고 오픈클로 에이전트 런타임은 내 컴퓨터에서 직접 실행됩니다. 단, AI 모델(ChatGPT/Claude)에 질문을 보낼 때 그 대화 내용은 해당 서비스(OpenAI/Anthropic) 서버를 경유합니다. 내 로컬 파일이나 설정은 외부로 나가지 않습니다.

왜 WSL이 필요한가요? — 쉽게 설명

"WSL"이라는 단어가 낯설 수 있습니다. 걱정 마세요. 딱 이것만 알면 됩니다.

WSL = 윈도우 안에 작은 리눅스 방 하나를 만드는 것

오픈클로는 원래 리눅스(맥북 내부 환경과 같은 계열)에서 잘 돌아가도록 만들어졌습니다. 윈도우에 그냥 설치하면 아래 같은 오류들이 자주 생깁니다.

Error: Cannot find module    ← 파일 경로 방식이 달라서
EACCES: permission denied   ← 권한 문제
spawn ENOENT                ← 리눅스 전용 실행 파일을 찾지 못해서

이런 오류들이 생기면 원인을 찾기가 어렵고, 초보자는 거의 해결하지 못합니다. 그래서 오픈클로 공식 문서도 윈도우 사용자에게는 WSL을 통한 설치를 권장합니다.

WSL은 마이크로소프트가 공식으로 만든 기능이라 별도 프로그램을 구매할 필요가 없습니다. 윈도우 10/11에 이미 포함되어 있습니다. 명령어 한 줄로 설치됩니다.

설치 전 딱 3가지만 확인하세요

이 확인을 건너뛰면 설치 중간에 막힐 수 있습니다. 3분이면 됩니다.

① 윈도우 버전 확인 (Windows 10 사용자만)

Windows 11이라면 이 확인은 건너뛰어도 됩니다.

Windows 10을 쓰고 있다면, 키보드에서 윈도우 키 + R을 동시에 누릅니다. 작은 창이 열리면 winver를 입력하고 엔터를 누릅니다.

화면에 "버전 2004" 또는 그보다 큰 숫자(예: 21H1, 22H2)가 보이면 통과입니다.

버전이 너무 낮다면? 윈도우 업데이트 센터(설정 → Windows 업데이트)에서 최신 버전으로 업데이트 후 진행합니다.

② 디스크 여유 공간 확인

파일 탐색기에서 내 PC를 클릭합니다. C: 드라이브에 여유 공간 5GB 이상이 있어야 합니다. C: 드라이브를 마우스로 가리키면 여유 공간이 표시됩니다.

5GB가 안 된다면? 사용하지 않는 파일이나 프로그램을 삭제하거나, 외장 드라이브로 파일을 옮겨서 공간을 확보합니다.

③ CPU 가상화 켜져 있는지 확인

WSL을 쓰려면 CPU 가상화 기능이 활성화되어 있어야 합니다. 대부분의 컴퓨터에서 기본으로 켜져 있습니다.

확인 방법: Ctrl + Shift + Esc를 동시에 누릅니다(작업 관리자가 열립니다). 상단의 "성능" 탭을 클릭합니다. 왼쪽에서 CPU를 선택합니다. 오른쪽 아래에 **"가상화: 사용"**이라고 표시되면 통과입니다.

작업 관리자 → 성능 탭 → CPU → 오른쪽 아래 "가상화: 사용" 확인

"가상화: 사용 안 함"이라고 뜨면?

참고: 가상화가 꺼져 있는 경우는 전체의 5% 미만입니다. 대부분은 "사용"으로 표시됩니다.

어떤 계정이 필요한가요?

설치 전에 아래 두 가지 계정을 준비해두면 Step 4, 5에서 바로 진행할 수 있습니다.

Slack 계정 — 무료로 만들 수 있습니다. 이미 있다면 그것을 사용합니다. 새 워크스페이스를 별도로 만드는 것을 권장합니다(테스트용으로 쓰기 좋습니다).

AI 모델 계정 — 처음이라면 ChatGPT(OpenAI) 계정을 만드세요. 이유는 아래에 설명합니다.

API 키가 뭔가요? — 쉽게 말하면 AI 서비스에 접속할 때 사용하는 비밀번호 같은 것입니다. 나중에 Step 4에서 발급 방법을 스크린샷과 함께 안내합니다.

전체 설치 과정 한눈에 보기

3가지 확인이 모두 됐다면 Step 2로 이동해서 WSL 설치를 시작합니다.