테마 전환

OpenClaw 실전 활용 가이드: 입문부터 고급 활용까지

Easton editorial illustration: supervisor dispatch desk

고객에게 메시지가 왔습니다. 내일 오전 9시 전까지 경쟁사 분석 보고서가 필요하다고 합니다. 브라우저에는 탭이 열몇 개 열려 있고, 읽지 않은 메일은 200통이 넘습니다. OpenClaw를 열어 한마디 입력했습니다. “최근 일주일 동안 경쟁사 A와 관련된 뉴스를 정리하고 분석 보고서를 만들어 줘.” 5분 뒤 보고서가 Telegram으로 도착했습니다.

OpenClaw를 사용한 지 석 달째입니다. 처음에는 ChatGPT와 정확히 무엇이 다른지 이해하지 못했습니다. 둘 다 AI와 대화하는 것 아닌가 싶었습니다. 하지만 사용하다 보니 둘은 완전히 달랐습니다. OpenClaw는 오픈 소스 AI 에이전트 프레임워크입니다. 쉽게 말해 목표 하나를 주면 스스로 단계를 계획하고 도구를 호출해 작업을 수행한 뒤 결과를 알려 줍니다. ChatGPT처럼 매 단계마다 사람이 이끌어야 하는 방식이 아닙니다.

매일 여러 도구를 오가며 기계적인 일을 반복하고 있다면 이 글이 도움이 될 것입니다. OpenClaw의 핵심 지식을 설치와 배포부터 고급 활용법까지 정리하고, 전체 학습 경로를 제시합니다.

이 글은 OpenClaw 시리즈의 35번째 글이며 전체 내용을 정리하는 글입니다. 앞선 34편의 핵심을 한데 모아 지식 체계를 빠르게 잡을 수 있도록 구성했습니다.

1장: OpenClaw란 무엇인가

1.1 ChatGPT가 아니라 AI 에이전트

OpenClaw를 처음 접한 사람들은 대부분 같은 질문을 합니다. 이것은 ChatGPT와 무엇이 다를까요?

저도 처음에는 헷갈렸습니다. 나중에 한 가지 예로 차이를 이해했습니다.

ChatGPT에 “최근 이메일을 정리해 줘”라고 요청하면 방법을 알려 주거나 정리된 텍스트를 만들어 줍니다. 하지만 메일함에서 내용을 복사하고 붙여 넣는 일은 직접 해야 합니다.

OpenClaw에 같은 일을 맡기면 메일함을 직접 열고, 이메일을 읽고, 분류하고, 보고서를 만든 다음 휴대전화로 결과를 보냅니다.

이것이 ‘수동적인 대화’와 ‘자율 에이전트’의 차이입니다.

OpenClaw의 핵심 역량은 자율 실행입니다. 파일을 읽고, 웹을 검색하고, 코드를 실행하는 도구가 있습니다. 선호와 이전 대화 내용을 기억하는 메모리가 있습니다. 목표를 달성하려면 몇 단계가 필요한지 판단하는 계획 능력도 있습니다.

1.2 핵심 장점: 왜 OpenClaw를 선택하는가

OpenClaw를 석 달 동안 사용하며 특히 크게 느낀 장점은 다음과 같습니다.

로컬에 배포해 데이터를 직접 관리합니다. 대화 기록이 모델 학습에 쓰일까 걱정할 필요가 없습니다. 민감한 업무 내용을 다룰 때 특히 중요합니다.

비용을 통제할 수 있습니다. 작업에 따라 여러 모델을 설정할 수 있습니다. 간단한 작업에는 저렴한 소형 모델을 쓰고, 복잡한 작업에만 Claude나 GPT-4를 사용합니다. 한 달 기준 API 비용은 ChatGPT를 바로 사용할 때보다 훨씬 적었습니다.

사용자화할 수 있습니다. 공식 스킬 패키지 53개가 있고 커뮤니티 스킬은 더 많습니다. 직접 스킬을 만들어 자신의 업무 흐름대로 실행하게 할 수도 있습니다.

여러 채널로 접속할 수 있습니다. Telegram, WhatsApp, Web UI, Gmail 등 어디서든 대화할 수 있습니다. 저는 주로 Telegram을 사용해 이동 중에도 메시지를 보내 일을 맡깁니다.

1.3 아키텍처는 어떻게 구성되는가

OpenClaw의 아키텍처는 생각보다 어렵지 않습니다. 간단한 그림으로 나타내면 다음과 같습니다.

