openclaw node로 원격 실행 환경 구축하기

개발을 하다 보면 특정 명령어를 내 로컬 머신이 아닌 다른 서버나 원격 환경에서 실행해야 할 때가 있어요. 빌드 서버나 NAS, 혹은 다른 운영체제 환경에서 작업이 필요할 때마다 매번 복잡한 도구를 설치하고 관리하는 건 정말 피곤한 일이죠.

이럴 때 openclaw node를 사용하면 별도의 GUI 앱 없이도 Gateway에 연결해 원격으로 명령어를 실행할 수 있는 환경을 만들 수 있어요. 에이전트가 다른 머신에서 system.run이나 system.which를 호출할 수 있게 해주는 가벼운 방법을 소개할게요.

필요한 것

• openclaw CLI
• 연결 가능한 Gateway Host 및 Port 정보

빠른 시작

5분 안에 Node를 실행하고 Gateway에 연결하는 방법이에요. 먼저 포그라운드에서 Node를 실행해 보세요.

openclaw node run --host <gateway-host> --port 18789

처음 연결을 시도하면 Gateway에서 승인 대기 상태가 돼요. 다음 명령어를 통해 요청을 확인하고 승인해 주세요.

openclaw nodes pending
openclaw nodes approve <requestId>

승인이 완료되면 Node가 Gateway에 성공적으로 연결됩니다. Node의 식별 정보와 연결 설정은 ~/.openclaw/node.json에 저장돼요.

주요 기능 및 설정

Node Host를 사용하는 이유

Node Host는 다음과 같은 상황에서 특히 유용해요.

• Linux나 Windows 서버 등 다른 머신에서 에이전트가 명령어를 실행해야 할 때
• Gateway에서 실행을 샌드박스화하고, 승인된 실행만 다른 호스트로 위임하고 싶을 때
• 자동화 및 CI 노드를 위한 가벼운 headless 실행 환경이 필요할 때
• 특정 노드에서 브라우저 자동화 작업을 직접 수행하고 싶을 때

Browser Proxy

Node Host는 browser.enabled가 비활성화되어 있지 않다면 자동으로 Browser Proxy를 광고해요. 덕분에 추가 설정 없이도 에이전트가 해당 노드에서 브라우저 자동화를 사용할 수 있어요. 만약 이 기능을 끄고 싶다면 설정 파일에서 다음과 같이 수정하세요.

{
  nodeHost: {
    browserProxy: {
      enabled: false,
    },
  },
}

백그라운드 서비스로 실행하기

Node를 사용자 서비스로 설치해 백그라운드에서 계속 실행할 수 있어요.

openclaw node install --host <gateway-host> --port 18789

설치된 서비스는 다음 명령어들로 관리해요.

openclaw node status
openclaw node stop
openclaw node restart
openclaw node uninstall

문제 해결

문제가 생겼을 때는 다음 두 가지를 먼저 확인해 보세요.

• 페어링 문제: Node가 Gateway에 연결되지 않는다면 ~/.openclaw/node.json에 저장된 ID나 토큰 정보를 확인해 보세요. openclaw nodes pending 명령어로 Gateway에 대기 중인 요청이 있는지도 체크해야 해요.
• 실행 권한 문제: system.run 명령어가 거부된다면 로컬의 ~/.openclaw/exec-approvals.json 설정이나 Gateway에서 openclaw approvals --node <id|name|ip> 명령어를 통해 권한이 올바르게 부여되었는지 확인이 필요해요.

필요한 경우 openclaw node run을 실행할 때 --tls나 --tls-fingerprint 옵션을 사용해 보안 연결 설정을 다시 점검해 보세요.

---

설정 중에 도움이 필요하신가요? AI Setup Assistant에게 물어보세요.

What’s Next

• Exec approvals