[Linux] 나만의 AI 에이전트 OpenClaw 구축하기

 

안녕하세요. 주식회사 서버몬 입니다.

오늘은 단순히 대화만 하는 AI가 아니라, 내 명령을 받아 실제로 작업을 수행해 주는 오픈소스 AI 에이전트, OpenClaw를 소개하고 윈도우 환경(WSL)에서 구축하는 방법을 정리해 보려 합니다.

특히 API 비용 부담을 줄이기 위해 OpenRouter 를 통해 무료모델을 활용하는 방법과 메신저 연동까지 다뤄보겠습니다

 

OpenClaw란?

 

 

OpenClaw는 사용자의 로컬 머신이나 서버에 상주하며 다양한 LLM(Large Language Model)을

두뇌로 사용하여 작업을 수행하는 개인화된 AI 에이전트입니다.

 

핵심 특징

• Bring Your Own LLM: OpenAI, Anthropic, Google Gemini 등 원하는 모델을 자유롭게 연결 가능
• Multi-Platform: 텔레그램, 디스코드, 슬랙, 왓츠앱 등 다양한 메신저를 인터페이스로 사용.
• Agentic Capabilities: 단순 답변 생성을 넘어 파일 읽기/쓰기, 웹 브라우징, 일정 관리 등 '행동'이 가능함.
• Privacy: 로컬에서 구동되므로 데이터 주권이 사용자에게 있음.

장단점 분석

구분	장점 (Pros)	단점 (Cons)
확장성	다양한 플랫폼(메신저)과 모델을 쉽게 연결 가능	초기 설정(Node.js, Docker 등)이 비개발자에겐 다소 복잡할 수 있음
비용	오픈소스(무료)이며, OpenRouter 무료 모델 사용 시 유지비 '0'원 가능	로컬 설치형이므로 구동할 서버나 PC가 켜져 있어야 함
기능	플러그인/스킬 형태로 기능 무한 확장 가능 (코딩, 검색 등)	아직 초기 단계라 문서화가 완벽하지 않거나 버그가 있을 수 있음

 

 

설치 환경 준비 (Windows WSL)

OpenClaw는 리눅스 환경에 최적화되어 있습니다.

윈도우 사용자는 **WSL2(Windows Subsystem for Linux)**를 사용하는 것이 가장 좋습니다.

 

WSL2 및 Ubuntu 설치

PowerShell을 관리자 권한으로 실행 후 다음 명령어를 입력합니다.

wsl –install

 

* 설치 후 재부팅이 필요할 수 있으며, 기본적으로 Ubuntu가 설치됩니다.

wsl

 

위 명령어로 신규 설치된 Ubuntu 시스템으로 접속 합니다.

 

필수 패키지 설치 (Node.js 22+ 필수)

OpenClaw는 최신 Node.js 환경(v22 이상)을 요구합니다. 열고 아래 명령어로 환경을 세팅합니다.

# 패키지 목록 업데이트
sudo apt update && sudo apt upgrade -y

# Node.js 22.x 설치 (공식 NodeSource 스크립트 사용)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 버전 확인 (v22 이상이어야 함)
node -v
npm -v

 

 

OpenClaw 설치 및 초기 설정

 

설치 스크립트 실행

가장 간편한 설치 방법은 공식 스크립트를 사용하는 것입니다.

터미널에서 아래 명령어를 실행합니다.

curl -fsSL https://openclaw.ai/install.sh | bash

 

설치가 완료되면 openclaw 보안 경고문이 생성됩니다.

Yes 를 선택 합니다.

 

 

지원하는 모델과 제공자 목록을 확일 할수 있습니다.

GPT, Aturhpic,  Goolgle 등 다양한 모델을 설정 할수 있습니다.

이번 포스팅에서는 무료 모델을 사용해보는 것이 목적이기에 OpenRouter 를 선택합니다.

 

 

OpenRotuer 의 서비스를 사용하기 위해서는 API Key 를 발급 받아야 합니다.

OpenRouter에서 회원 가입 후 API Key를 발급 합니다

 

 

 

생성된 API 키는 다시는 볼수 없으니 잘 보관 합니다.생성한 API 를 붙혀 넣고 진행합니다. 

 