사용자 → Channel(Telegram/WhatsApp) → Gateway → Agent → Tools/Skills

                                                  Memory

Gateway: 입구입니다. 여러 플랫폼에서 보낸 메시지를 받습니다.

Agent: 두뇌입니다. 사용자의 의도를 이해하고 실행 단계를 계획하며 도구를 호출합니다.

Channels: 통로입니다. OpenClaw가 여러 플랫폼에서 사용자와 대화할 수 있게 합니다.

Tools: 손과 발입니다. 파일 읽기, 웹 검색, 코드 실행, Git 작업 등을 수행하는 핵심 도구 26개가 있습니다.

Skills: 스킬 패키지입니다. 공식 스킬 53개가 있고 커뮤니티에서도 계속 추가하고 있습니다. 예를 들면 ‘일일 뉴스 전송’, ‘코드 리뷰 도우미’, ‘회의록 생성’ 등이 있습니다.

Memory: 메모리입니다. 사용자의 선호와 이전 대화 내용을 MEMORY.md 파일에 기록합니다.

아키텍처를 더 깊이 알고 싶다면 시리즈의 《OpenClaw 아키텍처 가이드: 입문부터 고급까지》를 참고하세요.

1.4 무엇을 할 수 있는가

제가 자주 사용하는 몇 가지 사례를 소개합니다.

개인 비서. 매일 아침 업계 뉴스를 자동으로 수집하고 요약해 Telegram으로 보냅니다. 일정 관리, 이메일 처리, 할 일 알림도 맡길 수 있습니다.

개발 도우미. 코드 리뷰, 오류 디버깅, 문서 생성에 활용합니다. 코딩 중 막힐 때 자료와 문서를 대신 찾게 하면 혼자 헤매는 것보다 훨씬 빠릅니다.

워크플로 자동화. 예약 데이터 백업, 웹사이트 변경 감시, 마케팅 이메일 자동 발송을 수행합니다. 예전에는 스크립트를 작성해야 했던 작업도 이제 자연어로 설명하면 됩니다.

스마트 홈 제어. Home Assistant를 사용한다면 OpenClaw로 집 안의 기기를 제어할 수 있습니다. 예를 들어 “집에 왔어”라는 말로 조명과 에어컨을 자동으로 켤 수 있습니다.

2장: 빠른 시작 — 10분 만에 사용하기

2.1 설치 방식 선택

OpenClaw는 세 가지 설치 방식을 지원합니다. 권장 순서대로 정리하면 다음과 같습니다.

공식 설치 스크립트(초보자에게 권장)

공식 설치 문서에서 권장하는 원클릭 명령은 다음과 같습니다.

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

스크립트가 시스템을 감지하고 필요에 따라 Node 버전을 처리한 뒤 CLI를 설치합니다. 완료되면 아래 초기 설정 마법사를 계속 실행하세요.

npm 전역 설치

Node를 직접 관리하고 있다면 사용할 수 있습니다. 공식 권장 버전은 Node 24이며 최소 버전은 Node 22.14+입니다.

npm install -g openclaw@latest
openclaw onboard --install-daemon

openclaw --version, openclaw doctor, openclaw gateway status로 상태를 확인할 수 있습니다.

소스에서 설치(기여자용)

공식 저장소에서 권장하는 흐름은 pnpm으로 빌드하는 방식입니다.

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon

전역 link를 원하지 않는다면 저장소 안에서 pnpm openclaw ...을 사용할 수도 있습니다. 자세한 내용은 공식 Setup 문서를 참고하세요.

소스를 수정할 목적이 아니라 사용만 하려면 원클릭 스크립트나 npm 전역 설치를 먼저 선택하세요.

더 자세한 단계는 시리즈의 《OpenClaw 설치 가이드》와 《OpenClaw 2026 최종 설치 가이드》에서 확인할 수 있습니다.

2.2 기본 설정

설치 후에는 모델 제공업체와 채널을 초기화해야 합니다.

API 키

OpenClaw는 Anthropic, OpenAI, Google 등의 대규모 언어 모델 API를 호출합니다. openclaw onboard 대화형 마법사로 입력하는 방식을 권장합니다. openclaw secret set 같은 명령으로 키를 관리해 장기간 유효한 평문 키가 동기화되는 디렉터리에 흩어지지 않게 할 수도 있습니다. 환경 변수와 비밀 키 해석 순서는 공식 문서를 기준으로 확인하세요.

