OpenClaw는 선호하는 작업 방식과 설정 관리 방식에 따라 Mac에 여러 가지 방법으로 설치할 수 있습니다. 이 가이드에서는 다양한 설치 방법을 단계별로 안내하고, OpenClaw를 원활하게 실행하는 데 도움이 되는 팁도 함께 제공합니다.
빠른 개요: Mac에 OpenClaw를 설치하는 세 가지 방법
다음은 세 가지 방법을 나란히 비교한 내용입니다. 각 방법은 필요한 수동 설정의 정도가 다릅니다.
| 한 줄 설치 프로그램 | Homebrew | Kimi Claw(온라인) | |
|---|---|---|---|
| 개요 | OpenClaw를 자동으로 다운로드하고 설정하는 공식 설치 스크립트 | Homebrew로 Node.js 같은 종속성을 설치한 뒤 CLI로 OpenClaw를 실행하는 수동 설정 방식 | 수동 설정 없이 클라우드에서 OpenClaw를 실행할 수 있는 온라인 도구 |
| 필요한 수동 단계 | 수동 단계가 거의 없음 | 여러 수동 단계 필요 | 수동 설정 필요 없음 |
| 코드 또는 터미널 필요 여부 | 예 | 예 | 아니요 |
| 24시간 사용 가능 여부 | Mac이 깨어 있을 때만 실행됨 | Mac이 깨어 있을 때만 실행됨 | 클라우드에서 24시간 실행 |
| 추천 대상 | 가장 빠른 로컬 설정을 원하는 처음 사용자 | Homebrew로 패키지를 관리하는 것을 선호하는 개발자 | 로컬 설정 없이 OpenClaw를 실행하고 싶은 사용자 |
Kimi Claw를 사용하면 Node.js, Homebrew, API 키 설정 없이 클라우드에서 OpenClaw를 실행할 수 있습니다. 브라우저에서 몇 분 만에 작동하는 agent를 사용할 수 있습니다.
로컬 설정을 선호한다면 다음 섹션으로 계속 진행하세요. 더 간단한 방법을 원한다면 Kimi Claw로 Mac에서 OpenClaw 실행하기 섹션으로 이동하거나, 아래 버튼을 클릭해 바로 시작하세요.
시작 전: 필수 준비 및 보안
Mac에 OpenClaw를 로컬로 설치하기 전에 몇 가지 준비 및 보안 단계를 완료해야 합니다. Kimi Claw를 사용할 계획이라면 이 섹션은 건너뛰고 아래 설정 안내로 바로 이동해도 됩니다.
종속성: 한 줄 설치 프로그램은 필요 시 Node.js를 자동으로 설치합니다. Homebrew를 선택한 경우 Node.js를 직접 설치해야 합니다(Node 24 권장, Node 22 LTS 22.16+도 지원).
방화벽 및 네트워크 설정: macOS 방화벽은 일반적으로 기본값이 꺼짐입니다. System Settings > Network > Firewall에서 켤 수 있습니다. OpenClaw는 gateway를 127.0.0.1(localhost)에 바인딩하므로, 같은 네트워크의 다른 기기가 직접 연결할 수 없습니다. 모바일 또는 원격 접속이 필요하다면 Tailscale이나 SSH 터널 같은 도구를 사용할 수 있습니다. 라우터에서
18789포트를 포워딩하지 마세요.
한 줄 스크립트로 Mac에 OpenClaw 설치하기
Mac에서 OpenClaw를 로컬로 실행하는 가장 빠른 방법입니다. OpenClaw는 전통적인 그래픽 앱이 아니라 Terminal에서 실행되며, agent 관리를 위한 브라우저 기반 인터페이스를 제공합니다. 단일 명령으로 CLI를 설치하고 Node.js 버전을 확인한 뒤 온보딩 마법사를 시작합니다.
1단계. Terminal에서 설치 스크립트 실행
Spotlight(⌘ + Space)로 Terminal을 연 다음, 아래 명령을 붙여넣으세요.
스크립트가 시스템을 감지하고 OpenClaw CLI를 설치하며 Node.js 버전을 확인합니다. Node.js가 없거나 오래된 경우 Node 24를 자동으로 설치합니다(Node 22 LTS 22.16+도 지원).
2단계. API 키 설정 및 gateway 구성
설치가 끝나면 온보딩 마법사가 자동으로 시작됩니다. LLM 제공업체로 Moonshot AI(Kimi K2.5)를 선택하고, 안내가 나오면 Kimi API 키를 붙여넣으세요. gateway 포트와 인증은 기본 설정을 그대로 사용하면 됩니다. Mac이 부팅될 때 OpenClaw가 자동으로 시작되게 하려면 온보딩 중 daemon 설치 옵션을 선택하세요.
3단계. gateway 확인 및 dashboard 열기
다음 명령을 실행해 gateway가 실행 중인지 확인하세요.
그런 다음 dashboard를 여세요.
이 명령은 브라우저에서 http://127.0.0.1:18789의 Control UI를 엽니다. 로그인하려면 gateway token을 입력하세요. 로그인 후 OpenClaw agent와 상호작용을 시작할 수 있습니다.
Homebrew로 Mac에 OpenClaw 설치하기
Homebrew로 패키지를 관리하는 방식을 선호한다면, 조금 더 수동적인 설정으로 Mac에 OpenClaw를 설치할 수 있습니다. 이 방법은 종속성을 더 세밀하게 제어할 수 있고 기존 Homebrew 워크플로와도 잘 맞습니다.
1단계. Homebrew 설치
Spotlight(⌘ + Space)로 Terminal을 여세요. Homebrew가 설치되어 있지 않다면 다음 명령을 실행합니다. Homebrew는 macOS용 패키지 관리자로, 앱 스토어에서 앱을 설치하듯 Terminal에서 개발자 도구를 설치하고 관리할 수 있게 해줍니다.
설치 중 Mac 로그인 암호를 입력하라는 메시지가 표시될 수 있습니다. 보안상 입력하는 동안 Terminal에는 아무 문자도 표시되지 않습니다. 설치 확인 메시지나 설치 중인 파일을 보여주는 메시지도 나타날 수 있습니다.
설치가 완료되면 Terminal에 성공 메시지와 다음 단계가 표시됩니다.
2단계. Node.js 설치
Homebrew 설치가 끝나면 Node.js를 설치합니다.
설치 후 버전이 v24(권장) 또는 v22.16+인지 확인하세요.
3단계. OpenClaw CLI 설치 및 온보딩 실행
npm으로 CLI를 전역 설치한 뒤 온보딩을 실행합니다.
npm install -g 실행 중 EACCES 권한 오류가 표시되면 npm 전역 디렉터리에 더 높은 접근 권한이 필요하다는 뜻입니다. sudo npm install -g openclaw@latest를 실행하거나, 앞으로 sudo를 쓰지 않도록 npm 기본 디렉터리를 변경하세요.
--install-daemon 플래그는 OpenClaw를 LaunchAgent로 등록해 로그인할 때 gateway가 자동으로 시작되도록 합니다. 온보딩 중 제공업체로 Moonshot AI(Kimi K2.5)를 선택하고 Kimi API 키를 입력하세요.
4단계. gateway 확인 및 dashboard 열기
gateway가 실행 중인지 확인하고 dashboard를 엽니다.
브라우저에서 Control UI가 열립니다. gateway token을 입력하면 준비가 완료됩니다.
Kimi Claw로 Mac에서 OpenClaw 실행하기
Kimi Claw는 로컬 설정 없이 클라우드에서 OpenClaw를 실행할 수 있는 온라인 도구입니다. Mac에 설치할 것이 없고, Terminal을 사용하거나 종속성을 관리할 필요도 없습니다. 모든 것이 브라우저에서 실행됩니다. 몇 분 만에 OpenClaw agent를 만들 수 있습니다. Kimi Claw가 gateway, workspace, 저장소, 모델 접근을 처리하므로 MacBook을 닫아도 agent가 24시간 온라인 상태를 유지합니다.
Kimi Claw 사용 방법
1단계. Kimi Claw 열기
Kimi Claw 페이지로 이동해 Create를 클릭하면 OpenClaw 환경 배포가 시작됩니다.
2단계. OpenClaw 자동 배포
팝업 창에서 배포를 확인하세요. 그러면 Kimi Claw가 gateway, workspace, 도구를 포함한 OpenClaw 환경을 설정합니다. 이 과정은 보통 몇 분 안에 끝납니다.
3단계. OpenClaw 사용 시작
배포가 끝나면 dashboard에서 workspace가 열립니다. 브라우저에서 agent와 채팅하고, skill을 설정하고, 작업을 예약하고, 파일을 관리할 수 있습니다.
Kimi Claw와 로컬 OpenClaw 실행의 차이
Kimi Claw는 로컬 설정 없이 OpenClaw를 실행하는 더 간단한 방법을 제공합니다. 종속성을 설치하고 로컬 환경을 관리하는 대신, Kimi Claw가 기본 설정과 인프라를 처리하는 동안 브라우저에서 agent를 바로 실행할 수 있습니다.
로컬 설정 필요 없음: Node.js를 설치하거나 Terminal을 사용하지 않고 OpenClaw를 실행하세요. 모든 것이 브라우저에서 바로 작동하므로 더 빠르게 시작하고 환경 설정 문제를 피할 수 있습니다.
5,000개 이상의 skill 즉시 사용: 도구를 수동으로 설치하는 대신, Kimi Claw가 사용 가능한 대규모 도구 라이브러리에서 작업에 필요한 skill을 자동으로 사용할 수 있어 설정 시간과 호환성 문제를 줄여줍니다.
상시 자동화 및 예약: Mac이 잠자기 상태가 되면 중지되는 로컬 agent와 달리, Kimi Claw는 클라우드에서 24시간 실행되므로 예약 작업과 장시간 실행되는 워크플로에 적합합니다.
40GB 클라우드 저장소 및 지속 기억: 파일이 보통 단일 기기에 묶이는 로컬 설정과 달리, Kimi Claw에는 40GB 저장소가 포함되어 보고서와 연구 자료를 어떤 브라우저에서든 확인할 수 있습니다. 또한 세션이 바뀌어도 사용자의 선호와 작업 맥락을 기억하므로, 중단한 지점부터 이어서 작업할 수 있습니다.
통합 Kimi K2.5 모델 및 전문가급 검색: Kimi Claw에는 Kimi K2.5 접근 권한과 고급 검색 기능이 기본 포함되어 있어 API 키를 관리하거나 외부 서비스를 설정할 필요가 없습니다. 금융, 기술, 뉴스 등 다양한 분야의 최신 정보를 자동으로 가져와 연구와 작업 실행을 한층 매끄럽게 해줍니다.
Mac에서 OpenClaw를 24시간 계속 실행하기
대부분의 사용자는 AI를 일반 데스크톱 앱처럼 다룹니다. 책상 앞에 있을 때 사용하고, 일이 끝나면 닫아 버리죠. 하지만 밤새 글로벌 시장을 모니터링하거나 오전 8시까지 연구 보고서를 받은편지함에 준비해 두는 등 가치 있는 자동화를 원한다면 agent가 24시간 계속 활성 상태여야 합니다. macOS는 시스템이 잠자기 상태가 되면 로컬 프로세스를 자연스럽게 일시 중지하므로, 이를 구현하려면 별도의 전략이 필요합니다. 이 섹션에서는 지속 연결을 유지하는 두 가지 방법을 다룹니다.
옵션 A: 전용 Mac 하드웨어
한 가지 방법은 Mac mini 같은 Mac을 계속 켜 두는 것입니다. sudo pmset -a sleep 0으로 잠자기 모드를 비활성화하고, 시스템 설정에서 “네트워크 연결 시 깨우기”를 켤 수 있습니다. 원격 접속에는 Tailscale이나 SSH 터널 같은 도구를 사용할 수 있습니다.
이 설정을 사용하면 OpenClaw를 사용자의 하드웨어에서 계속 실행할 수 있지만, 기기를 항상 켜 두고 유지보수, 업데이트, 재시작을 직접 관리해야 합니다.
옵션 B: Kimi Claw가 자동으로 처리
Kimi Claw로 agent를 실행하면 24시간 가용성이 기본 제공됩니다. agent가 로컬 기기와 독립적으로 실행되므로 Mac을 닫거나 오프라인 상태가 되어도 계속 작업합니다. 잠자기 설정을 조정하거나 기기를 계속 켜 둘 필요가 없습니다.
Mac에서 흔히 발생하는 OpenClaw 설치 오류 해결
설정이 간단하더라도 설치 중 문제가 생길 수 있습니다. 자주 발생하는 문제와 해결 방법은 다음과 같습니다.
OpenClaw command not found 오류
원인: npm 전역 bin 디렉터리가 셸 PATH에 포함되어 있지 않습니다.
해결:
source ~/.zshrc를 실행해 셸 구성을 다시 불러오세요. Zsh 대신 Bash를 사용한다면~/.zshrc를~/.bash_profile로 바꾸세요. 오류가 계속되면 npm prefix를 찾아 PATH에 추가합니다.
재부팅 후 OpenClaw가 시작되지 않음
원인: 온보딩 중 LaunchAgent가 설치되지 않았습니다.
해결: daemon 플래그를 붙여 온보딩 명령을 실행하세요.
이렇게 하면 로그인 시 OpenClaw gateway를 자동으로 시작하는 LaunchAgent가 등록됩니다. 활성 상태인지 확인하려면 다음을 실행하세요.
포트 18789가 이미 사용 중임
원인: 다른 프로세스가 gateway 포트를 점유하고 있습니다.
해결: 충돌하는 프로세스를 찾아 중지하세요.
skill 설치 중 Xcode Command Line Tools 오류
원인: 일부 npm 패키지는 네이티브 컴파일이 필요하며, Xcode Command Line Tools가 없거나 오래되었습니다.
해결: 도구를 설치하거나 업데이트하세요.
설치가 완료되면 skill 설치를 다시 시도하세요.
Node.js 버전이 너무 오래됨
원인: Mac에 설치된 Node.js 버전이 22.16보다 낮습니다. OpenClaw에는 Node 24(권장) 또는 Node 22 LTS 22.16+가 필요합니다.
해결: Homebrew를 사용했다면 다음을 실행하세요.
원라인 설치 프로그램을 사용했다면 다시 실행하세요. 스크립트가 오래된 버전을 감지해 업데이트합니다.
마무리
OpenClaw는 원라인 설치 프로그램이나 Homebrew를 사용해 Mac에서 로컬로 실행할 수도 있고, 로컬 설정 없이 Kimi Claw를 통해 브라우저에서 실행할 수도 있습니다. 어떤 방법이든 작동하는 agent를 만들 수 있지만, 필요한 수동 작업의 수준은 서로 다릅니다. 더 빠르게 설정하고 24시간 가용성까지 기본으로 갖추고 싶다면 Kimi Claw로 시작해 몇 분 안에 agent를 실행할 수 있습니다.
자주 묻는 질문
openclaw onboard --install-daemon을 실행해 로그인 시 gateway를 시작하는 LaunchAgent를 등록하세요. daemon이 이미 설치되어 있는데도 시작되지 않는다면 launchctl list | grep openclaw로 상태를 확인하고 시스템 로그를 살펴보세요. Kimi Claw 사용자는 서비스가 클라우드 서버에서 실행되어 독립적으로 온라인 상태를 유지하므로 이 설정이 필요하지 않습니다.source ~/.zshrc를 실행해 설정을 다시 불러오세요. 그래도 명령을 찾을 수 없다면 npm config get prefix로 bin 디렉터리 위치를 확인한 뒤 ~/.zshrc의 PATH에 추가하세요. 변경 후 Terminal을 다시 시작하세요.sudo pmset -a sleep 0) 전용 Mac Mini를 마련하고 Tailscale로 원격 접속을 설정하거나, Kimi Claw를 사용하세요. Kimi Claw는 완전 관리형 플랫폼으로, 유지보수할 하드웨어 없이 OpenClaw agent를 24시간 온라인 상태로 유지합니다.curl -fsSL https://openclaw.ai/install.sh | bash를 실행하세요. 스크립트가 OpenClaw를 설치하고 Node.js 버전을 확인한 다음 설정 과정을 안내합니다. Homebrew를 사용할 수도 있습니다. brew install node를 실행한 뒤 npm install -g openclaw@latest를 실행하세요. 터미널 없이 완전 관리형으로 사용하려면 Kimi Claw가 브라우저에서 OpenClaw를 실행해 주므로 로컬 설정이 필요 없습니다.curl -fsSL https://openclaw.ai/install.sh | bash)를 실행하거나 Homebrew를 통해 npm install -g openclaw@latest로 설치하세요. 다운로드가 필요 없는 브라우저 기반 옵션으로는, Kimi Claw가 클라우드 서버에서 OpenClaw를 대신 실행해 줍니다.