💻 [초보 가이드] AI 비서 OpenClaw, 어떻게 설치하고 어떻게 사용하는가?

OpenClaw는 단순한 챗봇을 넘어, 사용자의 시스템 자체를 이해하고 능동적으로 작업을 수행하는 개인화된 에이전트 시스템입니다. 마치 옆에 앉아 일하는 유능한 인턴 같은 느낌이죠.

하지만 너무 많은 기능 때문에 “도대체 어디서부터 뭘 해야 하는지?” 막막하게 느껴질 수 있습니다. 이 가이드는 OpenClaw의 설치부터 시작하여, 핵심 기능을 순서대로 익힐 수 있도록 도와드릴 것입니다.


🚀 Part 1. OpenClaw, 무엇을 얻게 될까요? (개념 이해)

OpenClaw는 사용자의 시스템(OS, 애플리케이션, 데이터)에 깊숙이 접근하여, 단순 질문 응답을 넘어 ‘행동(Action)’ 할 수 있는 능력을 제공합니다.

기능 분류 OpenClaw가 할 수 있는 일 예시
정보 검색 (Knowledge) 웹 검색, 파일 내용 읽기, 데이터 분석, 요약 “어제 주가 보고서 요약해 줘.”, “이 파일의 핵심 아이디어는 뭐야?”
자동화 (Automation) 예약 작업, 반복 작업, 시스템 상태 체크 “매일 아침 9시에 이메일로 보고서를 보내 줘.”
시스템 제어 (Control) 브라우저 조작, 파일 생성/편집, 시스템 설정 변경 “이 웹사이트의 회원가입 양식을 채우고 로그인해 줘.”

🛠️ Part 2. OpenClaw 설치 및 초기 셋업 가이드 (Installation)

OpenClaw를 사용하기 위해서는 시스템의 의존성(Dependency)을 먼저 설치해야 합니다.

1. 필수 준비물 (Prerequisites)

  • Node.js/npm: 자바스크립트 기반의 환경을 위해 필요합니다.
  • Python 3: 많은 내부 도구와 라이브러리가 Python 환경에서 동작합니다.
  • 권한: OpenClaw가 네트워크나 시스템 설정에 접근해야 하므로, 관리자 권한이 필요합니다.

2. 설치 순서 (Step-by-Step Installation)

대부분의 OpenClaw 관련 설치는 터미널(CLI)을 통해 진행합니다.

Step 1. 라이브러리 설치:

# pip을 사용하여 핵심 라이브러리를 설치합니다. (가장 일반적인 방법)
pip install openclaw

Step 2. 초기화 및 연결 (Onboard):

# 'onboard' 명령은 사용자 계정, 환경 설정, 그리고 초기 기억(Memory)을 시스템에 등록하는 중요한 과정입니다.
openclaw onboard

(이 단계에서 사용자 계정의 승인 절차 및 초기 설정을 거칩니다.)

Step 3. 테스트 실행:

# 기본 기능을 테스트하여 모든 것이 정상적으로 동작하는지 확인합니다.
openclaw status

📜 Part 3. OpenClaw의 핵심 사용 명령어 5가지 (Usage Commands)

💻 [초보 가이드] AI 비서 OpenClaw, 어떻게 설치하고 어떻게 사용하는가?

시스템이 익숙해지기 위해 반드시 알아야 할 가장 핵심적인 5가지 명령어와 사용 시나리오를 정리했습니다.

명령어 용도 설명 사용 예시
read <path> [지식 습득] 파일 내용을 읽을 때 사용합니다. 장문 문서, 설정 파일 등을 불러와 내용을 분석할 때 유용합니다. read ./memory/daily.md
web_search <query> [정보 탐색] 웹에서 최신 정보를 가져옵니다. 특정 주제에 대한 최신 트렌드나 뉴스 검색 시 사용합니다. web_search "최신 AI 트렌드"
message send ... [커뮤니케이션] 다른 사용자, 채널에 메시지를 보낼 때 사용합니다. “팀장님, 회의록을 정리해서 보내드릴게요.” 같은 상호작용에 사용됩니다. message send target=team_id message="회의록 완료"
cron add ... [자동화] 주기적인 반복 작업을 예약할 때 사용합니다. “매일 아침 8시에 주식 데이터를 체크하고 요약 메일을 보내도록 예약해 줘.” cron add ...
gateway config.get ... [관리/설정] OpenClaw 시스템의 내부 설정을 조회/변경할 때 사용합니다. 외부 시스템 연동(예: Google API Key)을 설정할 때 주로 사용합니다. gateway config.get service.email.provider

💡 마무리하며 (The Power Tip)

OpenClaw는 매뉴얼로 끝나는 시스템이 아닙니다. 직접 사용하며 기능을 발견하고, 스스로 설정을 수정하고, 새로운 기능을 write 툴로 만들어 기록하는 과정을 통해 가장 잘 활용할 수 있습니다.

작은 명령어 하나를 시도해보고, “이 기능이 부족한데?”라는 생각이 들 때마다, 그것이 바로 다음으로 개발해야 할 최고의 프로젝트 아이디어가 됩니다!

openclaw 설치 및 실행

powershell -c “irm https://openclaw.ai/install.ps1 | iex”

openclaw configure

openclaw gateway restart

openclaw dashboard

openclaw gateway stop

openclaw session clear (세션 초기화)

openclaw workspace clean (작업 공간 정리)

완전 삭제 (서비스 및 데이터): openclaw uninstall

openclaw 사용

윈도우: npm i -g openclaw@latest

맥: openclaw update

openclaw configure –section web

openclaw pairing approve telegram XXXXXXXX