Channel 설정

저는 여전히 Telegram으로 시작하는 것을 권합니다. BotFather에서 Bot을 만들고 token을 받은 뒤 마법사로 연결하는 방법이 가장 간단합니다. 직접 편집해야 한다면 기본 설정 파일은 ~/.openclaw/openclaw.json입니다. channels.telegram 등의 필드 이름과 예시는 공식 Telegram 채널 문서에서 바로 확인하세요. 예전 튜토리얼에 등장하는 config.yaml은 일반화된 설명일 뿐이므로 openclaw.json과 공식 필드를 기준으로 해야 합니다.

WhatsApp 등 다른 채널도 마찬가지입니다. 각 공식 채널 페이지를 기준으로 설정하세요. Gateway가 정상 실행 중이면 openclaw dashboard로 Web 콘솔을 열 수 있습니다.

기본 보안 설정

최소한 두 가지는 해야 합니다.

  1. MEMORY.md.env에 적절한 권한을 설정합니다.
  2. 서버에 배포한다면 방화벽 규칙을 설정합니다.

보안은 5장에서 자세히 설명하므로 여기서는 개념만 알아 두면 됩니다.

2.3 첫 대화

설정을 마쳤다면 Gateway를 시작하고 상태를 확인합니다.

openclaw gateway status
# 로그를 보기 쉬운 포그라운드 디버깅 모드(터미널을 열어 둡니다):
openclaw gateway

Telegram의 공식 기본 페어링(pairing) 정책을 사용한다면 첫 개인 대화 때 Gateway에서 openclaw pairing approve telegram <CODE>를 실행해야 합니다. 페어링 코드는 약 1시간 동안 유효합니다. 설정에서 dmPolicy: "allowlist"를 명시하고 자신의 사용자 ID를 넣었다면 해당 정책에 따라 페어링 단계를 생략할 수 있습니다. 자세한 내용은 공식 Telegram 문서를 참고하세요.

이제 Telegram에서 Bot을 찾아 메시지를 보내 봅니다.

첫 번째 권장 스킬: 메모리

OpenClaw가 선호를 기억하도록 메시지를 보냅니다.

기억해 줘. 나는 매일 아침 8시에 일어나고 기술 뉴스를 좋아하며 업무 언어는 한국어야.

MEMORY.md 파일을 열어 보면 이 정보가 기록되어 있습니다. 다음 대화부터는 이 선호를 바탕으로 답합니다.

직접 일을 시켜 보기

최근 OpenClaw 관련 뉴스를 검색해 5가지 요점으로 정리해 줘.

OpenClaw가 웹을 검색하고, 내용을 읽고, 정보를 정리한 뒤 결과를 보내는 과정을 볼 수 있습니다. 전체 과정에 사람이 개입할 필요가 없습니다.

한 번 경험하면 이 ‘스스로 일하는’ 감각을 포기하기 어렵습니다.

3장: 핵심 기능 실전 — 도구와 스킬 시스템

3.1 핵심 도구 26개

OpenClaw에는 파일 작업, 네트워크 요청, 코드 실행 등을 다루는 핵심 도구 26개가 내장되어 있습니다. 자주 쓰는 도구를 범주별로 살펴보겠습니다.

파일 작업 도구

도구기능
read_file로컬 파일 읽기
write_file파일 쓰기
execute_commandshell 명령 실행
list_directory디렉터리 내용 나열

네트워크 도구

도구기능
web_search웹 검색
fetch_url웹 콘텐츠 가져오기
scrape웹페이지 구조 분석

코드 도구

도구기능
execute_code코드 조각 실행
git_operationsGit 작업

예를 들어 OpenClaw에 “이 프로젝트의 코드 구조를 분석해 줘”라고 요청하면 다음 과정을 수행합니다.

  1. list_directory로 디렉터리를 탐색합니다.
  2. read_file로 핵심 파일을 읽습니다.
  3. execute_code로 분석 스크립트를 실행합니다.
  4. 결과를 정리해 보냅니다.

사용자가 한 말은 한 문장뿐입니다.

3.2 스킬 시스템 입문

도구가 기본 능력이라면 스킬은 미리 구성된 ‘워크플로’입니다.

공식 스킬은 53개이며 커뮤니티에서도 계속 기여하고 있습니다. 자주 쓰는 몇 가지를 소개합니다.

필수 스킬 추천

