macOS에서 원격 OpenClaw 제어하기

내 로컬 컴퓨터의 리소스는 한정되어 있는데, 복잡한 작업을 처리해야 할 때가 많죠. 특히 서버나 다른 데스크톱에서 돌아가는 프로세스를 로컬 앱처럼 편하게 관리하고 싶을 때가 있습니다.

매번 터미널을 열어 원격 접속을 확인하는 대신, 익숙한 macOS 인터페이스에서 바로 제어할 수 있다면 정말 편할 거예요. 원격지에 있는 OpenClaw Gateway를 마치 내 맥에서 돌아가는 것처럼 연결하는 방법을 알려드릴게요.

필요한 것

• 원격 호스트에 Node.js 및 pnpm 설치
• OpenClaw CLI 빌드 및 설치 완료 (pnpm install && pnpm build && pnpm link --global)
• SSH 키 인증이 설정된 원격 호스트 (안정적인 연결을 위해 Tailscale IP 사용을 추천해요)

빠른 시작

5분 만에 원격 연결을 설정하는 방법입니다.

1. 원격 호스트 준비: openclaw 명령어가 non-interactive shell의 PATH에 포함되어 있어야 해요. 필요하다면 /usr/local/bin이나 /opt/homebrew/bin에 심볼릭 링크를 만들어주세요.
2. 앱 설정 이동: macOS 앱의 Settings → General 메뉴를 여세요.
3. 연결 정보 입력: OpenClaw runs 항목에서 Remote over SSH를 선택하고 다음 세부 정보를 설정하세요.
   • Transport: SSH tunnel (기본값) 또는 Direct (ws/wss) 중 선택하세요.
   • SSH target: user@host 형식으로 입력하세요. (같은 LAN에 있다면 탐색 목록에서 바로 선택할 수 있어요.)
   • Gateway URL: Direct 모드를 사용할 때만 필요합니다. (예: wss://gateway.example.ts.net)
4. 테스트: Test remote 버튼을 누르세요. openclaw status --json이 정상적으로 실행되면 설정 끝입니다!

이제 Health checks와 Web Chat이 설정한 SSH 터널을 통해 자동으로 작동합니다.

WhatsApp login flow (remote)

원격 호스트에서 WhatsApp을 연동하려면 다음 단계를 따르세요.

1. 원격 호스트에서 직접 openclaw channels login --verbose 명령어를 실행하세요.
2. 화면에 나타나는 QR 코드를 휴대폰의 WhatsApp 앱으로 스캔하세요.
3. 인증이 만료되면 해당 호스트에서 이 과정을 다시 실행하면 됩니다.

문제 해결

• exit 127 / not found: openclaw가 non-login shell의 PATH에 등록되지 않았을 때 발생해요. /etc/paths에 경로를 추가하거나 심볼릭 링크를 활용해 보세요.
• Health probe failed: SSH 접속 상태, PATH 설정, 그리고 openclaw status --json을 통해 Baileys 로그인 여부를 확인해 보세요.
• Web Chat 연결 끊김: 원격 호스트에서 Gateway가 실행 중인지, 그리고 포트 번호가 Gateway의 WebSocket 포트(기본 18789)와 일치하는지 확인하세요.
• Node IP가 127.0.0.1로 표시됨: SSH tunnel을 사용할 때 발생하는 정상적인 현상이에요. 실제 클라이언트 IP를 확인하고 싶다면 Direct (ws/wss) 모드로 변경하세요.

Notification sounds

알림 소리는 스크립트에서 직접 지정할 수 있습니다. 예를 들어 다음과 같이 사용하세요.

openclaw nodes notify --node <id> --title "Ping" --body "Remote gateway ready" --sound Glass

이제 앱 전체에 적용되는 글로벌 기본 사운드 설정은 제공되지 않으며, 호출 시마다 원하는 소리를 선택할 수 있습니다.

---

설정 중에 궁금한 점이 생기면 AI Setup Assistant에게 물어보세요!

What’s Next

• Security
• Tailscale