macOS app

기준일: 2026-07-26
공식 기준: macOS app

macOS app 문서는 OpenClaw 공식 문서(platforms/macos)를 한국어로 정리한 가이드입니다. Install and use the OpenClaw macOS menu bar app 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Install and use the OpenClaw macOS menu bar app

한국어 가이드 범위: platforms/macos 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Download
• First run
• Updates
• Open dashboard links
• Import browser logins
• Choose a Gateway mode
• What the app owns
• macOS detail pages
• 관련 문서

상세 내용

본문

The macOS app is the OpenClaw menu bar companion: native tray UI, macOS permission prompts, notifications, WebChat, voice input, Canvas, and Mac-hosted node tools such as system.run.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Download

Get macOS app builds from OpenClaw GitHub releases. When a release ships macOS app assets, look for:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• OpenClaw-<version>.dmg (preferred)
• OpenClaw-<version>.zip

First run

1. Install and launch OpenClaw.app. 2. Pick This Mac for a local Gateway, or connect to a remote Gateway. 3. Wait while the app installs the matching CLI runtime. In local mode it also installs and starts the Gateway. 4. Establish inference with a live model check. After it passes, OpenClaw handles the remaining setup. 5. Complete the macOS permission checklist and send the onboarding test message.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Updates

The dashboard update card names what the app will update:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Update Mac app + Gateway means the signed app owns the local launchd
• Update Gateway means the app is connected to a remote Gateway, a manually

Open dashboard links

In the macOS app's embedded dashboard, clicking an external web link opens it in a resizable browser sidebar at half the window width while keeping the dashboard navigation visible. Drag the divider to choose another width; the app remembers it. Each link opens in its own tab, the tab strip appears when multiple pages are open, and clicking the same link again reuses its existing tab. Drag tabs to reorder them, close them with the tab close button or a middle-click, and right-click a tab for Open in Default Browser, Copy Link, Reload, Close Tab, and Close Other Tabs. The window's titlebar back/forward controls and trackpad swipes navigate dashboard history; the sidebar's own back/forward controls navigate the active tab's history. The sidebar also has reload, open-in-default-browser, and close controls.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Import browser logins

The first time the browser sidebar opens while the app runs against a local Gateway, the dashboard shows a dismissible banner when a Chrome-family profile with cookies exists on the Mac. The banner offers to copy those cookies into an isolated managed profile that agents use for browsing. Choose a profile from its Import control (Touch ID may be required); progress and the imported-cookie count appear inline, and only cookies are copied — passwords never leave the source browser. Dismissing the banner records the choice; Settings → General → Browser login → Import… re-offers it at any time. See Browser for the underlying import flow and the browser.allowSystemProfileImport gate.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Choose a Gateway mode

Both modes need an installed openclaw CLI because the app reuses its node-host runtime. On a fresh Mac, the app installs the matching CLI automatically; local mode then starts the Gateway wizard, while remote mode connects to the selected Gateway without starting a second local Gateway. See Gateway on macOS for manual recovery.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Mode	Use it when	Detail page
Local	This Mac should run the Gateway and keep it alive with launchd.	Gateway on macOS
Remote	Another host runs the Gateway; this Mac controls it over SSH, LAN, or Tailnet.	Remote control

What the app owns

location, and computer control with the CLI node host's system, browser, plugin, skill, and MCP commands.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Menu bar status, notifications, health, WebChat, and the floating Quick Chat bar.
• macOS permission prompts for screen, microphone, speech, automation, and accessibility.
• One Mac node that combines native Canvas, camera/screen capture, notifications,
• Exec approval prompts for Mac-hosted commands.
• App-context execution for approved shell commands, preserving the app's macOS
• Remote-mode SSH tunnels or direct Gateway connections.

macOS detail pages

Task	Read
Install or debug the CLI/Gateway service	Gateway on macOS
Keep state out of cloud-synced folders	Gateway on macOS
Debug app discovery and connectivity	Gateway on macOS
Understand launchd behavior	Gateway lifecycle
Fix permissions or signing/TCC issues	macOS permissions
Detect the Mac you most recently used	Active computer presence
Connect to a remote Gateway	Remote control
Read menu bar status and health checks	Menu bar, Health checks
Use the embedded chat UI	WebChat
Use voice wake or push-to-talk	Voice wake
Use Canvas and Canvas deep links	Canvas
Host PeekabooBridge for UI automation	Peekaboo bridge
Configure command approvals	Exec approvals, advanced details
Inspect Mac node commands and app IPC	macOS IPC
Capture logs	macOS logging
Build from source	macOS dev setup

관련 문서

주요 항목:

• Platforms
• Getting started
• Gateway
• Exec approvals

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/platforms/macos
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

관련 링크

• 공식 원문: platforms/macos
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.