memory — 메모리 관리. 선호와 이전 대화를 기록하며 OpenClaw가 ‘나를 기억하는’ 기반입니다.

web_search — 웹 검색. 검색, 가져오기, 분석 과정을 묶어 두어 도구를 직접 호출하는 것보다 편리합니다.

code_execution — 코드 실행. Python과 JavaScript 코드를 실행할 수 있어 데이터 처리와 프로토타입 검증에 적합합니다.

스킬 마켓

공식 스킬 외에도 다음 두 곳에서 스킬을 찾을 수 있습니다.

  • ClawHub: 커뮤니티가 기여한 스킬을 한 번에 설치할 수 있는 공식 스킬 마켓입니다.
  • awesome-openclaw-skills: GitHub의 스킬 모음입니다. 품질 편차가 있지만 유용한 스킬도 많습니다.

스킬 설치는 간단합니다.

openclaw skill install &lt;skill_name&gt;

또는 설정 파일에 추가할 수 있습니다.

skills:
  - name: daily_news
    source: github
    repo: user/daily-news-skill

3.3 사용자 정의 스킬 개발

공식 스킬과 커뮤니티 스킬로도 요구 사항을 충족하지 못한다면 직접 만들 수 있습니다.

스킬은 본질적으로 설정 파일 하나와 일련의 도구 호출로 구성됩니다. 가장 간단한 스킬은 다음과 같습니다.

name: my_skill
description: 중요한 일을 기억하도록 지원
tools:
  - memory.write
  - memory.read
prompt: |
  사용자가 'XXX를 기억해 줘'라고 말하면 memory.write를 호출해 저장합니다.
  사용자가 '전에 무엇을 기억해 달라고 했지?'라고 물으면 memory.read를 호출해 조회합니다.

작성한 파일을 skills/ 디렉터리에 넣고 OpenClaw를 다시 시작하면 사용할 수 있습니다.

사용자 정의 스킬을 개발할 때는 몇 가지를 주의해야 합니다.

  1. 트리거 조건을 명확히 합니다: 어떤 상황에서 이 스킬을 사용해야 하는지 정합니다.
  2. 도구 권한을 통제합니다: 보안 위험을 줄이기 위해 꼭 필요한 도구만 스킬에 허용합니다.
  3. 오류를 처리합니다: 도구 호출이 실패하는 상황을 고려합니다.

스킬 개발을 더 깊이 배우고 싶다면 시리즈의 《OpenClaw Skills 개발 가이드》를 참고하세요.

4장: 고급 실전 — 워크플로 자동화

4.1 다중 모델 라우팅과 비용 관리

어느 정도 사용한 뒤 한 가지 문제가 생겼습니다. API 비용이 빠르게 늘었습니다.

특히 할 일 정리나 일반 메시지 답변 같은 간단한 작업에 Claude나 GPT-4를 쓰는 것은 지나친 선택이었습니다.

해결책은 다중 모델 라우팅입니다.

왜 라우팅이 필요한가

간단한 작업에는 저렴한 모델을, 복잡한 작업에는 비싼 모델을 사용합니다. 예를 들면 다음과 같습니다.

  • 할 일 정리, 간단한 질의응답 → GPT-3.5 또는 Claude Haiku 사용
  • 코드 리뷰, 복잡한 추론 → GPT-4 또는 Claude Sonnet 사용
  • 특히 복잡한 작업 → Claude Opus 사용

설정 방향

다중 모델 전환, 라우팅, 장애 조치에 쓰이는 실제 키 이름~/.openclaw/openclaw.json과 공식 ‘Models / Model Failover’ 페이지에 기록되어 있으며 버전에 따라 바뀔 수 있습니다. 인터넷에 떠도는 config.yaml 조각을 그대로 복사하는 것은 권장하지 않습니다. 실제 적용 가능한 사례와 라우팅 전략은 시리즈 글 《OpenClaw 비용 관리: 모델 라우팅 전략》을 참고하고, 공식 모델 문서에서 필드를 확인하세요.

라우팅과 장애 조치 전략을 적용한 뒤 API 비용이 약 40% 줄었습니다. 작업 유형에 따라 결과는 달라질 수 있으므로 참고만 하세요.

4.2 예약 작업과 자동화

제가 가장 좋아하는 기능 중 하나입니다.

