오픈클로 (OpenClaw) 설치 및 확장성, 이게 바로 초보와 고수를 가르는 기준입니다.
pip install을 시도하다가 빨간색 에러 메시지를 보고 중도에 포기한 경험, 한 번쯤 있으셨을 겁니다.
이런 상황은 사용자의 실수가 아니라 파이썬 환경 자체가 복잡하게 꼬여서 발생하는 경우가 많습니다.
경험이 많은 개발자일수록 로컬 환경에 여러 패키지를 뒤섞어 설치하지 않습니다.
대신, 모든 것을 깔끔하게 컨테이너로 분리해 관리하는 방식을 선호합니다.
이번 안내에서는 오픈클로를 도커를 활용해 완전히 격리된 환경에 설치하는 방법을 소개하고자 합니다.
절차는 복잡하지 않습니다. 안내된 내용을 복사해 붙여넣기만 하면 설치가 완료됩니다.
1. 왜 도커 (Docker)인가? : 의존성 지옥 탈출
그냥 파이썬으로 돌리면 버전 안 맞고, 라이브러리 충돌 나고 난리 납니다.
도커 (Docker)는 이 모든 환경을 하나의 ‘박스’에 담아버리는 기술이예요.
[도커 설치의 장점]
- 환경 격리: 내 컴퓨터가 더러워지지 않음.
- 무조건 실행: 개발자 컴퓨터랑 똑같은 환경을 복제함.
- 삭제 간편: 맘에 안 들면 컨테이너만 지우면 끝.
[실행 명령어]
터미널에서 딱 한 줄만 치세요.
docker-compose up --build -d
이거 하나면 DB부터 서버까지 알아서 세팅 끝입니다.
이게 엔지니어링의 맛이죠.
2. config.yaml : AI의 뇌 구조 설계
단순히 .env 파일만 건드리는 게 아닙니다.
config.yaml 파일은 AI의 행동 양식을 결정하는 설계도입니다.
여기서 우리가 건드려야 할 핵심은 두 가지입니다.
1) 샌드박스 (Sandbox) 설정
SANDBOX_MODE: trueAI가 내 컴퓨터의 시스템 파일을 건드리지 못하게 가상 공간에 가둡니다. 보안 필수 설정이죠.
2) 워크스페이스 (Workspace) 마운트
volumes: - ./workspace:/app/workspaceAI가 작업한 결과물을 내 컴퓨터 폴더와 실시간으로 동기화 (Sync)시킵니다.
컨테이너가 꺼져도 파일은 살아남습니다.
3. 커스텀 툴 (Custom Tool) : 기능의 무한 확장
오픈클로에 기본 내장된 기능(검색, 파일 읽기)만 쓰기엔 아깝죠?
여러분이 직접 파이썬 (Python) 함수를 짜서 넣어줄 수 있습니다.
예를 들어, “사내 DB에서 매출 조회해 와” 같은 기능은 기본으로 없잖아요?
직접 만들면 됩니다.
[확장 프로세스]
tools/폴더에my_tool.py파일을 만듭니다.- 파이썬으로 원하는 기능을 함수로 짭니다. (예: SQL 쿼리 실행)
@tool데코레이터를 붙여주면 끝.
이제 프롬프트에 “매출 조회해 줘”라고 하면, AI가 여러분이 만든 코드를 실행합니다.
이게 바로 확장성 (Extensibility)의 끝판왕입니다.
로컬 설치 vs 도커 설치 비교
왜 굳이 도커를 써야 하는지, 표로 정리했습니다.
| 구분 | 로컬 (Local) 설치 | 도커 (Docker) 설치 (추천) |
| 난이도 | 쉬워 보이나 에러 많음 | 초반 세팅만 하면 끝 |
| 안정성 | 라이브러리 충돌 잦음 | 충돌 0% (완벽 격리) |
| 확장성 | 환경 변수 꼬일 수 있음 | 이미지(Image)로 배포 가능 |
| 청소 | 언인스톨 복잡함 | 컨테이너 삭제 1초 컷 |
| 전문성 | 아마추어 | 프로 엔지니어 |
안정적인 시스템을 원한다면 선택은 하나입니다.
마무리하며 : 당신은 이제 시스템 아키텍트
오픈클로 (OpenClaw)는 단순한 장난감이 아닙니다.
어떻게 세팅하느냐에 따라 거대한 자동화 서버가 될 수 있습니다.
도커 (Docker)로 튼튼한 집을 짓고, 커스텀 툴 (Custom Tool)로 가구를 채워 넣으세요.
그 순간, 오픈클로는 세상에 하나뿐인 여러분만의 강력한 무기가 됩니다.
이제 터미널을 열고 docker-compose up을 눌러보세요.
안정감 자체가 다릅니다.
자주 묻는 질문 FAQ
Q. 도커를 쓰면 컴퓨터가 느려지나요?
A. 약간의 메모리를 더 쓰긴 하지만, 윈도우(WSL2)나 맥에서는 체감상 큰 차이 없습니다. 오히려 충돌 해결하느라 쓰는 시간이 더 아까우니 도커를 쓰세요.
Q. 커스텀 툴을 만들려면 코딩을 잘해야 하나요?
A. 아닙니다. 원하는 기능을 챗GPT한테 “파이썬 코드로 짜줘”라고 한 뒤, 그 코드를 복사해서 파일로 저장만 하면 됩니다. AI가 짠 코드를 AI(오픈클로)가 실행하는 셈이죠.
Q. GPU가 없어도 되나요?
A. 네! 오픈클로는 뇌(LLM)를 클라우드 API(Claude, OpenAI)로 빌려 쓰기 때문에, 내 컴퓨터 그래픽 카드는 상관없습니다. 똥컴(?)에서도 잘 돌아갑니다.