콘텐츠로 건너뛰기

요즘 핫한 ‘OpenClaw’, 설치 방법 및 간단한 활용 사례

  • 테크

목차

  1. OpenClaw 소개
    • openclaw란?
    • ChatGPT vs OpenClaw, 무엇이 다른가요?
  2. 시스템 구조와 저장 방식
    • 핵심 아키텍처 (Gateway, Agent, Skills, Memory)
    • 내부 구조 들여다보기 (~/.openclaw/)
  3. OpenClaw 설치 및 텔레그램 연동
    • WSL2 기반 설치 가이드 (Node.js 환경 구성)
    • 텔레그램 봇(BotFather) 생성 및 페어링 승인
  4. 활용 예시: 날씨부터 IT 뉴스 브리핑까지
    • 매일 아침 7시 날씨 및 IT 뉴스 요약
  5. 직접 사용하며 느낀 장단점
openclaw 로고 logo
[출처:https://openclaw.ai/]
[출처 : https://openclaw.ai/]

1. OpenClaw 소개

  • openclaw란? OpenClaw는 사용자가 즐겨 사용하는 채팅 앱(WhatsApp, Telegram, Discord, iMessage 등)을AI 에이전트에 연결하는 자체 호스팅 게이트웨이 입니다 .
    [출처 : https://docs.openclaw.ai/#what-is-openclaw]
  • 내 PC(또는 서버)의 자료를 어디서든 채팅 앱으로 조종이 가능하며 llm, skill 등을 활용하여 다양한 업무 및 편의기능들을 자동화, 또는 알아서 할 수 있게 해줍니다.
    • 두뇌 역할: Gemini, GPT 같은 LLM을 API로 연결해 사용합니다.
    • 통로 역할: 채팅 앱과 내 PC를 잇는 통로입니다.
  • ChatGPT vs OpenClaw, 뭐가 다른가요?
    • 1. 데이터의 주인 (사용자 직접 호스팅)
      • ChatGPT: OpenAI의 서버에서 돌아가며, 데이터도 그들의 서버에 저장됩니다.
      • OpenClaw: 내 PC(또는 서버)에서 직접 돌아가며, 모든 데이터도 오직 내 PC에만 저장됩니다.
    • 2. 업로드가 필요 없는 ‘로컬 파일’ 접근
      • ChatGPT: 직접 파일 첨부를 한 내용들만 읽을 수 있습니다.
      • OpenClaw: 내 PC의 자료를 직접 읽고 수정하는 것이 가능합니다.
        • 예: “내 PC 바탕화면에 있는 작년 매출 보고서 요약해줘”
    • 3. 잠들지 않는 비서 (24/7 자동화)
      • ChatGPT: 질문을 던져야만 답을 하는 ‘수동적 구조’입니다.
      • OpenClaw: Heartbeat 기능이 있어, 사용자가 자고 있는 시간에도 스스로 깨어나 할 일을 하거나 알림을 보냅니다.
    • 4. 잊지 않는 대화 기록 (장기 메모리)
      • ChatGPT: 대화가 길어지거나 새로운 창을 열면 과거 내용을 잊어버리곤 합니다.
      • OpenClaw: 모든 대화 기록을 로컬 DB에 저장하여, 과거의 맥락을 완벽하게 기억하며 대화할 수 있습니다.

2. 시스템 구조와 저장 방식

핵심 아키텍처

  • Gateway: 메시징 플랫폼과의 연결 통로
  • Agent: LLM을 통한 의도 분석 및 계획 수립
  • Skills: 파일 제어, 브라우징 등 실제 업무 수행 도구
  • Memory: 대화 맥락과 사용자 선호도 저장

내부 구조 (~/.openclaw/)

AI의 인격과 기억은 모두 마크다운(.md) 파일로 관리되어 사용자가 직접 수정할 수 있습니다.

  • ~/.openclaw/workspace/SOUL.md: 에이전트의 성격과 행동 지침
  • ~/.openclaw/workspace/HEARTBEAT.md: 주기적 작업(알림 등) 정의
  • ~/.openclaw/memory/main.sqlite: 빠른 검색을 위한 로컬 데이터베이스

3. OpenClaw 설치 및 텔레그램 연동 (WSL2 기반)

  1. wsl 설치

권장 환경: Node.js 24 (22.14 이상 지원)

Bash

# 1. CMD 관리자 권한 실행 후 wsl 설치
wsl --install

# 2. 시스템 업데이트 및 필수 도구 설치
sudo apt update && sudo apt install -y curl

# 3. Node.js 24 설치
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

# 4. OpenClaw 자동 설치
curl -fsSL https://openclaw.ai/install.sh | bash
  • openclaw설치 이후 설정
  • 모델 및 인증 : google/gemini-3-flash-preview 모델을 권장하며, Google AI Studio에서 API Key를 발급받아 등록.
openclaw 오픈클로 위험성 동의
[출처 : bizspring]
openclaw 오픈클로 모드 설정
[출처 : bizspring]
openclaw 오픈클로 llm 모델 선택
[출처 : bizspring]
openclaw 오픈클로 llm 모델 상세 설정
[출처 : bizspring]

텔레그램 연결 프로세스

  1. 토큰 발급 및 bot접속: @BotFather를 통해 봇 생성 후 HTTP API 토큰 복사.
  2. 채널 등록: OpenClaw 설정에서 텔레그램 선택 후 토큰 입력.
  3. 페어링 승인: 텔레그램에서 bot url로 접속 후 /start 입력 후 받은 코드를 WSL에서 승인.
openclaw 오픈클로 대화 채널 channel 선택
[출처 : bizspring]
openclaw 오픈클로 텔레그램 telegram 토큰 발급 및 봇 url 확인하는 대화창
[출처 : bizspring]
  • 1. 토큰 발급: @BotFather를 통해 봇 생성 후 HTTP API 토큰 복사, 생성된 bot url 접속.
openclaw 오픈클로 telegram 텔레그램 bot 봇 토큰 입력
[출처 : bizspring]
  • 2. 채널 등록: OpenClaw 설정에서 텔레그램 선택 후 토큰 입력.
openclaw 오픈클로 gateway 게이트웨이 재시작 설정
[출처 : bizspring]
openclaw 오픈클로 실행 설정
[출처 : bizspring]
openclaw 오픈클로 텔레그램 telegram 페어링 코드 확인, 연동시 필요한 정보
[출처 : bizspring]
openclaw 오픈클로 텔레그램 telegram 연동 코드 입력 명령어
[출처 : bizspring]
  • 3. 페어링 승인: 텔레그램에서 bot url로 접속 후 /start 입력 후 받은 코드를 WSL에서 승인.
    • openclaw pairing approve telegram [Pairing code 입력]
텔레그램, telegram 에서 openclaw 오픈클로 봇 호출 및 확인
[출처 : bizspring]

4. 활용 예시: 날씨부터 IT 뉴스 브리핑까지

  • 모닝 브리핑: “매일 오전 7시에 서울 날씨와 최신 IT 인기 뉴스 요약해줘.”
텔레그램 telegram에서 openclaw 오픈클로를 활용해서 오늘 날씨 및  최신IT뉴스 요약 전송하는 대화
[출처 : bizspring]

“\wsl.localhost\Ubuntu\root.openclaw\cron” 해당 경로의 jobs.json에 openclaw에 요청한 작업이 저장됩니다.

자동화 명령에 따른 cron 크론 저장 설명
[출처 : bizspring]

Telegram으로 정해진 시간에 해당 내용이 전송됩니다.

실제 매일 정해진 시간에 텔레그렘 telegram을 통한 날씨 및 최신 it 뉴스 요약 자료
[출처 : bizspring]

5. 직접 사용하며 느낀 장단점

1. 뛰어난 접근성: 외부에서도 손쉬운 연결

  • 외부에서 메신저 채널을 연동하고 게이트웨이를 활용하는 과정이 생각보다 훨씬 간편했습니다. 복잡한 네트워크 설정 없이도 텔레그램 하나로 내 PC에 접근할 수 있다는 점은 확실히 큰 장점입니다.

2. 보안을 위한 ‘환경 분리’ 필수

  • 내 PC의 권한을 AI에게 직접 부여하는 만큼 보안에 대한 고민은 필수입니다. OpenClaw 공식 문서에서도 권장하듯, 메인 OS보다는 가상 머신(VM)이나 도커(Docker) 등을 활용해 독립된 환경에서 구동하는 것이 안전합니다.

3. 토큰 관리 주의: 무한 루프 생각

  • 에이전트가 답변을 재검토하거나 스스로 생각하는 과정을 반복 할 경우, 순식간에 API 토큰 소모량이 급증할 수 있습니다. 작업 단위를 명확히 지시하거나 반복의 횟수를 제한하거나 모니터링하는 습관이 필요합니다.

최신 마케팅/고객 데이터 활용 사례를 받아보실 수 있습니다.

비즈스프링 뉴스레터 구독하기 →

문의 02-6919-5516 |  sales@bizspring.co.kr

클라우드 바우처 수요기업 모집 중! AI·광고성과·온라인 행동 데이터 분석 최대 80% 지원!

X