OpenClaw는 예약 작업(Cron)을 지원합니다. CLI에는 openclaw cron add 같은 명령이 있으며 작업은 ~/.openclaw/cron/jobs.json에 영구 저장됩니다. 실제 로컬 경로를 기준으로 확인하세요. 자세한 내용은 시리즈의 《OpenClaw Cronjob 자동화 가이드》와 공식 예약 작업 문서를 참고하세요.

제가 자주 사용하는 예약 작업

  1. 일일 뉴스 브리핑: 오전 8시에 기술 뉴스를 Telegram으로 보냅니다.
  2. 주간 보고서 생성: 매주 금요일 오후에 한 주의 업무 진행 상황을 정리합니다.
  3. 데이터 백업: 매주 일요일 새벽에 데이터를 자동 백업합니다.

예전에는 이런 작업을 위해 스크립트를 작성하고 crontab을 설정해야 했지만, 이제 자연어로 설명하면 됩니다. 신경 쓸 일이 줄었습니다.

자세한 설정은 《OpenClaw Cronjob 자동화 가이드》에서 확인할 수 있습니다.

4.3 다중 채널 연동

OpenClaw는 여러 채널을 동시에 연결할 수 있습니다. Telegram에서 메시지를 보내고 결과는 이메일로 받게 할 수도 있습니다.

주요 지원 채널

  • Telegram(가장 자주 사용)
  • WhatsApp
  • Gmail
  • Web UI
  • Discord

실전 사례: 통합 메시지 센터

저는 ‘메시지 통합’ 워크플로를 다음과 같이 구성했습니다.

  1. OpenClaw가 여러 메일함을 감시합니다.
  2. 중요한 이메일이 오면 내용을 요약해 Telegram으로 보냅니다.
  3. 제가 Telegram에서 답하면 OpenClaw가 자동으로 회신 이메일을 보냅니다.

이렇게 하면 여러 App을 오갈 필요 없이 하나의 진입점에서 모든 소통을 처리할 수 있습니다.

각종 메시지에 자주 파묻힌다면 사용해 볼 만한 기능입니다.

4.4 브라우저 자동화(2026.3 새 기능)

2026.3 버전에는 Live Chrome Session Attachment라는 흥미로운 기능이 추가되었습니다.

쉽게 말해 OpenClaw가 브라우저 세션을 ‘제어’할 수 있습니다.

무엇을 할 수 있는가

  • 양식 자동 입력
  • 로그인이 필요한 페이지의 데이터 수집
  • 웹 기능 자동 테스트
  • 웹사이트 업데이트 예약 확인

설정 예시

browser:
  enabled: true
  headless: false  # true로 설정하면 백그라운드에서 실행
  user_data_dir: ~/.config/openclaw/chrome

이제 OpenClaw에 다음과 같이 요청할 수 있습니다.

GitHub를 열고 새로운 Pull Request가 있는지 확인해 줘.

OpenClaw가 브라우저를 실행하거나 기존 브라우저를 제어해 직접 로그인하고 이동한 뒤 확인합니다.

이 기능은 아직 빠르게 발전하고 있습니다. 먼저 사용해 보고 싶다면 《OpenClaw 2026.3 고급 실전》을 참고하세요.

5장: 보안과 배포 — 운영 환경 모범 사례

5.1 보안 설정 체크리스트

OpenClaw는 명령을 실행하고 파일을 다룰 수 있으므로 보안 설정을 소홀히 해서는 안 됩니다.

API 키 관리

API Key를 설정 파일에 하드코딩하면 안 됩니다. 환경 변수를 사용하세요.

export ANTHROPIC_API_KEY=sk-ant-xxx

또는 OpenClaw의 Secrets 워크플로를 사용합니다.

openclaw secret set ANTHROPIC_API_KEY

키는 암호화해 저장하고 실행 시 환경 변수로 자동 주입됩니다.

샌드박스 설정

OpenClaw에는 기본적인 격리 조치가 있지만, 더 높은 보안이 필요하다면 Docker 샌드박스를 설정할 수 있습니다.

sandbox:
  type: docker
  image: openclaw/sandbox:latest
  resource_limits:
    memory: 512M
    cpu: 0.5

이렇게 하면 OpenClaw가 실행하는 코드는 모두 컨테이너 안에서 동작해 호스트 시스템에 영향을 주지 않습니다.

SELinux 설정

2026.3 버전에는 SELinux 자동 감지 기능이 추가되었습니다. 시스템에서 SELinux를 사용 중이면 OpenClaw가 올바른 context 설정을 안내합니다.

