macOS OpenClaw 설정: Node.js 24 및 Homebrew 설치 가이드

OpenClaw macOS 설치 가이드

한 개발자가 macOS에서 OpenClaw를 실행하게 된 주말 프로젝트를 문서화했으며, 문서에서 명확하지 않았던 특정 설정 단계와 문제 해결 통찰을 공유했습니다.

시스템 요구사항 및 설치

설정에는 Node.js 24 또는 22.16+가 필요합니다. 개발자는 이전 프로젝트의 Node 20이 도움이 되지 않는 오류 메시지를 생성했다고 언급했습니다. 설치 옵션은 다음과 같습니다:

Homebrew: brew install openclaw-cli
공식 설치 스크립트 (한 가지 방법만 선택, 둘 다 아님)

설치 후 온보딩 마법사를 실행하세요:

openclaw onboard

제공자 구성

개발자는 별도의 OpenAI와 Anthropic 키에서 ZenMux를 사용하는 통합 제공자 엔드포인트로 전환했습니다. 온보딩 중 "사용자 정의 제공자"를 선택한 다음 "OpenAI 호환"을 선택하고 기본 URL과 API 키를 입력했습니다.

설치 후 구성은 ~/.openclaw/openclaw.json의 JSON5 구성 파일에서 수행할 수 있습니다:

// ~/.openclaw/openclaw.json
{
  models: {
    mode: "merge",
    providers: {
      "zenmux": {
        baseUrl: "<your provider's base URL>/v1",
        apiKey: "YOUR_API_KEY",
        api: "openai-responses",
      },
    },
  },
}

검증 및 백그라운드 운영

설정을 검증하려면:

openclaw doctor는 구성, 연결성 및 Node 버전을 확인합니다
openclaw models list는 사용 가능한 모델을 표시합니다
openclaw agent --local --agent main --message "Hello, respond with just Hi"로 기본 기능을 확인합니다

OpenClaw를 백그라운드 서비스로 실행하려면:

openclaw onboard --install-daemon

이렇게 하면 부팅 시 시작되는 macOS LaunchAgent가 설정됩니다. 실행 중인지 확인하려면 openclaw status를 사용하세요.

주의사항 및 문제 해결

개발자는 두 가지 주요 문제를 발견했습니다:

WhatsApp는 보안을 위해 기본적으로 모든 수신 메시지를 차단합니다. 발신자는 명시적으로 허용 목록에 추가되어야 하며, 그렇지 않으면 메시지가 조용히 삭제됩니다.
문제 해결 시 항상 openclaw doctor를 먼저 실행하세요. 대부분의 구성 문제를 발견합니다.

일주일간 사용 후, 개발자는 중단 시 모델 제공자 간 자동 장애 조치와 여러 제공자를 관리하는 대신 단일 API 키와 청구 페이지로 간소화된 결제 등의 이점을 언급했습니다.

📖 전체 소스 읽기: r/openclaw