OpenClaw 메뉴바 컴패니언을 체험하고 싶은데 Node.js 환경 설정에 부담을 느끼시나요? 이 글은 로컬 명령줄 환경 없이 VNC로 원격 Mac에 접속해, 마우스 클릭만으로 DMG 다운로드 → 설치 → External Secrets 설정 → Gateway 연결까지 완료하는 방법을 안내합니다. 로컬 vs 원격 Mac 배포 비교표, 5단계 그래픽 작업 체크리스트, 메뉴바 일상 사용 요약을 포함하며, 명령줄 기초 없이도 15분 안에 실행할 수 있습니다.
① OpenClaw v2026.2.26 신기능: 메뉴바 컴패니언 + External Secrets
OpenClaw v2026.2.26이 2월 26일 정식 출시되었으며, AI 에이전트 일상 사용의 진입 장벽을 낮추는 두 가지 핵심 업데이트가 포함되었습니다.
- 메뉴바 컴패니언(Menu Bar Companion): macOS 네이티브 앱으로, 🦞 아이콘이 메뉴바에 상주하며, 클릭 한 번으로 AI 채팅 패널 호출, Agent 작업 상태 확인, 작업 완료 푸시 알림 수신이 가능합니다. 전역 단축키
⌘⇧Space로 언제든 패널을 띄우며, 앱 창 전환이 필요 없습니다. - External Secrets 외부 키 관리: env(환경 변수), file(로컬 파일), exec(명령 실행으로 키 획득) 세 가지 키 제공자를 지원하며, 원자적 핫 리로드 — Gateway 재시작 없이 API 키 교체가 가능해 키 유출 위험이 크게 줄어듭니다.
메뉴바 컴패니언 시스템 요구사항: macOS 14 Ventura 이상, 로컬에서 Gateway 실행 필요(기본 포트 localhost:18789), OpenClaw CLI 설치 필요. Universal Binary로 제공되며 Apple Silicon(M1–M4)과 Intel 아키텍처 모두 지원합니다.
참고 데이터 ①: Agent 활동 상태 아이콘 — 메뉴바 컴패니언은 6가지 실시간 상태 아이콘을 지원합니다: 🛠️ 도구 호출 / 📎 첨부 / 📝 편집 / ✍️ 쓰기 / 📄 읽기 / 💻 명령 실행. 터미널 없이 한눈에 Agent 현재 작업을 파악할 수 있습니다.
② 왜 원격 Mac에서 배포해야 할까? 로컬 설정의 일반적 장애물
OpenClaw 메뉴바 컴패니언은 DMG 드래그 설치 앱처럼 보이지만, 실제로는 CLI, Gateway, Node.js 런타임 세 층에 의존합니다. 비-macOS 개발자나 입문자에게는 로컬 설정이 다음 세 지점에서 막히는 경우가 많습니다.
- Node.js 버전 충돌: OpenClaw CLI는 pnpm을 권장하며, nvm으로 관리하는 구버전 Node.js와 경로 충돌이 자주 발생합니다.
EACCES: permission denied,Cannot find module '@openclaw/core'같은 오류가 나면 해결에 10분 이상 소요됩니다. - launchd 권한 설정 복잡: LaunchAgent(태그
ai.openclaw.gateway)는openclaw gateway install또는 앱 내 마법사로 등록해야 합니다. 보조 기능, 화면 녹화 등 TCC 권한을 적절한 시점에 부여하지 않으면 Gateway가 조용히 실패합니다 — 메뉴바 아이콘은 정상인데 Agent 응답이 없고, 로그 추적이 어렵습니다. - 상태 디렉터리 iCloud 혼선: OpenClaw 상태 디렉터리가
~/Documents나~/Desktop(둘 다 기본적으로 iCloud Drive 동기화)에 있으면 파일 잠금·동기 경합으로 세션 비정상 종료가 발생합니다.
VNCMac 원격 Mac이 이 세 가지를 해결하는 방법: 물리 Mac에는 Homebrew + pnpm + 권장 Node.js가 사전 설치되어 있으며, TCC 권한은 운영 단계에서 미리 부여되어 있습니다. 상태 디렉터리는 기본적으로 ~/.openclaw(iCloud 외부)에 마운트됩니다. VNC로 연결해 바로 설치하면 되며, 환경 의존성 처리가 필요 없습니다.
로컬 Mac 설정 vs VNCMac 원격 Mac 배포 비교
| 비교 항목 | 로컬 Mac 직접 설정 | VNCMac 원격 Mac 배포 |
|---|---|---|
| Node.js / pnpm 환경 | 버전 수동 관리, nvm + pnpm 충돌 빈번 | pnpm + 권장 버전 사전 설치, 충돌 없음 |
| TCC 권한 | 보조 기능/화면 녹화 등 수동 부여 | 일반 권한 사전 구성, 개봉 즉시 사용 |
| 상태 디렉터리 경로 | iCloud에 잘못 저장 시 파일 잠금 | 기본 ~/.openclaw, 권장 로컬 경로 |
| 첫 실행까지 소요 시간 | 30분–2시간(오류 수정 포함) | 약 10–15분(VNC 연결 + DMG 설치) |
| 하드웨어 요구사항 | 자체 macOS 14+ 기기 필요 | 아무 기기 + VNC 클라이언트로 접속 가능 |
| 비용 | Mac mini M4 신규 구매 약 80만 원+ | 시간당 약 2–4달러, 월정액 200달러+부터, 사용량 과금 |
참고 데이터 ②: VNCMac은 물리 Mac mini M4(Apple Silicon)를 제공하며, 통합 메모리 16GB 이상, macOS Sequoia 15.x 실행. OpenClaw 메뉴바 컴패니언의 모든 시스템 요구(macOS 14+, Apple Silicon 지원)를 충족합니다.
③ VNC 그래픽으로 OpenClaw 배포: DMG 다운로드 → 설치 → Secrets 설정 → Gateway 연결
아래 5단계는 모두 VNC 그래픽 데스크톱 안에서 진행하며, 마우스 클릭만으로 완료됩니다. 터미널을 열거나 명령줄을 입력할 필요가 없습니다.
VNCMac 원격 Mac 데스크톱에 연결
VNCMac 플랫폼에서 가입·기기 개통 후 VNC 주소와 비밀번호를 확인합니다. Windows는 RealVNC Viewer 또는 TigerVNC, Mac/Linux는 내장 「화면 공유」 앱으로 주소와 비밀번호를 입력하면 전체 macOS 데스크톱이 표시됩니다.
OpenClaw macOS App(Universal Binary DMG) 다운로드
원격 Mac에서 Safari를 열고 github.com/openclaw/openclaw/releases에 접속해 최신 버전(v2026.2.26 이상)을 찾습니다. Universal Binary DMG 파일(Apple Silicon M1–M4 및 Intel 지원)을 다운로드합니다. 다운로드 후 DMG가 자동 마운트되며 OpenClaw.app 아이콘이 보입니다.
앱 설치 및 macOS 권한 부여
OpenClaw.app을 Applications 폴더로 드래그합니다. 최초 실행 시 보조 기능, 화면 녹화, 알림 권한 요청이 순차적으로 뜹니다. 모두 「허용」을 누르면 메뉴바에 🦞 아이콘이 나타나 앱이 정상 실행됐음을 의미합니다.
External Secrets 및 API 키 설정
메뉴바 🦞 아이콘 클릭 → Settings → Secrets 탭 → 「Add Secret」. 사용 사례에 따라 env(환경 변수), file(파일 경로), exec(명령 실행) 중 하나를 선택해 키를 추가합니다. 저장 후 Secrets는 핫 리로드를 지원하므로 Gateway 재시작 없이 적용됩니다.
Gateway 기동 및 Agent 연결 확인
앱 메인 화면에서 「Start Gateway」(또는 Enable Local Gateway)를 클릭합니다. App이 launchd 시스템 서비스로 등록되며, 약 10–20초 후 연결 표시등이 녹색으로 바뀝니다. 🦞 메뉴바 아이콘을 클릭해 Agent 대화 패널이 보이고 메시지 전송이 되면 배포 완료입니다. ⌘⇧Space로 언제든 패널을 호출할 수 있습니다.
# SSH 터널로 로컬 18789를 원격 Mac 18789로 포워딩
ssh -L 18789:localhost:18789 [email protected] -N
# 이후 브라우저에서 http://localhost:18789 접속
④ OpenClaw v2026.2 초보 가이드와의 차이: 본 가이드는 메뉴바판 + 명령줄 제로
이전에 발행한 OpenClaw v2026.2.26 External Secrets + ACP 그래픽 설정 가이드와 본 가이드는 목적이 다릅니다.
| 비교 항목 | v2026.2 초보 가이드(기존) | 본 메뉴바 컴패니언 입문 가이드 |
|---|---|---|
| 대상 독자 | CLI 기초 있음, 신기능 심화 사용 | 명령줄 기초 없는 OpenClaw 입문자 |
| 핵심 기능 | External Secrets 세 가지 제공자, ACP 스레드 바인딩 프록시 | 메뉴바 컴패니언 설치 + Gateway 그래픽 기동 |
| 조작 방식 | 일부 명령줄(openclaw secrets add) 포함 |
순수 그래픽, 전 과정 마우스 클릭 |
| Node.js 의존 | pnpm / Node.js 로컬 환경 설정 필요 | 원격 Mac 사전 설치, 설정 불필요 |
⑤ 배포 후 일상 사용: 메뉴바 단축키, 푸시 알림, Agent 상태 모니터링
OpenClaw 메뉴바 컴패니언의 설계 철학은 「방해 없이, 언제든 사용」입니다. 배포 후 터미널이나 웹 새로고침 없이 다음 기능을 활용할 수 있습니다.
- ⌘⇧Space 전역 패널 호출: 어떤 앱에서든 단축키로 OpenClaw 대화 패널을 띄웁니다. 작업 설명을 입력하고 Enter를 누르면 Agent가 백그라운드에서 실행되며, 다른 작업을 계속할 수 있습니다.
- macOS 푸시 알림: Agent가 긴 작업(파일 일괄 이름 변경, 코드 리뷰, 테스트 케이스 생성 등)을 마치면 시스템 알림이 화면 오른쪽 상단에 표시됩니다. 알림을 클릭하면 대화 패널로 바로 이동해 결과를 확인할 수 있습니다.
- Exec Approvals 보안 승인:
system.run(시스템 명령 실행)에 화이트리스트가 적용되며, 새로운 명령이 처음 등장하면 「한 번 허용 / 항상 허용 / 거부」를 묻는 창이 뜹니다. Settings → Exec approvals에서 자주 쓰는 명령 경로를 미리 추가해 두면 일상적 방해를 줄일 수 있습니다.
참고 데이터 ③: VNCMac 원격 Mac에 OpenClaw를 배포할 때의 장점 — 메뉴바 컴패니언과 Gateway 서비스가 원격 머신에서 계속 실행되므로, 로컬 VNC 연결을 끊어도 Agent 작업은 원격 Mac에서 백그라운드로 계속됩니다. 다음에 VNC로 다시 연결하면 메뉴바 패널을 열어 완료된 작업 결과를 확인할 수 있습니다. 진정한 오프라인 비동기 AI Agent 워크플로를 구현할 수 있으며, 장시간 실행되는 배치 작업이나 코드 생성 시나리오에 적합합니다.