저도 CentOS에 배포할 때 문제를 겪었습니다. SELinux가 기본적으로 OpenClaw의 네트워크 접근을 차단하고 있었는데, 한참을 헤맨 뒤에야 원인을 찾았습니다.

기본 보안 체크리스트

  • API Key를 환경 변수 또는 Secrets로 관리
  • MEMORY.md와 .env 파일 권한을 600으로 설정
  • 운영 환경에 Docker 샌드박스 설정
  • SELinux/Firewall 규칙 확인
  • OpenClaw 버전을 정기적으로 업데이트

자세한 보안 설정은 《OpenClaw 보안 강화 가이드》를 참고하세요.

5.2 배포 방식 비교

OpenClaw는 여러 배포 방식을 지원하며 각각 장단점이 있습니다.

방식장점단점적합한 상황
로컬 배포간단하고 무료이며 데이터가 모두 로컬에 있음컴퓨터를 계속 켜 둬야 함개인 사용, 개발 테스트
서버 배포안정적이며 원격 접속 가능서버를 유지 관리해야 하고 비용이 듦소규모 팀, 운영 환경
클라우드 플랫폼(DigitalOcean 등)원클릭 배포, 유지 관리 불필요비용이 높고 데이터가 클라우드에 있음빠르게 출시하거나 직접 관리하고 싶지 않을 때

제가 선택한 방식

처음에는 로컬에서 실행했지만 컴퓨터가 절전 모드로 들어가면 멈췄습니다. 오래된 노트북을 서버로 써 봤지만 소음과 전기료 때문에 포기했습니다.

지금은 저렴한 VPS를 사용합니다. 한 달에 몇 달러 정도 들고 반년 넘게 안정적으로 실행되고 있습니다.

더 자세한 비교는 《OpenClaw 배포 비교》에서 확인할 수 있습니다.

5.3 기업용 배포 핵심 사항

회사에 OpenClaw를 배포하려면 더 많은 요소를 고려해야 합니다.

다중 사용자 관리

OpenClaw는 다중 사용자를 지원하며 사용자마다 독립된 Memory와 권한 설정을 가집니다.

users:
  - id: user1
    channels: [telegram, email]
    permissions: [read, write, execute]
  - id: user2
    channels: [web]
    permissions: [read]

모니터링과 로그

운영 환경에는 반드시 모니터링이 필요합니다. OpenClaw는 구조화된 로그를 출력할 수 있습니다.

logging:
  level: info
  format: json
  output: /var/log/openclaw/app.log

Grafana나 다른 모니터링 도구와 연동하면 실행 상태를 실시간으로 확인할 수 있습니다.

고가용성 설정

OpenClaw 중단이 업무에 영향을 준다면 고가용성을 고려해야 합니다.

  1. 다중 인스턴스 배포 + 부하 분산
  2. 데이터베이스에 Memory 영구 저장
  3. 설정과 데이터 정기 백업

자세한 내용은 《OpenClaw 기업용 배포》에서 확인할 수 있습니다.

6장: 학습 경로와 자료

6.1 초보 단계(0~1개월)

이 단계의 목표는 실행 환경을 만들고 간단한 일을 수행하는 것입니다.

권장 글

  1. 《OpenClaw 설치 가이드》— 안내에 따라 한 번 설치합니다.
  2. 《OpenClaw 아키텍처 가이드: 입문부터 고급까지》— 전체 구조를 이해합니다.
  3. 《OpenClaw 설정 가이드》— Telegram을 연결합니다.

실습 목표

  • 배포와 실행에 성공
  • 첫 대화 완료
  • OpenClaw가 선호를 기억하게 설정
  • web_search 같은 스킬 하나 사용

자주 발생하는 문제

  • 설치 실패: 소스 빌드를 고집하지 말고 공식 스크립트를 사용합니다.
  • Telegram 연결 실패: Bot Token과 네트워크를 확인합니다.
  • API 오류: 키가 올바른지, 잔액이 충분한지 확인합니다.

6.2 중급 단계(1~3개월)

이 단계의 목표는 OpenClaw로 실제 시간을 절약하는 것입니다.

권장 글

  1. 《OpenClaw 비용 관리: 모델 라우팅 전략》— API 비용을 절약합니다.
  2. 《OpenClaw 보안 강화 가이드》— 데이터를 안전하게 보호합니다.
  3. 《OpenClaw Cronjob 자동화 가이드》— 예약 작업을 설정합니다.