OpenRouter 에서는 Preview 용 모델을 무료로 사용할 수 있도록 공개하고 있습니다.

Arcee AI 의 Trinity Large Preview (free) 로 설정해보겠습니다.

 

 

에이전트와 통신할 채널을 설정합니다. 지금은 설정하지 않을것 입니다.

Skip for now 로 넘어갑니다.

 

에이전트가 사용할 Skills 를 선택 합니다. 필요한 기능을 활성화 합니다.

 

에이전트 초기 구성이 끝났습니다.

 

 

아래 명령어로 서버의 전체 상태를 확인 합니다.

openclaw status

 

 

이제 에이전트와 대화 해보겠습니다.

웹으로 기본 테스를 하기 위해서는 서버의 고유 Token 값을 확인 해야 합니다.

아래 명령어로 확인 합니다.

cat ~/.openclaw/openclaw.json | grep Token

 

http://127.0.0.1:18789/overview  로 웹페이지를 접속 하면 Gateway Token 을 입력 하는 메뉴가 나옵니다.

 

 

확인한 Gateway Token 을 입력하여 활성화 합니다.

 

 

Chat 메뉴로 이동하여 에이전트와 대화를 해봤습니다.

 

 

메신저 연동 

에이전트와 소통을 사용하는 다양한 메신저와 연동할 수 있습니다.

 

텔레그램 (Telegram) 연동

봇 생성:

텔레그램에서 @BotFather를 검색하여 대화를 시작하고 /newbot을 입력합니다.

 

봇 이름을 생성합니다

생성시 반드시 ** bot 의 형태로 생성합니다 ex) serverx001_bot

 

토큰 발급:

봇 이름과 사용자명을 설정하면 HTTP API Token을 생성해 줍니다.

WSL 터미널에서 다음 명령어로 텔레그램 채널 설정합니다.

 

openclaw config

 

채널을 선택 합니다.

 

텔레그램을 선택하고 설정 합니다.

 

BotFather 가 생성해준 Telegarm Bot Token 을 입력 합니다.

 

설정이 완료 되면 생성한 봇을 검색하여 대화를 시작 합니다.

 

 봇이 "Pairing code: 123456" 같은 코드를 답장으로 보냅니다.

 WSL 터미널에 다음 명령어를 입력하여 승인합니다.

openclaw pairing approve telegram 123456

 

생성한 봇과 대화가 가능합니다.

 

 

디스코드 (Discord) 연동

애플리케이션 생성:

Discord Developer Portal에 접속하여 'New Application'을 만듭니다.

 

 

봇 설정:

'Bot' 메뉴로 이동하여 'Reset Token'을 눌러 토큰을 복사합니다.

중요: Privileged Gateway Intents 항목에서 **"Message Content Intent"** 를 반드시 켜야 합니다.

 

 

서버 초대:

'OAuth2' -> 'URL Generator'에서 bot 체크 후, 하단의 Administrator (혹은 필요한 권한)를 체크하여 생성된 URL로 자신의 서버에 봇을 초대합니다.

 

 

 

생성한 URL 을 통해 봇을 추가 합니다

 

아래 명령어로 discord 채널을 설정 합니다.

openclaw config

 

 

 

Application 생성단계에서 생성한 Token 을 붙혀넣고 설정을 종료 합니다

 

초대한 채널에서 @봇이름 을 통해 대화를 할 수 있습니다.

 

마치며

OpenClaw는 우리가 AI를 어떻게 받아들여야 할지에 대해 깊이 고민하게 만드는 계기가 되었습니다.

지금까지 로컬 파일을 제어하려면 별도의 IDE나 터미널 도구를 거쳐야 했지만, 이제는 익숙한 메신저 하나로 AI에게 명령을 내리고 즉각적인 피드백을 받을 수 있게 되었습니다. 이러한 직관적인 경험은 우리가 왜 AI를 적극적으로 활용해야 하는지 보여주는 가장 확실한 이유이기도 합니다.

아이언맨의 '자비스'가 더 이상 공상과학 속 이야기가 아닌 현실이 된 지금, 우리는 그 거대한 변화의 한가운데 서 있습니다.

