🐾 OpenClaw 설치부터 실행까지 — AI 에이전트를 내 PC에 띄우는 완전 가이드

🤖 OpenClaw란?

OpenClaw는 오픈소스 AI 에이전트 CLI 플랫폼입니다. Claude, GPT 등 대형 언어 모델(LLM)을 기반으로 나만의 AI 에이전트를 만들고, 텔레그램·디스코드·왓츠앱·시그널·Slack 등 다양한 메신저에 연결해서 24시간 AI 비서처럼 사용할 수 있습니다.

주요 특징:

  • 🤖 Claude, GPT 등 다양한 AI 모델 지원
  • 💬 텔레그램, 디스코드, 왓츠앱, 시그널, Slack 등 멀티채널 동시 연결
  • 🧠 워크스페이스 기반 메모리 시스템 — AI가 대화를 기억합니다
  • 🔧 스킬(Skills) 시스템으로 기능 무한 확장
  • ⏰ 크론(Cron) 스케줄링으로 반복 작업 자동화
  • 🖥️ Windows, Mac, Linux 모두 지원

📎 공식 문서 | GitHub | 스킬 마켓 | 커뮤니티(Discord)

🛠️ 1단계: 사전 준비

✅ Node.js 설치

OpenClaw는 Node.js 기반입니다. v18 이상이 필요합니다.

  1. nodejs.org에서 LTS 버전을 다운로드합니다
  2. 설치 마법사를 따라 설치합니다
  3. 터미널(PowerShell 또는 CMD)을 열고 확인합니다:
node --version
# v18.0.0 이상이면 OK

npm --version
# npm도 함께 설치됩니다

✅ API 키 준비

AI 모델을 사용하려면 API 키가 하나 이상 필요합니다:

AI 모델 발급처 추천도
Anthropic Claude console.anthropic.com ⭐⭐⭐ 강력 추천
OpenAI GPT platform.openai.com ⭐⭐
Google Gemini aistudio.google.com ⭐⭐

💡 팁: 둘 중 하나만 있으면 됩니다. 에이전트 기능이 가장 뛰어난 Claude를 추천합니다!

📦 2단계: OpenClaw 설치

터미널을 열고 다음 명령어를 입력합니다:

npm install -g openclaw

설치가 완료되면 버전을 확인합니다:

openclaw --version
# 예: 2026.3.2

✅ 버전 번호가 출력되면 설치 성공!

⚙️ 3단계: 초기 설정 (openclaw init)

OpenClaw를 처음 사용한다면 초기 설정을 실행합니다:

openclaw init

이 명령으로 홈 디렉토리에 ~/.openclaw/ 폴더가 생성되고, 기본 설정 파일이 만들어집니다.

API 키 등록

생성된 설정 파일에 API 키를 입력합니다:

# ~/.openclaw/.env 또는 config.yaml

# Anthropic Claude 사용 시
ANTHROPIC_API_KEY=sk-ant-api03-xxxxxxxx

# OpenAI GPT 사용 시 (선택)
OPENAI_API_KEY=sk-xxxxxxxx

⚠️ 주의: API 키는 절대 외부에 공유하지 마세요!

💬 4단계: 채널 연결 — 텔레그램 봇 만들기

OpenClaw의 진짜 힘은 메신저 연결입니다. 텔레그램을 예시로 설정해 보겠습니다.

📱 텔레그램 봇 생성

  1. 텔레그램 앱에서 @BotFather를 검색하고 대화를 시작합니다
  2. /newbot을 입력합니다
  3. 봇 이름을 입력합니다 (예: 내 AI 비서)
  4. 봇 username을 입력합니다 (예: my_ai_assistant_bot)
  5. BotFather가 보내주는 봇 토큰을 복사합니다

🔗 OpenClaw에 연결

설정 파일(~/.openclaw/config.yaml)에 텔레그램 섹션을 추가합니다:

channels:
  telegram:
    token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"

💡 디스코드, 왓츠앱 등도 비슷한 방식으로 설정할 수 있습니다. 공식 문서의 채널 설정 가이드를 참고하세요.

🚀 5단계: OpenClaw 실행!

모든 설정이 끝났으면, 드디어 AI 에이전트를 시작합니다:

▶️ Gateway 시작

openclaw gateway start

이 명령으로 OpenClaw 게이트웨이가 백그라운드 데몬으로 실행됩니다.

📊 상태 확인

openclaw gateway status

또는 전체 상태를 한눈에:

openclaw status

running 상태가 표시되면 정상 작동 중입니다! 🎉

📋 주요 명령어 모음

명령어 설명
openclaw gateway start 게이트웨이 시작
openclaw gateway stop 게이트웨이 중지
openclaw gateway restart 게이트웨이 재시작
openclaw status 전체 상태 확인
openclaw logs --follow 실시간 로그 확인

🏠 6단계: 워크스페이스 — AI의 뇌 구조 이해하기

OpenClaw의 핵심은 워크스페이스(~/.openclaw/workspace/)입니다. AI 에이전트는 이 폴더의 파일들을 읽고 쓰며 자신의 정체성과 기억을 유지합니다.

~/.openclaw/workspace/
├── SOUL.md       ← AI의 성격, 말투, 행동 방식
├── AGENTS.md     ← 에이전트 동작 규칙
├── USER.md       ← 사용자 정보 (이름, 시간대 등)
├── MEMORY.md     ← AI의 장기 기억 저장소
├── IDENTITY.md   ← AI의 이름과 정체성
├── TOOLS.md      ← 도구/환경별 메모
├── HEARTBEAT.md  ← 주기적 점검 작업 목록
└── memory/       ← 일별 기억 로그 폴더