실습 목표

  • 다중 모델 라우팅으로 비용 절감
  • 예약 작업 2~3개 설정
  • 다중 채널 연동 시도(Telegram + Email)
  • 커뮤니티 스킬 라이브러리 탐색

조언

이 단계에서 가장 포기하기 쉽습니다. 새로움은 사라졌지만 실제로 시간이 절약된다는 느낌은 아직 들지 않기 때문입니다.

매일 반복하는 일 하나를 골라 OpenClaw에 맡겨 보세요. 매일 이메일을 정리하거나 매주 주간 보고서를 만드는 일이 좋은 예입니다. 효과를 확인하면 더 깊이 배울 동기가 생깁니다.

6.3 전문가 단계(3개월 이상)

이 단계의 목표는 OpenClaw를 자신의 목적에 맞는 도구로 바꾸는 것입니다.

권장 글

  1. 《OpenClaw 기업용 배포》— 운영 환경에 배포합니다.
  2. 《OpenClaw Skills 개발 가이드》— 사용자 정의 스킬을 만듭니다.
  3. 공식 소스 코드 — 내부 구현을 이해합니다.

실습 목표

  • 사용자 정의 스킬 개발
  • 운영 환경에 배포
  • 성능과 비용 조정
  • PR 제출과 튜토리얼 작성으로 커뮤니티에 기여

발전 방향

  • 자신의 워크플로에 깊이 통합
  • 스킬을 개발해 커뮤니티에 공유
  • 내부 아키텍처를 연구하고 프로젝트에 기여

6.4 외부 자료 추천

이 시리즈 외에도 참고할 만한 자료가 있습니다.

공식 자료

  • 공식 문서: docs.openclaw.ai
  • GitHub: github.com/openclaw/openclaw

커뮤니티 자료

  • awesome-openclaw-skills: 커뮤니티 스킬 모음
  • ClawHub: 공식 스킬 마켓

고품질 튜토리얼

  • freeCodeCamp의 《OpenClaw Full Tutorial for Beginners》— 가장 포괄적인 영어 입문 튜토리얼
  • every.to의 《OpenClaw Comprehensive Guide》— 이해하기 쉬운 설명

결론

OpenClaw를 배우는 데 시간을 투자할 가치가 있을까요?

반복 작업을 자주 처리하고 여러 도구를 오가며, ‘실제로 일을 해내는’ AI 도우미가 필요하다면 가치가 있습니다.

설치하자마자 모든 것을 바꾸는 만능 도구는 아닙니다. 처음에는 학습 비용이 들고 설정에도 시간이 필요합니다. 하지만 일단 제대로 실행되면 많은 일을 맡길 수 있다는 것을 알게 됩니다.

지금 바로 할 수 있는 세 가지:

  1. 배포 방식 하나를 선택해 OpenClaw를 설치합니다. 로컬, 서버, 클라우드 플랫폼 중 가장 편한 방식을 고릅니다.
  2. 스킬 하나를 사용해 봅니다. web_search나 memory부터 시작해 ‘AI가 스스로 일하는’ 감각을 경험해 보세요.
  3. 커뮤니티에 참여합니다. OpenClaw는 빠르게 발전하고 있으며 커뮤니티에도 살펴볼 만한 자료가 많습니다.

학습 중 문제가 생기면 시리즈에서 관련 글을 찾거나 GitHub에 Issue를 등록할 수 있습니다. 저도 여러 문제를 직접 겪었습니다. 언제든 의견을 나눠 주세요.

OpenClaw 빠른 시작 가이드

10분 안에 OpenClaw 설치와 첫 대화를 완료합니다

