리눅스에서 나만의 AI 에이전트 OpenClaw 설치하기

AI 에이전트 시대, 나만의 비서 '파이(Pi)'를 갖는 것은 더 이상 꿈이 아닙니다. 클라우드 서비스에 의존하지 않고, 내 데이터를 안전하게 지키면서 24시간 깨어있는 나만의 에이전트를 리눅스 서버에 직접 설치해보세요.

이 글에서는 리눅스(Ubuntu/Debian) 환경에서 OpenClaw를 설치하고, 보안을 위한 유저 설정과 정확한 스케줄링을 위한 타임존 설정까지 꼼꼼하게 다룹니다.

1. 사전 준비 (Prerequisites)

설치를 시작하기 전에 다음 환경이 준비되어야 합니다.

OS: Linux (Ubuntu 22.04 LTS 이상 권장)
Runtime: Node.js 22 버전 이상 (설치 방법에 따라 필수 아님)
Access: 터미널(SSH) 접속 권한

2. 기본 환경 설정

설치 전, 보안과 편의를 위해 전용 유저와 타임존을 설정하는 것을 강력히 권장합니다.

2.1 타임존 설정 (Timezone)

에이전트가 "아침 7시에 날씨 알려줘"라는 명령을 제대로 수행하려면 서버 시간이 내가 있는 곳과 맞아야겠죠? 한국 시간(KST)으로 설정합니다.

# 현재 시간 확인
date

# 타임존 변경 (Asia/Seoul)
sudo timedatectl set-timezone Asia/Seoul

# 변경 확인
date

2.2 전용 유저 생성

루트(root) 계정으로 실행하는 것은 보안상 좋지 않고 일부 툴 설치에 제한도 있습니다. openclaw라는 전용 유저를 만들어 관리합니다.

# 유저 생성 (-m: 홈디렉토리 생성, -s: 쉘 지정)
sudo useradd -m -s /bin/bash openclaw

# 비밀번호 설정 (선택사항)
sudo passwd openclaw

# sudo 권한 부여 (설치 시 필요할 수 있음)
sudo usermod -aG sudo openclaw

# 유저 전환
sudo su - openclaw

3. OpenClaw 설치 (Installation)

OpenClaw 팀에서 제공하는 공식 설치 스크립트를 사용하면 가장 간편합니다. 이 스크립트는 필요한 패키지를 전역(Global)으로 설치하고 초기 설정을 도와줍니다.

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

설치가 완료되면 openclaw 명령어를 사용할 수 있습니다.

4. 에이전트 초기화 (Onboarding)

설치 후 첫 실행 시, 에이전트의 성격과 연결할 채널을 설정하는 '온보딩' 과정을 진행합니다.

openclaw onboard

이 과정에서 다음을 설정하게 됩니다:

모델 선택: Google Gemini, Anthropic Claude 등 사용할 AI 모델을 연결합니다.
채널 연결: 텔레그램, 디스코드 등 에이전트와 대화할 메신저를 연동합니다.
권한 설정: 파일 읽기/쓰기 등 에이전트가 수행할 수 있는 권한을 지정합니다.

5. 실행 및 상태 확인

설정이 끝났다면 에이전트를 데몬(백그라운드 서비스)으로 실행합니다.

# 게이트웨이(데몬) 시작
openclaw gateway start

# 상태 확인
openclaw status

# 프롬프트 입력
openclaw tui

이제 설정한 메신저(텔레그램 등)로 말을 걸어보세요. "안녕?"이라고 인사하면 나만의 에이전트가 응답할 것입니다.

6. 대화형 인터페이스: 말 한마디로 설정 끝!

OpenClaw의 진정한 매력은 CLI 앞에 앉아 있지 않아도 텔레그램이나 디스코드 같은 메신저를 통해 에이전트의 모든 설정을 제어할 수 있다는 점입니다.

[예시 대화]

마스터: "파이, 내일 아침 8시에 삼프로TV 시황 요약해서 옵시디언에 기록해줘."
파이: "네, 마스터! 내일 오전 8시에 맞춰 삼프로TV 최신 영상을 분석하고 데일리 노트에 정리해 드릴게요. ⭐"
마스터: "지금 포트폴리오 수익률 보여줘."
파이: "현재 마스터님의 총 평가금액은 599,665,975원이며, 수익률은 +8.36%입니다. 상세 내역 이미지를 보내드릴까요?"

7. 브라우저 제어를 위한 GUI 환경 구축 (Advanced)

에이전트가 직접 웹사이트에 접속해 클릭하고 폼을 입력하는 기능을 사용하려면, 리눅스 서버에 브라우저를 구동할 수 있는 GUI 환경이 필요합니다. 헤드리스(Headless) 모드로 작동하는 Playwright 환경을 구축해보세요.

# 필수 시스템 패키지 설치
sudo apt-get update
sudo apt-get install -y ubuntu-desktop chromium

# OpenClaw 브라우저 환경 초기화
openclaw browser install-deps

이 설정이 완료되면 에이전트에게 "배달의민족 로그인해서 내일 아침 메뉴 장바구니에 담아줘" 같은 복잡한 웹 자동화 명령을 내릴 수 있습니다.

물론 이것도 사실 텔레그램으로 가능합니다.
텔레그램에서 파이 gui 환경과 크롬 브라우저 설치해줘.

마무리

이제 여러분의 서버에는 24시간 잠들지 않는 AI 에이전트가 살고 있습니다. 날씨 알림, 뉴스 브리핑, 서버 모니터링 등 상상하는 모든 것을 자동화해보세요.

참고 문서

OpenClaw 리눅스에 설치