OpenClaw는 취미 프로젝트이며 아직 베타 단계입니다. 예상치 못한 문제나 미완성 기능이 존재할 수 있습니다. 이 봇은 도구가 활성화된 경우 파일을 읽거나 작업을 실행할 수 있습니다. 잘못된 프롬프트는 봇을 속여 안전하지 않은 동작을 수행하게 만들 수 있습니다. 기본적인 보안 및 접근 제어에 익숙하지 않다면 OpenClaw 실행을 권장하지 않습니다. 도구를 활성화하거나 인터넷에 노출하기 전, 경험 있는 사람의 도움을 받으십시오.
중요: OpenClaw는 도구가 활성화되면 파일을 읽거나 명령을 실행할 수 있다.
외부에 노출되면 매우 위험해질 수 있으니 기본 설정 그대로 공개 채널에 연결하지 않는 편이 안전하다.
예를 들어 챗봇에게 파일을 읽어 달라고 하면 그대로 출력할 수 있다.
2. 설치 모드 선택
Manual 모드는 게이트웨이와 워크스페이스를 수동으로 지정할 때 사용한다.
게이트웨이 선택(보통 로컬 머신)
워크스페이스 경로 지정
기본 경로는 ~/.openclaw/workspace
3. 모델 및 인증 공급자 선택
필요한 공급자를 활성화하면 된다. 선택하면 인증 절차를 안내해 준다.
Claude(Anthropic) 예시
일부 에이전트는 자동 설치되기도 한다.
수동 설치가 필요한 경우도 있다.
토큰 확인
1claude setup-token
모델 선택은 보통 기본값을 유지해도 된다.
필요하면 언제든 변경할 수 있다.
ChatGPT 같은 클라우드 모델은 API 키 방식이면 사용량 기반 과금이 될 수 있다. 하지만 구독형 계정을 쓰는 경우에도 API 키 없이 연동되는 방식이 있으니 살펴볼 만하다.
ChatGPT: OpenAI Codex (ChatGPT OAuth)
Claude: Anthropic token (setup-token 붙여넣기)
Gemini: Google Gemini CLI OAuth
4. 채널 선택
원하는 메신저 채널을 선택한다. 텔레그램은 무료라서 선택하는 경우가 많다.
텔레그램 봇 토큰 생성 및 입력
텔레그램 봇은 관리자 콘솔이 아니라 @BotFather 와 대화해서 생성하고 관리한다.
5. 스킬 선택
OpenClaw는 부가 기능을 스킬, 플러그인 같은 형태로 제공한다. 기본적으로 필요한 스킬만 켜고 시작해도 된다.
반복적으로 시키는 업무는 나중에 스킬로 만들어 붙일 수 있다.
고급 기능에 필요한 설정 예시
아래 같은 작업이 필요할 때만 활성화하는 편이 안전하다.
구글 지도에서 장소 탐색
이미지 생성
노션 데이터 탐색
음성을 텍스트로 변환(STT)
텍스트를 음성으로 변환(TTS)
Google Places
장소 검색에 필요한 Google API 키 설정이다.
예: “서울 강남구에서 점수 높은 맛집 추천해줘”
이미지 생성(Gemini, Nano Banana)
Gemini 기반 이미지 생성 기능을 사용할 때 설정한다.
Notion
노션 페이지에서 데이터를 참조할 때 사용한다.
이미지 생성(OpenAI)
Whisper(STT)
음성 파일을 텍스트로 변환한다.
텔레그램에서 음성으로 메시지를 보내면 이를 텍스트로 바꿔서 처리할 수 있다.
ElevenLabs(TTS)
텍스트를 음성으로 변환할 때 사용한다.
6. Hook 설정
항목별 참고 boot-md
gateway 시작 시 BOOT.md 를 자동 실행해서 초기 지침을 로드한다.
bootstrap-extra-files
glob 또는 path 패턴으로 workspace 초기 파일을 자동으로 주입한다.
개인적으로는 이 옵션만 빼고 활성화하는 편을 추천한다.
경로를 잘못 지정하면 workspace가 오염될 수 있다.
command-logger
모든 명령 이벤트를 중앙 감사 로그 파일에 기록한다.
session-memory
/new 실행 시 세션 컨텍스트를 메모리에 자동 저장한다.
7. 봇 실행
💡
macOS에서 실행 허용이 필요한 경우
TUI로 실행할지 Web UI로 실행할지 선택한다.
웹 UI가 편해 보이지만 채널 기반 비서를 쓸 예정이면 TUI도 충분하다.
실행 화면
8. 텔레그램 유저 인증
봇을 만든 뒤 메시지를 보내면 유저 인증을 진행한다. 아무 사용자나 봇을 통해 OpenClaw에 접근하면 안 되기 때문에 인증이 필요하다.
인증 코드는 텔레그램 메시지로 전달된다.
안내된 명령어를 복사해서 터미널에서 수동으로 실행하면 된다.
9. 내 호칭과 봇 이름 정하기
💡 봇이 사용자를 부를 이름과 사용자가 봇을 부를 이름을 정한다. 설정 후에는 일반 ChatGPT처럼 대화하며 쓸 수 있다.
1# 버전 확인 2❯ node -v
3 4# 실행 프로세스 확인 5ps -ef | grep openclaw
6 7# 참고로 프로세스를 죽여도 서비스나 런처로 등록되어 있으면 자동 재시작됨 8# 서비스나 런처로 등록된 경우 런처를 중단 시켜야함 9# mac 기준 : 실행중인 openclaw 찾기10launchctl list | grep openclaw
1112# 실행중인 openclaw 중지13launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist
141516# 새버전 설치하고 기본 버전 변경17nvm install 2218nvm use 2219nvm alias default 22
