macOS 앱

macOS 앱은 OpenClaw의 메뉴 막대 컴패니언입니다. 네이티브 트레이 UI, macOS 권한 요청, 알림, WebChat, 음성 입력, Canvas와 system.run 같은 Mac 호스팅 Node 도구를 제공합니다.

CLI와 Gateway만 필요하십니까? 시작하기에서 시작하십시오.

다운로드

OpenClaw GitHub 릴리스에서 macOS 앱 빌드를 받으십시오. 릴리스에 macOS 앱 에셋이 포함된 경우 다음 파일을 찾으십시오.

• OpenClaw-<version>.dmg(권장)
• OpenClaw-<version>.zip

일부 릴리스에는 CLI, 증빙 자료 또는 Windows 에셋만 포함됩니다. 최신 릴리스에 macOS 앱 에셋이 없으면 해당 에셋이 포함된 가장 최신 릴리스를 사용하거나 macOS 개발 환경 설정을 통해 소스에서 빌드하십시오.

처음 실행

1. OpenClaw.app을 설치하고 실행합니다.
2. 로컬 Gateway를 사용하려면 This Mac을 선택하고, 그렇지 않으면 원격 Gateway에 연결합니다.
3. 앱이 일치하는 CLI 런타임을 설치하는 동안 기다립니다. 로컬 모드에서는 Gateway도 설치하고 시작합니다.
4. 실제 모델 검사로 추론 연결을 설정합니다. 검사를 통과하면 Crestodian이 나머지 설정을 처리합니다.
5. macOS 권한 체크리스트를 완료하고 온보딩 테스트 메시지를 전송합니다.

앱이 기본 에이전트에 모델이 구성된 기존 Gateway에 연결되면 해당 Gateway가 이미 설정된 것으로 간주하여 제공자 온보딩과 Crestodian을 건너뛰고 대시보드를 엽니다. Gateway에 연결할 수 없거나 기본 에이전트에 모델이 없으면 복구를 위해 추론 온보딩을 계속 사용할 수 있습니다.

CLI/Gateway 설정 경로는 시작하기를 참조하십시오. 권한 복구는 macOS 권한을 참조하십시오.

업데이트

대시보드 업데이트 카드는 먼저 Sparkle을 통해 서명된 macOS 앱을 업데이트합니다. 앱이 다시 실행되면 앱이 관리하는 일치하는 로컬 Gateway를 자동으로 업데이트하고 재시작합니다. Homebrew 및 기타 사용자 관리형 CLI 설치는 일반적인 Gateway 업데이트 흐름을 유지하며(카드가 Gateway 업데이트를 직접 실행함), 자동 복구는 더 새로운 Gateway를 다운그레이드하거나 extended-stable 채널 고정을 재정의하지 않습니다.

Sparkle은 Gateway의 update.channel 설정을 따릅니다. beta와 dev는 베타 앱 빌드를 사용하며, stable, extended-stable, 누락된 값 또는 알 수 없는 값은 안정 앱 빌드를 계속 사용합니다.

대시보드 링크 열기

macOS 앱의 내장 대시보드에서 외부 웹 링크를 클릭하면 크기 조절이 가능한 브라우저 사이드바에서 열립니다. 각 링크는 자체 탭에서 열리며, 동일한 링크를 다시 클릭하면 기존 탭을 재사용합니다. 탭을 드래그하여 순서를 변경하고, 탭 닫기 버튼이나 가운데 클릭으로 닫으며, 탭을 마우스 오른쪽 버튼으로 클릭하여 Open in Default Browser, Copy Link, Reload, Close Tab, Close Other Tabs를 사용할 수 있습니다. 창 제목 표시줄의 뒤로/앞으로 컨트롤과 트랙패드 스와이프로 대시보드 기록을 탐색하고, 사이드바 자체의 뒤로/앞으로 컨트롤로 활성 탭의 기록을 탐색합니다. 사이드바에는 새로고침, 기본 브라우저에서 열기, 닫기 컨트롤도 있으며 너비를 기억합니다.

제목 표시줄 컨트롤은 앱 사이드바 상태를 따릅니다. 사이드바가 펼쳐져 있으면 뒤로/앞으로 컨트롤이 사이드바 토글 옆의 오른쪽 가장자리에 배치되며, 접혀 있으면 해당 위치에 검색 버튼(명령 팔레트를 엶)과 새 세션 버튼이 표시됩니다.

외부 링크를 마우스 오른쪽 버튼으로 클릭하여 Open in Sidebar, Open in Default Browser 또는 Copy Link를 선택합니다. 대시보드에서 보조 키와 함께 클릭하거나 사용자가 새 창 링크를 활성화하면 계속 기본 브라우저에서 열리며, 사이드바 안의 새 창 링크는 새 사이드바 탭으로 열립니다. 일반 브라우저에서 호스팅되는 Control UI 페이지는 브라우저의 일반적인 링크 및 컨텍스트 메뉴 동작을 유지합니다.

브라우저 로그인 가져오기

앱이 로컬 Gateway에 연결되어 실행되고 Mac에 쿠키가 있는 Chrome 계열 프로필이 존재하면, 대시보드 창에 에이전트가 브라우징에 사용하는 격리된 관리형 프로필로 해당 쿠키를 복사하도록 제안하는 닫을 수 있는 배너가 표시됩니다. 배너의 Import 컨트롤에서 프로필을 선택하십시오(Touch ID가 필요할 수 있음). 진행 상황과 가져온 쿠키 수가 인라인으로 표시되며, 쿠키만 복사되고 비밀번호는 절대 원본 브라우저를 벗어나지 않습니다. 배너를 닫으면 선택이 기록되며, **Settings → General → Browser login → Import…**에서 언제든지 다시 제안받을 수 있습니다. 기본 가져오기 흐름과 browser.allowSystemProfileImport 게이트는 브라우저를 참조하십시오.

Gateway 모드 선택

앱이 Node 호스트 런타임을 재사용하므로 두 모드 모두 openclaw CLI가 설치되어 있어야 합니다. 새 Mac에서는 앱이 일치하는 CLI를 자동으로 설치합니다. 그런 다음 로컬 모드는 Gateway 마법사를 시작하고, 원격 모드는 두 번째 로컬 Gateway를 시작하지 않고 선택한 Gateway에 연결합니다. 수동 복구는 macOS의 Gateway를 참조하십시오.

앱이 관리하는 항목

• 메뉴 막대 상태, 알림, 상태 점검 및 WebChat.
• 화면, 마이크, 음성 인식, 자동화 및 손쉬운 사용을 위한 macOS 권한 요청.
• 네이티브 Canvas, 카메라/화면 캡처, 알림, 위치 및 컴퓨터 제어를 CLI Node 호스트의 시스템, 브라우저, Plugin, 스킬 및 MCP 명령과 결합하는 하나의 Mac Node.
• Mac 호스팅 명령에 대한 실행 승인 요청.
• 승인된 셸 명령을 앱 컨텍스트에서 실행하여 앱의 macOS 권한 귀속을 유지하면서 CLI 런타임이 공유 Node 정책을 관리하도록 합니다.
• 원격 모드 SSH 터널 또는 직접 Gateway 연결.

앱은 Gateway 또는 일반 CLI 문서를 대체하지 않습니다. Gateway 구성, 제공자, Plugin, 채널, 도구 및 보안은 각각의 문서에서 다룹니다.

macOS 세부 정보 페이지

관련 문서

• 플랫폼
• 시작하기
• Gateway
• 실행 승인