핵심 파일 설명

  • SOUL.md: AI의 영혼입니다! 친근하게 말할지, 격식체로 말할지, 유머를 넣을지 등 성격을 정합니다
  • USER.md: 당신에 대한 정보입니다. AI가 "김철수님"처럼 이름을 불러주길 원하면 여기에 작성합니다
  • MEMORY.md: AI의 장기 메모리입니다. 세션이 바뀌어도 중요한 대화 맥락을 기억합니다
  • HEARTBEAT.md: AI가 주기적으로 수행할 작업을 적어두면 알아서 처리합니다

💡 첫 실행 시: AI와 대화하면서 자연스럽게 이름, 성격, 호칭 등을 함께 정할 수 있습니다. BOOTSTRAP.md가 이 과정을 안내합니다!

🔧 7단계: 스킬(Skills)로 기능 확장하기

OpenClaw는 스킬 시스템으로 기능을 모듈처럼 추가할 수 있습니다. ClawHub에서 다양한 커뮤니티 스킬을 설치할 수 있습니다.

# 스킬 검색
clawhub search weather

# 스킬 설치
clawhub install weather

# 설치된 스킬 목록
clawhub list

# 스킬 업데이트
clawhub update --all

🌟 인기 스킬 TOP 5

  • 🌤️ weather — 날씨 조회 및 예보
  • 🐙 github — GitHub 이슈/PR 관리, 코드 리뷰
  • 💻 coding-agent — 코딩 작업 자동화 (Codex, Claude Code 연동)
  • 🔒 healthcheck — 시스템 보안 점검
  • 🔌 mcporter — MCP 서버 연동

⏰ 보너스: 자동 시작 설정

PC를 켤 때마다 OpenClaw가 자동으로 실행되도록 설정하면, 별도 조작 없이 항상 AI 비서를 사용할 수 있습니다.

Windows 작업 스케줄러

  1. 작업 스케줄러를 열고 "기본 작업 만들기"를 클릭합니다
  2. 이름: OpenClaw Gateway
  3. 트리거: "컴퓨터 시작 시"
  4. 동작: 프로그램 시작 → openclaw, 인수: gateway start
  5. 저장!

Mac/Linux (systemd)

# systemd 서비스 파일 생성
sudo nano /etc/systemd/system/openclaw.service

# 서비스 활성화
sudo systemctl enable openclaw
sudo systemctl start openclaw

🎯 실전 활용 예시

OpenClaw를 설치하면 이런 것들이 가능합니다:

  • ✅ 텔레그램 AI 비서 — 24시간 질문, 번역, 요약, 일정 관리
  • ✅ 크론 자동화 — 매일 아침 뉴스 요약, 날씨 알림
  • ✅ 블로그 자동 포스팅 — AI가 글을 쓰고 발행까지
  • ✅ GitHub 자동화 — 이슈 처리, PR 리뷰, 코드 생성
  • ✅ 코딩 에이전트 — 자연어로 코드 작성 (바이브코딩)
  • ✅ 스마트홈 연동 — 카메라, IoT 기기 제어

❓ 자주 묻는 질문

Q: OpenClaw는 무료인가요?

A: OpenClaw 자체는 완전 무료 오픈소스입니다. 단, AI 모델 API 사용료(Claude, GPT 등)는 각 제공사에 별도로 지불합니다.

Q: Mac이나 Linux에서도 사용할 수 있나요?

A: 네! Node.js가 지원되는 모든 운영체제에서 동일하게 사용 가능합니다.

Q: 여러 채널을 동시에 연결할 수 있나요?

A: 네, 텔레그램 + 디스코드 + 왓츠앱 등을 동시에 연결하고 하나의 AI 에이전트로 관리할 수 있습니다.

Q: AI 모델은 어떤 걸 쓰는 게 좋나요?

A: 에이전트 작업에는 Claude Sonnet이 가성비가 좋고, 복잡한 추론이 필요하면 Claude Opus를 추천합니다.

Q: 보안은 안전한가요?

A: API 키와 데이터는 모두 로컬에 저장됩니다. 외부 서버로 전송되지 않으며, 도구 권한도 세밀하게 제어할 수 있습니다.

이 글은 실제로 OpenClaw AI 에이전트가 텔레그램을 통해 자동으로 작성하고 발행한 포스트입니다. 🐾

📎 OpenClaw 공식 문서 | GitHub | 스킬 마켓

'바이브코딩' 카테고리의 다른 글

바이브코딩 다음 단계는? 2026년 에이전틱 엔지니어링 시대가 온다  (0) 2026.03.05
2026년 바이브코딩 트렌드 총정리 – AI 코딩의 진화와 보안, 그리고 생존 전략  (0) 2026.03.04
클로드 코드 + 안티그래비티로 바이브코딩 완전 정복: 코드 한 줄 없이 앱 만드는 2026 최신 공식  (0) 2026.03.03
2026 바이브코딩 트렌드 총정리 — 코드 한 줄 없이 앱 만드는 시대, 지금 어디까지 왔나?  (0) 2026.03.03
2026년 바이브코딩 최신 트렌드: AI 에이전트가 스스로 코딩하는 시대가 왔다  (1) 2026.03.02

+ Recent posts

티스토리툴바