매뉴얼
OpenClaw 사용 가이드
설치가 완료되었습니다. AI 비서를 활용하는 방법을 안내해요.
빠른 시작
설치 직후 바로 시작할 수 있어요
AI 비서와 대화하기 (터미널)
새 터미널 창을 열고 아래 명령어를 입력하세요. 대화형 AI 인터페이스가 시작됩니다.
openclaw tuiAI 비서와 대화하기 (브라우저)
아래 명령어를 실행하면 브라우저에서 대시보드가 열립니다.
openclaw dashboard브라우저 대시보드 수동 접속
자동 열기가 안 될 경우, 아래 명령어로 토큰 URL을 확인한 뒤 브라우저에 붙여넣으세요.
openclaw dashboard --no-open데몬 상태 확인
AI 비서는 맥미니가 켜져있는 동안 항상 백그라운드에서 실행됩니다.
openclaw daemon status활용 예시
이렇게 말해보세요
AI 비서에게 자연어로 요청하면 돼요. 복잡한 명령어는 필요 없어요.
파일 · 시스템
“바탕화면에 있는 PDF 파일 요약해줘”
파일 읽기 + AI 분석“다운로드 폴더 정리해줘. 종류별로 나눠서”
파일 이동 자동화“brew로 설치된 프로그램 목록 보여줘”
시스템 명령 실행“시스템 저장 공간 분석해줘”
디스크 사용량 확인글쓰기 · 콘텐츠
“인스타그램 게시물 캡션 써줘. 주제: 봄 신메뉴”
마케팅 카피“이 이메일 답장 초안 작성해줘. 공손하게”
이메일 작성“블로그 포스트 아웃라인 잡아줘”
구조화된 글쓰기“이 보고서 문법 검토하고 피드백 줘”
교정 + 피드백업무 자동화
“매일 아침 9시에 뉴스 요약 만들어줘”
n8n 워크플로우 (Pro)“이 스프레드시트 데이터 분석해줘”
데이터 처리“Google Calendar에 미팅 일정 추가해줘”
gog 스킬 연동“이번 주 할 일 목록 정리해줘”
태스크 관리권한 설정
macOS 권한
AI가 컴퓨터를 완전히 제어하려면 아래 권한이 필요해요.
| 권한 | 용도 | 설정 위치 |
|---|---|---|
| 접근성 (Accessibility) | 키보드·마우스 제어, UI 자동화 | 시스템 설정 → 개인정보 보호 → 접근성 |
| 화면 기록 (Screen Recording) | 화면 캡처, UI 요소 인식 | 시스템 설정 → 개인정보 보호 → 화면 기록 |
| 전체 디스크 접근 | 모든 파일 읽기/쓰기 | 시스템 설정 → 개인정보 보호 → 전체 디스크 접근 |
Terminal 또는 iTerm 앱을 위 권한 목록에 추가하세요.
명령어 레퍼런스
유용한 명령어
openclaw tuiAI 비서 대화 시작 (터미널)
openclaw dashboard브라우저 대시보드 열기
openclaw dashboard --no-open대시보드 토큰 URL 확인
openclaw daemon status데몬 상태 확인
openclaw daemon restart데몬 재시작
openclaw daemon logs데몬 로그 확인
openclaw doctor --fix설정 문제 자동 진단/수정
openclaw config설정 확인/변경
npm update -g openclaw최신 버전 업데이트
문제 해결
자주 묻는 질문
AI가 응답하지 않아요+
데몬을 재시작해보세요: openclaw daemon restart. 그래도 안 되면 openclaw daemon logs로 로그를 확인하세요.
'openclaw' 명령어를 찾을 수 없다고 해요+
터미널을 닫고 새 창을 여세요. 설치 시 PATH가 설정되지만 기존 터미널에는 반영되지 않습니다. 그래도 안 되면: source ~/.nvm/nvm.sh 를 실행하세요.
API 키가 만료되었다고 해요+
Google AI Studio(aistudio.google.com/apikey)에서 새 키를 발급받고, ~/.openclaw/.env 파일의 GEMINI_API_KEY 값을 교체한 뒤 openclaw daemon restart로 재시작하세요.
Telegram 봇이 안 돼요+
launchctl list | grep telegram 으로 polling 데몬 상태를 확인하세요. 로그: cat ~/.openclaw/logs/telegram-polling.log
컴퓨터 제어 명령이 안 돼요+
시스템 설정 → 개인정보 보호 및 보안에서 OpenClaw 터미널에 접근성, 화면 기록, 전체 디스크 접근 권한을 부여하세요.
브라우저 대시보드에서 토큰을 어디서 찾나요?+
터미널에서 openclaw dashboard --no-open 명령어를 실행하면 토큰이 포함된 URL이 출력됩니다.
gateway already running under launchd 에러가 나요+
데몬이 이미 백그라운드에서 실행 중입니다. openclaw gateway run을 수동으로 실행하지 마세요. 대시보드를 열려면 openclaw dashboard를 사용하세요.
업데이트는 어떻게 하나요?+
npm update -g openclaw 명령어로 최신 버전으로 업데이트할 수 있습니다. 업데이트 후 openclaw daemon restart로 재시작하세요.