이번 포스팅에서 미처 다루지 못한 Skill 확장이나 반복 작업을 위한 SubAgent 기능은 다음 기회에 심도 있게 다뤄보겠습니다.

 

 

 

1U서버 / 2U서버 / AI서버 / alyac / APC / APC UPS / backup / carepack / centos / chakramax / cuda / DAS / DB / DB서버 / defog / DEFOG랙 / dell5820 / dell5820t / dell7920 / dellpoweredge / dellr240 / dellr340 / dellr350 / dellr450 / dellr540 / dellr630 / dellr640 / dellr740 / dellr750 / dellserver / dellt40 / dellt440 / dellt5820 / dell서버 / DELL서버CPU / DELL서버RAID컨트롤러 / DELL서버SAS하드디스크 / DELL서버가격비교 / DELL서버가격비교견적 / DELL서버견적 / DELL서버구매 / DELL서버디스크교체 / DELL서버메모리 / dell서버서버몬 / DELL서버펌웨어 / DELL서버하드디스크구매 / dell옵션 / dell워크스테이션 / dl20 / dl20gen10 / dl20gen11 / dl360 / dl360gen10 / dl360gen11 / dl380 / dl380g10 / dl380gen10 / dl380gen11 / ECC메모리 / EDFOG랙가격 / embedded / est security / ESTSOFT / FIRMWARE / GPU / gpu서버 / gpu타워형서버 / greenlake / HA솔루션 / HP GPU / hp hdd / hpdl20 / HPDL20Gen10 / hpdl360 / hpdl360gen10 / hpdl380 / hpdl380g10 / HPDL380Gen10 / HPE / HPE GPU / hpe hdd / hpe rok / HPE Service Pack for Proliant / HPE SPP / hpe ssa / hpedl20 / hpedl20gen10 / hpedl360gen10 / hpe서버 / HPE서버CPU / HPE서버RAID컨트롤러 / HPE서버SAS하드디스크 / HPE서버가격비교 / HPE서버가격비교견적 / HPE서버견적 / HPE서버구매 / HPE서버드라이버설치 / HPE서버디스크교체 / HPE서버메모리 / HPE서버비용 / hpe서버소음 / HPE서버펌웨어 / HPE서버하드디스크구매 / hpe옵션 / hpe정품 / hpgen10 / hpml30 / hpserver / hpz2 / hpz4 / hpz4g4 / hpz6g4 / hpz8g4 / hp마이크로서버 / hp서버 / hp서버cto / hp서버pc / HP서버메모리 / hp서버소음 / hp서버컴퓨터 / HP서버파워 / HP서버펌웨어 / HP서버하드디스크 / hp옵션 / hp워크스테이션 / hp정품 / hp프로라이언트 / HYPER BACKUP / ibm서버 / ilo / Intelligent Provisioning / internetdisk / KVM / KVM 기술지원비(비용) / KVM 설치비 / L2스위치 / L3스위치 / LENONO서버SAS하드디스크 / lenovop620 / lenovor650 / LENOVO서버 / LENOVO서버CPU / LENOVO서버RAID컨트롤러 / LENOVO서버가격비교 / LENOVO서버가격비교견적 / LENOVO서버견적 / LENOVO서버구매 / LENOVO서버디스크교체 / LENOVO서버메모리 / LENOVO서버하드디스크구매 / LENOVO펌웨어업데이트 / Linux / ML30 / ml30gen10 / ml30gen11 / ML350GEN10 / ml350gen11 / ML360 / MS CSP / MSSQL / MSSQL 기술지원비(비용) / MSSQL 설치비 / MYSQL / MySQL 기술지원비(비용) / MySQL 설치비 / NAS / NVIDIA / Office 365 / oneview / orange / OS설치 / PA-410 / PA-440 / paloalto / poweredger740 / poweredger750 / precision5820 / QUADRO / r240 / r250 / r340 / r360 / r440 / r550 / r650 / r660 / r740 / r750xs / r760 / r760xs / RAID / redhat / RHEL설치 / RMS랙 / rocky / s100i / securedisk / server / serverpc / smart storage administrator / SPP / sql server / sr250 / sr650 / SYNOLOGY / SYNOLOGY나스 / t150 / t360 / UPS / UPS기술지원 / UPS납품 / UPS설치 / V3 / veeam / vroc / windows server / Windows서버설치 / XEON서버 / z8g4 / 가상서버 / 가성비서버 / 기술지원비(비용) / 나스기술지원 / 나스설치지원 / 네트워크스위치 / 네트워크장비 / 더블테이크 / 데이터베이스 / 델5820 / 델서버 / 델서버비용 / 델서버펌웨어업데이트 / 델옵션 / 델워크스테이션 / 델컴퓨터워크스테이션 / 디포그 / 디포그랙 / 디포그랙가격 / 딥러닝 / 딥러닝pc / 딥러닝서버 / 랙 / 랙(RACK) 기술지원비(비용) / 랙(RACK) 설치비 / 랙납품설치 / 랙설치 / 레노버p620 / 레노버서버 / 레노버워크스테이션 / 레노보서버 / 레노보서버펌웨어 / 레드헷설치 / 레이드 / 레이드구성 / 록키리눅스 / 리눅스 / 리눅스 기술지원비(비용) / 리눅스 설치비 / 리눅스서버 / 리눅스서버설치 / 리눅스서버트러블슈팅 / 리눅스트러블슈팅 / 문서보안 / 문서중앙화 / 미니서버 / 미니서버랙 / 미니서버렉 / 미디어서버 / 방화벽 / 방화벽 기술지원비(비용) / 방화벽 설치비 / 방화벽엔지니어 / 백업 / 백업 기술지원비(비용) / 백업 서버 / 백업서비스 / 백업솔루션 / 보안솔루션 / 보안솔루션구매 / 보안솔루션설치 / 보안툴 / 빔백업 / 샤크라맥스 / 서버 / 서버 기술지원비(비용) / 서 버 랙마운트비용 / 서버 설치비 / 서버 장애조치비용 / 서버CPU / 서버MEMORY / 서버OS설치 / 서버pc / 서버가격 / 서버가속기 / 서버견적 / 서버교체 / 서버구매 / 서버구입 / 서버구축 / 서버기술지원 / 서버납품 / 서버디스크장애처리 / 서버랙 / 서버렉 / 서버렉마운트 / 서버메모리 / 서버 몬 / 서버몬기술지원 / 서버백업 / 서버보안 / 서버부품 / 서버엔지니어 / 서버옵션 / 서버용GPU / 서버용PC / 서버용그래픽카드 / 서버용메모리 / 서버 / 컴퓨터 / 서버용하드디스크 / 서버재고 / 서버컴 / 서버컴퓨터 / 서버트러블슈팅 / 서버판매 / 서버하드 / 서버호스팅 / 스위치 / 스위치 기술지원비(비용) / 스위치 설치비 / 스토리지 / 스토리지 기술지원비(비용) / 스토리지 랙마운트비용 / 스토리지 설치비 / 스토리지 장애조치비용 / 스토리지납품설치 / 스토리지서버 / 시놀로지DS918 / 시놀로지HyperBackup / 시놀로지나스 / 시놀로지나스백업 / 시놀로지하이퍼백업 / 시큐어디스크 / 안랩 / 알약 / 앱서버 / 오피스 365 / 우분투설치 / 워크스테이션 / 워크스테이션pc / 워크스테이션컴퓨터 / 윈도우서버 / 윈도우서버2016 / 윈도우서버2019 / 윈도우서버2022 / 윈도우서버설치 / 윈도우서버컴퓨터 / 윈도우서버트러블슈팅 / 윈도우즈 기술지원비(비용) / 윈도우즈 설치비 / 이스트소프트 / 이스트 시큐리티 / 이중화솔루션 / 이중화솔루션구매 / 이중화솔루션설치 / 인터넷디스크 / 임베디드 / 저가서버 / 저렴한서버 / 정품서버 / 정품서버옵션 / 제온서버 / 젠서버 / 중고서버 / 중고워크스테이션 / 카보나이트 / 카스퍼스키 / 컴퓨터서버 / 케어팩 / 타워서버 / 타워형서버 / 팔로알토 / 페도라설치 / 프로라이언트