⏱️ Estimated time: 10 min

  1. 1

    Step 1: OpenClaw 설치

    공식 설치 스크립트로 한 번에 배포합니다.

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

    • macOS, Linux, Windows를 지원합니다. WSL2를 포함하며 공식 네이티브 Windows 설치 경로도 제공합니다
    • 의존성과 CLI 설치를 자동으로 처리합니다
    • 설치 후 `openclaw onboard --install-daemon`으로 초기 설정을 완료하고, `openclaw gateway status`로 Gateway를 확인합니다
  2. 2

    Step 2: API 키 설정

    초기 설정 마법사나 비밀 키 명령으로 API Key를 관리하는 것을 권장합니다. 예를 들면 다음과 같습니다.

    ```bash
    openclaw onboard --install-daemon
    # 또는 예시로, 공식 문서에 따라 secret 명령으로 키 저장
    ```

    • Claude, OpenAI, Gemini 등을 지원합니다. 현재 CLI 마법사의 선택지를 기준으로 확인합니다
    • 장기 키를 평문으로 Git이나 채팅 창에 올리지 않습니다
  3. 3

    Step 3: Telegram 연결

    1. @BotFather에서 Bot을 만들고 token을 받습니다
    2. `openclaw onboard`로 Telegram을 연결하거나, 공식 문서에 따라 `~/.openclaw/openclaw.json`의 `channels.telegram` 섹션을 편집합니다

    • Telegram 공식 안내: https://docs.openclaw.ai/channels/telegram
    • 기본 DM 정책은 보통 pairing이므로, 첫 개인 대화 때 Gateway에서 `openclaw pairing approve telegram <CODE>`를 실행해야 할 수 있습니다
    • WhatsApp, Discord 등 다른 채널도 지원합니다. 공식 Channels 문서를 기준으로 확인합니다
  4. 4

    Step 4: 첫 대화 완료

    실행한 뒤 Telegram에서 다음 메시지를 보냅니다.

    ```
    기억해 줘. 나는 기술 뉴스를 좋아하고 업무 언어는 한국어야.
    ```

    • `MEMORY.md`를 열어 메모리가 저장됐는지 확인합니다
    • 'OpenClaw 뉴스를 검색해 줘'라고 요청해 자율 실행을 경험해 봅니다

FAQ

OpenClaw와 ChatGPT는 무엇이 다른가요?
핵심 차이는 자율성입니다. ChatGPT는 수동적인 대화 도구라 조언이나 텍스트를 제공할 뿐입니다. OpenClaw는 단계를 스스로 계획하고 도구를 호출해 작업을 수행하는 AI 에이전트 프레임워크입니다. 예를 들어 이메일을 정리할 때 ChatGPT는 방법만 알려 주지만, OpenClaw는 메일함을 직접 열고 읽고 분류한 뒤 보고서를 보냅니다.
OpenClaw는 유료인가요?
OpenClaw 자체는 무료 오픈 소스입니다. 비용은 대규모 언어 모델 API 호출에서 발생합니다.

• Claude API: token 기준 과금
• OpenAI API: token 기준 과금

다중 모델 라우팅을 사용하면 비용을 40% 줄일 수 있습니다. 간단한 작업에는 Haiku/GPT-3.5를, 복잡한 작업에만 Sonnet/GPT-4를 사용합니다.
OpenClaw는 어떤 대규모 언어 모델을 지원하나요?
Anthropic Claude(권장), OpenAI GPT 시리즈, Google Gemini, Ollama를 통한 로컬 모델 등을 지원합니다. 설정 파일에서 기본 모델과 라우팅 규칙을 지정해 작업 난이도에 따라 자동 전환할 수 있습니다.
OpenClaw를 배포하려면 어떤 사양이 필요한가요?
최소 사양:
• CPU 1코어
• 메모리 512MB
• API에 접속할 수 있는 안정적인 네트워크

권장 사양:
• CPU 2코어
• 메모리 1GB
• 24시간 운영할 VPS 또는 클라우드 서버

로컬 개발과 테스트는 노트북으로도 충분합니다.
OpenClaw의 데이터는 안전한가요?
데이터는 로컬에 저장되며 제3자 서버로 업로드되지 않습니다. 다만 다음 사항은 지켜야 합니다. 1) API 키를 환경 변수로 관리합니다. 2) 운영 환경에 Docker 샌드박스를 설정합니다. 3) 취약점 수정을 위해 정기적으로 버전을 업데이트합니다. 대화 기록은 로컬 MEMORY.md 파일에 저장되므로 언제든 확인하고 삭제할 수 있습니다.
OpenClaw가 내 선호를 기억하게 하려면 어떻게 하나요?
'기억해 줘. 나는 기술 뉴스를 좋아해'라고 직접 말하면 MEMORY.md 파일에 자동 저장됩니다. 다음 대화부터 이 선호를 참고합니다. MEMORY.md 파일을 직접 편집해 메모리를 수정하거나 삭제할 수도 있습니다.

3분 읽기 · 게시일: 2026년 3월 18일 · 수정일: 2026년 9월 4일

댓글

GitHub로 로그인하여 댓글을 남기세요

Easton BlogEaston Blog