Platforms overview
macOS 앱
macOS 앱은 OpenClaw 메뉴 막대 컴패니언입니다. 네이티브 트레이 UI, macOS 권한 프롬프트, 알림, WebChat, 음성 입력, Canvas, 또는 system.run 같은 Mac 호스트 노드 도구가 필요할 때 사용하세요.
CLI와 Gateway만 필요하다면 시작하기부터 시작하세요.
다운로드
OpenClaw GitHub 릴리스에서 macOS 앱 빌드를 다운로드하세요. 릴리스에 macOS 앱 자산이 포함되어 있으면 다음을 찾으세요.
OpenClaw-<version>.dmg(권장)OpenClaw-<version>.zip
일부 릴리스에는 CLI, 증거, 또는 Windows 자산만 포함됩니다. 최신 릴리스에 macOS 앱 자산이 없으면 해당 자산이 있는 최신 릴리스를 사용하거나 macOS 개발 설정으로 소스에서 앱을 빌드하세요.
첫 실행
- OpenClaw.app을 설치하고 실행합니다.
- 로컬 Gateway의 경우 이 Mac을 선택하거나 원격 Gateway에 연결합니다.
- 로컬 모드에서는 앱이 사용자 공간 런타임과 Gateway를 설치하는 동안 기다립니다.
- 공급자 설정과 macOS 권한 체크리스트를 완료합니다.
- 온보딩 테스트 메시지를 보냅니다.
CLI/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 연결.
앱은 OpenClaw Gateway나 일반 CLI 문서를 대체하지 않습니다. 핵심 Gateway 구성, 공급자, Plugin, 채널, 도구, 보안은 각각의 문서에 있습니다.
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 개발 설정 |
관련 항목
Was this useful?
