system.run 같은 Mac 호스트 노드 도구가 필요할 때 사용하세요.
CLI와 Gateway만 필요하다면 시작하기부터 시작하세요.
다운로드
OpenClaw GitHub 릴리스에서 macOS 앱 빌드를 다운로드하세요. 릴리스에 macOS 앱 자산이 포함되어 있으면 다음을 찾으세요.OpenClaw-<version>.dmg(권장)OpenClaw-<version>.zip
첫 실행
- OpenClaw.app을 설치하고 실행합니다.
- 로컬 Gateway의 경우 이 Mac을 선택하거나 원격 Gateway에 연결합니다.
- 로컬 모드에서는 앱이 사용자 공간 런타임과 Gateway를 설치하는 동안 기다립니다.
- 공급자 설정과 macOS 권한 체크리스트를 완료합니다.
- 온보딩 테스트 메시지를 보냅니다.
Gateway 모드 선택
| 모드 | 사용 시점 | 세부 페이지 |
|---|---|---|
| 로컬 | 이 Mac이 Gateway를 실행하고 launchd로 계속 유지해야 할 때. | macOS의 Gateway |
| 원격 | 다른 호스트가 Gateway를 실행하고 이 Mac이 SSH, LAN, 또는 Tailnet을 통해 제어해야 할 때. | 원격 제어 |
openclaw CLI가 필요합니다. 새 Mac에서는 앱이 Gateway 마법사를 시작하기 전에 일치하는 CLI와 런타임을 자동으로 설치합니다.
수동 복구는 macOS의 Gateway를 참조하세요.
앱이 담당하는 것
- 메뉴 막대 상태, 알림, 상태, WebChat.
- 화면, 마이크, 음성, 자동화, 손쉬운 사용에 대한 macOS 권한 프롬프트.
- Canvas, 카메라/화면 캡처, 알림,
system.run같은 로컬 노드 도구. - Mac 호스트 명령에 대한 실행 승인 프롬프트.
- 원격 모드 SSH 터널 또는 직접 Gateway 연결.
macOS 세부 페이지
| 작업 | 읽을 문서 |
|---|---|
| CLI/Gateway 서비스 설치 또는 디버그 | macOS의 Gateway |
| 클라우드 동기화 폴더 밖에 상태 유지 | macOS의 Gateway |
| 앱 검색 및 연결 디버그 | macOS의 Gateway |
| launchd 동작 이해 | Gateway 수명 주기 |
| 권한 또는 서명/TCC 문제 해결 | macOS 권한 |
| 원격 Gateway에 연결 | 원격 제어 |
| 메뉴 막대 상태 및 상태 검사 읽기 | 메뉴 막대, 상태 검사 |
| 내장 채팅 UI 사용 | WebChat |
| 음성 깨우기 또는 푸시 투 토크 사용 | 음성 깨우기 |
| Canvas 및 Canvas 딥 링크 사용 | Canvas |
| UI 자동화를 위한 PeekabooBridge 호스트 | Peekaboo 브리지 |
| 명령 승인 구성 | 실행 승인, 고급 세부 정보 |
| Mac 노드 명령 및 앱 IPC 검사 | macOS IPC |
| 로그 캡처 | macOS 로깅 |
| 소스에서 빌드 | macOS 개발 설정 |