macOS에 OpenClaw를 어떻게 설치하나요?

먼저 빠른 경로 명령을 사용하는 것을 권장합니다: npm install -g openclaw@latest && openclaw onboard

시작이 gateway mode 때문에 차단되면 어떻게 해야 하나요?

먼저 gateway.mode=local 전용 문제 해결 페이지를 보고, openclaw doctor와 logs --follow로 단계별 검증을 진행하세요.

먼저 doctor 점검을 하고, 시작 로그를 확인한 뒤, 엔드투엔드 명령 테스트를 한 번 실행하세요.

macOS 설치 가이드

로컬 우선 사용자에게 적합하며, 네이티브 App과 CLI 경로를 지원해 페어링과 시작 점검을 빠르게 마칠 수 있습니다.

빠른 경로 (대부분 사용자)

CLI를 전역 설치하고 바로 안내형 설정 절차로 들어갑니다.

npm install -g openclaw@latest && openclaw onboard

원클릭 설치 스크립트

한 줄 스크립트 설치로 빠르게 시작하기에 적합합니다.

curl -fsSL https://openclaw.ai/install.sh | bash

고급 / 소스 코드 경로

커스터마이징이 필요하거나 개발에 참여하려는 사용자에게 적합합니다.

git clone https://github.com/openclaw/openclaw.git && cd openclaw && pnpm install && pnpm run build

macOS 플랫폼 가이드

플랫폼별 구조와 설정 핵심 사항입니다.

페어링 및 gateway 점검

로컬 페어링과 통신 상태를 확인합니다.

문제 해결 개요

자주 발생하는 실패 상황과 점검 절차를 정리했습니다.

gateway.mode=local 시작 차단 해결

가장 흔한 시작 중단 문제 중 하나이며, 페이지에 원인과 실행 순서가 정리되어 있습니다.

openclaw logs --follow 이해하기

정상 출력과 이상 출력을 대조해 OpenClaw 설정 문제를 빠르게 파악하세요.

설치 문제 해결 도우미

지금 실행 중인 명령과 증상을 알려주면 도우미가 가장 정확한 문서 경로와 다음 단계를 안내합니다.

공식 문서 기반

저는 macOS에서 OpenClaw 설치, 설정, 문제 해결을 도와드릴 수 있습니다.

Common questions: