화면 캡처, 컴퓨터 제어 또는 macOS 앱이 제공하는 시스템 권한이 필요하면 macOS 앱 노드를 선택하세요. 허용된 명령 실행, 브라우저 프록시, CI 자동화가 중심이면 headless node가 적합합니다. 두 형태 모두 Mac에서 작업을 실행하지만, Gateway를 어디에 둘지 정하는 글은 아닙니다.
이 글은 OpenClaw 자동화를 운영하며 Mac 노드의 실행 범위를 정해야 하는 개발자를 위한 안내입니다.
Agent 작업을 Gateway에서 원격 Mac으로 분리하려는 AI 엔지니어도 참고할 수 있습니다.
그래픽 작업과 무인 자동화 사이에서 노드 형태를 정하는 DevOps 엔지니어에게도 유용합니다.
마지막 검토: 2026년 10월 15일. 아래 내용은 OpenClaw macOS 앱 문서, 노드 CLI 문서, 권한 문서를 기준으로 정리했습니다. 배포 전에는 문서와 설치된 버전의 동작을 다시 대조하세요.
01 OpenClaw macOS 앱과 headless node 선택 기준
핵심 차이는 Mac 명령을 실행할 수 있느냐가 아닙니다. 노드가 제공해야 할 기능이 명령 실행인지, macOS의 화면 및 컴퓨터 제어 기능인지 먼저 나누세요. OpenClaw 문서는 노드 명령과 macOS 앱의 네이티브 기능을 별도 범위로 설명합니다. 노드 CLI 안내와 macOS 앱 안내를 함께 확인하세요.
| 실제 작업 | 먼저 검토할 형태 | 선택 전 확인할 경계 |
|---|---|---|
| 정해진 명령 실행, 스크립트, 무인 CI 작업 | headless node | 허용 명령 범위와 실행 승인 정책을 구성합니다. |
| 화면 캡처 또는 실제 컴퓨터 제어 | macOS 앱 노드 | 해당 기능에 필요한 macOS 권한을 허용하고 동작을 확인합니다. |
| 브라우저를 명령으로 실행하거나 브라우저 프록시 사용 | 필요한 도구가 제공되는 노드 | 브라우저가 포함됐다는 이유만으로 화면 제어가 필요한 것은 아닙니다. 도구와 권한을 따로 확인합니다. |
| Agent가 화면을 보고 앱 인터페이스를 조작 | macOS 앱 노드 | 명령 실행만 통과해도 화면 조작까지 된다는 뜻은 아닙니다. |
headless node도 Mac 명령을 실행할 수 있나요?
노드 CLI와 명령 정책에서 제공하는 실행 경로를 구성하면 허용된 명령을 대상으로 사용할 수 있습니다. 다만 명령 실행은 무제한 셸 권한과 같은 뜻이 아닙니다. 어떤 명령이 공개되고 승인되는지는 OpenClaw 명령 정책 문서에 따라 확인하고 설정하세요.
화면 작업이 하나라도 있으면 macOS 앱이 필요한가요?
Agent가 화면을 캡처하거나 컴퓨터 제어 기능으로 실제 인터페이스를 다뤄야 한다면 macOS 앱 노드를 검토하세요. macOS 앱의 기능 범위와 컴퓨터 제어 도구, 필요한 macOS 권한을 대조해야 합니다. 단순히 명령으로 브라우저를 실행하는 작업과 GUI 조작은 같은 작업이 아닙니다.
02 작업 장면별로 권한과 운영 부담을 비교합니다
두 번째 표는 노드 형태만 비교하지 않습니다. 배포 뒤 실제로 확인해야 하는 연결, 승인, 권한의 경계도 함께 보여 줍니다.
| 운영 항목 | headless node | macOS 앱 노드 |
|---|---|---|
| 명령 자동화 | 명령 정책에 따라 허용 범위를 정합니다. 노드 명령 정책을 확인합니다. | 앱 노드에서 명령 실행과 GUI 기능을 각각 검수합니다. |
| 화면 캡처와 컴퓨터 제어 | 해당 GUI 기능이 제공된다고 가정하지 마세요. 필요한 기능과 도구를 확인합니다. | macOS 앱의 네이티브 기능과 권한 설정을 확인합니다. |
| 무인 실행 | 노드 프로세스의 서비스 관리와 재연결 동작을 점검합니다. 노드 호스트 문서를 참고합니다. | 앱 실행 상태와 권한이 유지되는지 운영 환경에서 확인합니다. |
| 연결 및 승인 | 페어링 상태와 명령 승인 정책을 따로 확인합니다. | 페어링 상태와 macOS 권한을 각각 확인합니다. |
브라우저 작업은 세 가지로 나눠 보세요. 브라우저 프록시는 브라우저와 Agent 사이에 제공되는 도구의 기능이고, 명령으로 브라우저를 실행하는 작업은 명령 실행입니다. 화면을 읽거나 버튼을 눌러야 하는 GUI 작업은 컴퓨터 제어에 해당합니다. 사용할 노드에서 필요한 도구가 실제로 제공되는지, 권한이 승인됐는지 확인하세요. 노드 기능 안내는 컴퓨터 제어의 범위를 파악하는 데 도움이 됩니다.
주의: 페어링이 완료됐거나 노드 상태가 연결됨으로 표시돼도, 모든 명령이 승인됐거나 화면 제어 권한까지 허용됐다는 뜻은 아닙니다. 연결 상태와 기능별 실행 결과를 각각 검수하세요. 페어링 및 노드 상태 문서
03 상시 작업과 CI에서는 실행 주체를 분리합니다
CI나 예약 작업은 로그인 화면에서 사람이 조작하는 흐름과 다르게 운영해야 합니다. headless node를 검토하더라도 Gateway 연결, 프로세스 재시작, 노드 재연결, 작업을 보내는 주체를 확인하세요. 서비스 형태와 실행 조건은 현재 공식 노드 호스트 안내를 기준으로 삼습니다.
GUI가 필요한 단계를 CI 작업에 섞으면 headless node만으로는 작업이 끝나지 않을 수 있습니다. 반대로 빌드 스크립트나 제한된 명령 실행을 위해 화면 권한까지 설정하면, 필요한 범위보다 많은 권한을 운영하게 됩니다. 명령 작업과 GUI 작업을 분리해 각각 적합한 노드에 배정하면 권한 검수도 분명해집니다.
OpenClaw의 macOS companion app은 언제 선택하나요?
Agent가 macOS의 네이티브 권한을 사용하는 작업을 수행해야 할 때입니다. 화면 캡처와 컴퓨터 제어처럼 macOS 앱이 제공하는 기능이 필요한지 확인하고, 기능별 권한을 실제 Mac에서 시험하세요. 필요한 권한은 작업과 macOS 설정에 따라 달라질 수 있으므로 일괄 허용을 전제로 두지 마세요. macOS 권한 문서를 작업별 확인 기준으로 사용하세요.
04 선택한 노드를 작은 작업으로 검수합니다
아래 항목을 위에서부터 실행하세요. 한 단계가 통과해도 다음 단계의 기능까지 확인된 것은 아닙니다.
- [ ] Gateway가 맡는 역할과 Mac 실행 노드가 맡는 역할을 분리해 기록합니다. 이 글은 Mac 노드의 형태를 고르는 기준이며 Gateway 배치 위치를 비교하지 않습니다.
- [ ] 사용할 노드를 페어링하고, 공식 상태 안내에 따라 연결 여부와 노드 상태를 확인합니다. 연결 결과만으로 명령 실행이나 GUI 권한을 추정하지 않습니다.
- [ ] 자동화에 필요한 최소 명령을 실행합니다. 허용 범위와 승인 동작이 예상과 일치하는지 확인합니다.
- [ ] 브라우저 프록시나 브라우저 실행이 필요한 경우 해당 도구를 별도 시험합니다. 브라우저가 열린 것과 Agent가 페이지를 제어할 수 있는 것은 구분합니다.
- [ ] 화면 캡처 또는 컴퓨터 제어가 요구되는 경우 macOS 앱 노드에서 기능을 따로 시험하고, 필요한 시스템 권한만 허용합니다.
- [ ] CI나 무인 작업이라면 작업 시작, 노드 연결 유지, 재시작 뒤 복구까지 운영 절차에 맞춰 확인합니다. 실제 서비스 동작은 배포된 버전의 공식 문서와 대조합니다.
- [ ] 모든 작업이 같은 형태에서 통과하고 권한 범위도 적절하면 단일 노드로 운영합니다. GUI 단계와 명령 자동화의 요구가 다르면 노드 책임을 분리합니다.
운영에서 자주 놓치는 경계는 “연결됨”과 “작업 가능”을 같은 상태로 취급하는 것입니다. 연결은 페어링과 노드 상태의 확인 항목이고, 실행은 명령 정책이나 macOS 권한의 확인 항목입니다. 두 결과를 따로 기록해야 승인 실패를 연결 장애로 오진하거나, 필요한 권한이 빠진 상태로 작업을 배포하는 일을 줄일 수 있습니다.
참고: headless node라고 해서 그 자체로 더 안전한 것은 아닙니다. 실행 가능한 명령, 승인 정책, 노드 연결 권한을 실제 설정에 맞게 제한하고 검수해야 합니다.
05 원격 Mac 노드의 형태를 선택한 뒤
현재 Linux 서버에서 명령 자동화를 실행 중이라면 macOS 고유 권한이나 화면 제어를 그대로 대체할 수 없습니다. 반대로 로컬 Mac을 실행 노드로 쓰면 장비 가용성과 네트워크, 계정 및 권한 관리를 직접 책임져야 합니다. 화면 작업이 없는 자동화는 headless node부터 검수하고, macOS 앱의 네이티브 기능이 필요한 작업만 앱 노드에 배정하세요.
작업이 임시 테스트나 원격 Mac 실행 환경을 요구한다면, 장비를 직접 구매하기 전에 CALMVPS 요금 안내에서 비용 조건을 비교하고 원격 Mac 신청 안내에서 접속 환경을 확인할 수 있습니다. 자체 Mac이 이미 있고 지속적인 고정 부하나 물리 장치 연결이 중요하다면 직접 운영이 더 적합할 수 있습니다. 원격 임대는 실제 Mac에서 작업을 확인해야 하지만 상시 장비를 직접 보유하고 관리할 필요는 없는 경우에 검토하세요.