OpenClaw(이전 이름은 Clawdbot)는 최근 주목받고 있는 흥미로운 AI 비서입니다.개인용 PC에 설치하여 WhatsApp, Telegram 등 로컬에서 실행되는 다양한 앱과 상호 작용할 수 있다는 점이 특히 놀랍습니다.하지만 솔직히 말해서, 설치 및 실행 과정이 간단하지는 않습니다.특히 기술에 익숙하지 않은 사람이라면 더욱 그렇습니다.터미널 명령어, 설정 파일, API 키 사용에 익숙한 사람들에게 더 적합합니다.하지만 일단 설치 및 실행이 완료되면 반복적인 작업을 자동화하거나, 정보를 검색하거나, 대화를 나누는 등 다양한 기능을 제공하여 시간을 크게 절약할 수 있습니다.
한 가지 유의할 점은 일부 환경에서는 설치 과정이 다소 불안정하게 느껴질 수 있다는 것입니다.예를 들어 어떤 날에는 제대로 작동하다가 다음 날에는 작동하지 않거나, 알 수 없는 오류가 발생할 수 있습니다.따라서 이 가이드에서는 일반적인 설치 단계를 설명하고, 중간중간 유용한 팁과 요령을 알려드립니다.설치 과정이 다소 복잡하게 느껴지더라도 걱정하지 마세요.지극히 정상적인 현상입니다.다만, 명령 프롬프트나 설정 파일에서 발생하는 문제를 해결할 준비를 하셔야 합니다.이 가이드를 마치면 여러분의 PC에서 어느 정도 사용 가능한 AI 도우미를 사용할 수 있게 될 것이며, 이러한 도구를 원활하게 활용하는 방법에 대한 유용한 정보도 얻을 수 있을 것입니다.
Windows 11에서 OpenClaw를 설치하고 설정하는 방법
Node.js 설치 및 OpenClaw 설정
우선 OpenClaw는 Node.js에 의존하므로 Node.js 설치부터 시작해야 합니다. Node.js를 설치한 적이 없다면 먼저 설치하세요.버전 22 이상이 필요하며, 이전 버전은 사용할 수 없습니다.
- Node.js 다운로드 : Node.js 웹사이트 로 이동 하여 운영 체제와 호환되는 최신 버전을 다운로드하세요. Windows 설치 프로그램(MSI 파일)을 선택하는 것이 좋습니다.안정성이 정말 중요한 경우가 아니라면 LTS 버전은 다운로드하지 마세요.최신 버전에는 일반적으로 최신 기능이 포함되어 있습니다.
- Node.js 설치 : 설치 프로그램을 실행하고 기본 옵션을 그대로 사용하세요. Node를 PATH에 추가하는 확인란이 선택되어 있는지 확인하십시오.그렇지 않으면 PowerShell이나 명령 프롬프트에서 명령어를 실행하는 데 어려움을 겪을 수 있습니다.
Node.js가 설치되면 PowerShell 창을 열고( Windows PowerShellWin + X 선택 ) 다음 명령어를 입력하여 제대로 작동하는지 확인할 수 있습니다.
node -v npm -v이렇게 하면 현재 버전 번호가 표시되어 모든 설정이 완료되었음을 확인할 수 있습니다.
시스템에 OpenClaw 설치하기
- OpenClaw 웹사이트로 이동하세요.OpenClaw 웹 사이트를 방문하여 설치 지침 또는 빠른 시작 명령어를 찾아보세요.
- 설치 명령어를 복사하세요.보통은 `install install`이나 특정 스크립트와 같은 명령어입니다
npm install -g openclaw.많은 경우 저장소를 복제하거나 사용자 지정 스크립트를 실행해야 하는데, 복잡해 보이지만 터미널에서 복사해서 붙여넣기만 하면 됩니다. - 관리자 권한으로 PowerShell을 실행하려면 PowerShell 아이콘을 마우스 오른쪽 버튼으로 클릭하고 “관리자 권한으로 실행”을 선택하십시오.일부 명령에는 관리자 권한이 필요합니다.
- 명령어를 붙여넣고 실행하세요. Enter 키를 누르고 기다리세요.종속성 설치에 시간이 다소 걸릴 수 있으며, 환경 설정이 올바르지 않은 경우(빌드 도구 누락 등) 오류가 발생할 수 있습니다.이 경우 최신 Visual Studio 빌드 도구를 설치해야 할 수도 있습니다.
또 한 가지, 설치 과정에서 스크립트 실행에 대한 보안 경고나 메시지가 표시될 수 있습니다.주의해서 살펴보되, 링크를 통해 접속했다면 출처를 신뢰하는 것이 좋으며, 계속 진행하시겠습니까?
API 키 구성 및 초기 설정
설치 후 처음 실행 시 ChatGPT 또는 Claude와 같은 모델에 필요한 API 키를 설정하라는 메시지가 나타날 수 있습니다.따라서 OpenAI, Anthropic 또는 사용 중인 서비스의 API 키를 미리 준비해 두어야 합니다.설정 파일에 API 키를 붙여넣거나 메시지가 나타날 때 입력하면 됩니다.
안 좋은 소식은 일부 시스템, 특히 처음 설치하는 경우 환경 변수 누락, 종속성 오류 또는 네트워크 문제와 같은 설치 오류가 발생할 수 있다는 것입니다.이러한 오류는 대개 인터넷 연결 상태를 확인하거나, 종속성을 업데이트하거나, 권한을 조정하면 해결할 수 있습니다.경우에 따라 PowerShell이나 PC를 재시작하면 문제가 해결되기도 합니다.
상황이 예상치 못하게 흘러갈 경우를 대비한 추가 팁
- API 키가 올 바르고 활성화되어 있는지 확인하세요.
- 명령어를 실행하는 동안 오류가 발생하면 다음 명령어를 입력하여 Node.js 설치를 확인하세요
node -v. - 네트워크 문제가 발생하면 VPN 또는 방화벽을 일시적으로 비활성화해 보세요.
- 권한 오류가 발생하는 경우 터미널을 관리자 권한으로 실행하세요.
솔직히 말해서, 처음 설정하는 경우에는 전체 과정에 몇 번의 재시도나 구글 검색이 필요할 수도 있습니다.아주 빠른 방법을 원한다면 DigitalOcean의 가이드를 따라 원클릭으로 설정할 수 있는데, 이는 번거로움을 줄여줄 수 있지만 로컬 설정이 아닌 클라우드 서버를 사용해야 한다는 단점이 있습니다.
보안 및 개인정보 보호 관련 참고 사항
주의하세요. API 호출을 사용하는 AI 비서를 실행하고 있으므로 민감한 정보를 공유해서는 안 됩니다.비밀번호, 개인 식별 정보, 결제 정보 등은 채팅이나 프롬프트에 절대 입력하지 마세요.시스템에 민감한 데이터를 맡기는 셈이므로 중요하지 않은 PC에서만 실행하고 설정 파일에 비밀 정보를 저장하지 마세요.
24시간 내내 실행할 계획이라면 필요한 토큰과 활성화된 도구만 사용하세요.도구를 더 많이 사용하거나 토큰을 무제한으로 사용하면 예상치 못한 비용이나 보안 문제가 발생할 수 있습니다.윈도우를 비롯한 여러 도구들이 필요 이상으로 복잡하게 만들어 놓았기 때문이죠.
마지막으로
OpenClaw 설정은 특히 명령줄이나 설정 파일에 익숙하지 않은 사람들에게는 다소 어려울 수 있습니다.하지만 일단 설정이 완료되면 여러 작업을 자동으로 처리해 주기 때문에 작업 시간을 절약할 수 있습니다.시행착오를 겪을 수도 있다는 점을 염두에 두고 API 키를 안전하게 보관하세요.
요약
- Node.js(버전 22 이상)를 설치하세요.
- OpenClaw 코드를 다운로드하거나 npm을 통해 설치하세요.
- API 키를 구성하고 모델 플랫폼을 선택하세요.
- 보안 및 중요 데이터 관리에 주의하십시오.
- 오류가 발생할 수 있지만, 대부분은 인내심을 갖고 기다리면 수정할 수 있습니다.
마무리
이 글이 여러분이 자신만의 AI 비서를 구축하는 데 조금이나마 도움이 되기를 바랍니다.이러한 도구를 설정하는 과정이 항상 간단한 것은 아니지만, 일단 설정이 완료되면 시간을 크게 절약할 수 있습니다. API 키는 안전하게 보관하고 개인 정보는 너무 많이 공유하지 않도록 주의하세요.행운을 빌며, 이 글이 여러분의 삶을 조금이나마 편하게 만들어주기를 바랍니다.