내 PC에서 24시간 일하는
AI 비서 만들기 —
OpenClaw 설치 가이드
텔레그램·카카오톡에서 말 걸면 알아서 이메일 보내고, 파일 관리하고, 웹 검색까지.
코딩 몰라도 30분이면 설치 완료.
ChatGPT나 Claude 같은 AI는 질문하면 대답해줍니다. 하지만 직접 뭔가를 실행하지는 않습니다. OpenClaw는 다릅니다. 내 PC에 상주하면서 파일을 읽고 쓰고, 이메일을 보내고, 웹을 탐색하고, 심지어 스스로 새로운 기능을 만들어냅니다. 텔레그램이나 WhatsApp에서 채팅하듯 명령하면 바로 실행합니다.
이 글은 설치 경험이 전혀 없는 분들을 위한 단계별 가이드입니다. 명령어가 낯설어도 괜찮습니다. 그대로 따라하면 됩니다.
OpenClaw가 뭔가요?
AI 비서가 내 컴퓨터 안에 산다
OpenClaw는 내 컴퓨터에서 직접 실행되는 오픈소스 AI 에이전트입니다. 클라우드 서버가 아닌 내 PC에서 돌아가기 때문에 데이터가 외부로 나가지 않습니다. AI 모델은 Claude, GPT, 또는 로컬 모델 중 선택할 수 있습니다.
채팅앱으로 제어
텔레그램, WhatsApp, Discord, Slack, iMessage 등 이미 쓰는 앱으로 대화합니다.
기억이 유지됨
대화 내용과 내 정보를 기억합니다. 매번 설명할 필요가 없습니다.
실제로 일함
파일 생성, 이메일 발송, 웹 검색, 코드 실행까지 직접 처리합니다.
웹 브라우저 제어
웹사이트 탐색, 폼 작성, 데이터 수집을 자동으로 합니다.
스킬 확장
커뮤니티 스킬을 설치하거나, 직접 새 기능을 만들 수 있습니다.
내 데이터, 내 서버
모든 데이터가 내 컴퓨터에 저장됩니다. 외부 전송 없음.
연결 가능한 채널:
시작 전 준비
딱 하나만 확인하면 됩니다 — Node.js
OpenClaw는 Node.js 22 이상이 필요합니다. Node.js는 JavaScript 실행 환경으로, 이미 설치되어 있을 수도 있습니다. 아래 명령어로 확인하세요.
① 터미널(명령 프롬프트) 열기
Windows: 시작 버튼 → cmd 검색 → 명령 프롬프트 실행
Mac: Cmd+Space → 터미널 검색 → 실행
② Node.js 버전 확인
node --version
v22.x.x 또는 그 이상이 나오면 준비 완료입니다. 설치되지 않았거나 버전이 낮다면 아래 방법으로 설치합니다.
Node.js 공식 사이트(nodejs.org)에서 LTS 버전(22 이상)을 다운로드하세요. Windows는 .msi 설치 파일을, Mac은 .pkg 파일을 받아 실행합니다. 설치 후 터미널을 새로 열고 node --version을 다시 확인하세요.
설치하기
명령어 하나로 끝납니다
OpenClaw 설치
터미널에 아래 명령어를 복사해서 붙여넣고 Enter를 누르세요. 설치 스크립트가 Node.js와 필요한 모든 것을 자동으로 설정합니다.
curl -fsSL https://openclaw.ai/install.sh | bash
iwr -useb https://openclaw.ai/install.ps1 | iex
위 방법이 안 되면 npm i -g openclaw 을 시도해보세요. npm은 Node.js 설치 시 함께 설치됩니다.
온보딩 마법사 실행
설치 후 아래 명령어를 실행하면 AI 모델 선택, API 키 설정, 채널 연결 등을 단계별로 안내해줍니다. 처음이라면 화면의 안내를 따라가기만 하면 됩니다.
openclaw onboard --install-daemon
마법사가 물어보는 것들:
- AI 모델 선택 (Claude 권장 — Anthropic API 키 필요, 또는 OpenAI GPT)
- API 키 입력 (Claude: console.anthropic.com / OpenAI: platform.openai.com에서 발급)
- 연결할 채널 선택 (텔레그램 추천 — 가장 간단)
- 에이전트 이름 설정 (원하는 이름 뭐든 가능)
게이트웨이 상태 확인
OpenClaw의 핵심 서버(게이트웨이)가 잘 실행 중인지 확인합니다.
openclaw gateway status
running 또는 active가 보이면 성공입니다. 백그라운드에서 24시간 돌아갑니다.
대시보드 열기 — 첫 대화!
아래 명령어를 실행하면 브라우저에서 컨트롤 화면이 열립니다. 채널 없이도 여기서 바로 AI와 대화할 수 있습니다.
openclaw dashboard
또는 브라우저 주소창에 직접 입력:
http://127.0.0.1:18789/
채팅창에 "안녕"이라고 입력해보세요. 에이전트가 응답하면 모든 설정이 완료된 겁니다.
텔레그램 연결하기 (추천)
스마트폰에서 AI를 부리는 법
대시보드도 좋지만, 텔레그램에 연결하면 외출 중에도 스마트폰으로 AI에게 작업을 시킬 수 있어서 훨씬 편리합니다. 온보딩 마법사에서 텔레그램을 선택했다면 아래 절차만 추가로 진행하면 됩니다.
텔레그램 봇 만들기
텔레그램에서 @BotFather를 검색해 대화를 시작합니다. /newbot을 입력하고 봇 이름과 사용자명을 설정하면 API 토큰을 발급해 줍니다. 이 토큰을 복사해두세요.
토큰을 OpenClaw에 등록
온보딩 마법사가 텔레그램 토큰을 물어볼 때 붙여넣으면 자동으로 연결됩니다. 이미 온보딩을 마쳤다면 설정 파일에서 수정하거나 openclaw onboard를 다시 실행해 채널을 추가할 수 있습니다.
텔레그램에서 AI에게 말 걸기
방금 만든 봇과 텔레그램 대화를 시작해보세요. "오늘 날씨 알려줘" 또는 "내 바탕화면에 test.txt 파일 만들어줘" 같이 말해보세요. AI가 실제로 실행합니다.
자주 막히는 부분 Q&A
이것만 알면 대부분 해결됩니다
Q. 명령어를 입력했는데 "openclaw: command not found"가 나와요
터미널을 완전히 닫았다가 새로 열어보세요. 설치 후 환경변수가 적용되려면 터미널 재시작이 필요합니다. 그래도 안 되면 npm i -g openclaw를 시도하세요.
Q. API 키는 어디서 받나요?
Claude를 쓰려면 console.anthropic.com에 가입 후 API 키를 발급받으세요. GPT를 쓰려면 platform.openai.com에서 발급받습니다. 둘 다 유료지만 처음엔 소액만 써도 충분합니다.
Q. 컴퓨터를 끄면 AI도 꺼지나요?
--install-daemon 옵션으로 설치하면 PC 부팅 시 자동 시작되도록 등록됩니다. PC가 켜져 있는 동안은 항상 실행 중입니다.
Q. 내 데이터가 외부로 나가지 않나요?
대화 내용, 파일, 메모리는 모두 내 PC에 저장됩니다. AI 모델 응답을 위해 API 호출이 발생하지만, 민감한 정보를 공유하지 않는 한 안전합니다.
Q. 설치하다 오류가 났어요
공식 Discord(discord.com/invite/clawd)에 질문하면 커뮤니티가 빠르게 도와줍니다. 오류 메시지를 그대로 캡처해서 올려주세요.
설치 완료 후 이렇게 말해보세요 :
"오늘 할 일 목록 만들어줘"
"내 Downloads 폴더에서 PDF 파일 목록 알려줘"
"매일 아침 9시에 날씨 브리핑해줘"
AI가 실제로 파일을 읽고, 스케줄을 만들고, 알림을 보내는 것을 경험하는 순간 — 그게 바로 사람들이 "AI의 미래가 이미 여기에 있다"고 말하는 이유입니다. OpenClaw는 그 경험을 지금 당장 할 수 있게 해줍니다.
공식 문서: docs.openclaw.ai | 공식 사이트: openclaw.ai | 커뮤니티: Discord