openclaw dns 서비스 디스커버리 명령 튜토리얼

명령 개요

openclaw dns 명령은 OpenClaw의 서비스 디스커버리 기능을 관리합니다. 다중 노드 배포 시, 서비스 디스커버리를 통해 각 Gateway 노드가 수동으로 주소를 설정하지 않고도 자동으로 서로를 찾을 수 있습니다.

서비스 디스커버리 상태 조회

openclaw dns status

DNS Service Discovery:
  Mode: mDNS (local network)
  Status: Active
  This node: gateway-1 (192.168.1.10:3000)

  Discovered nodes:
    gateway-2    192.168.1.11:3000    ● Online    2ms
    gateway-3    192.168.1.12:3000    ● Online    3ms

서비스 디스커버리 활성화

mDNS 모드 (로컬 네트워크)

같은 네트워크 내 다중 노드 배포에 적합합니다:

openclaw dns enable --mode mdns

설정:

{
  "dns": {
    "enabled": true,
    "mode": "mdns",
    "serviceName": "openclaw",
    "port": 3000,
    "metadata": {
      "version": "1.2.3",
      "role": "primary"
    }
  }
}

DNS-SD 모드

DNS 기반 서비스 디스커버리로, 네트워크 간 배포에 적합합니다:

{
  "dns": {
    "enabled": true,
    "mode": "dns-sd",
    "domain": "openclaw.local",
    "registryUrl": "https://registry.example.com"
  }
}

Consul 모드

HashiCorp Consul을 사용한 서비스 디스커버리:

{
  "dns": {
    "enabled": true,
    "mode": "consul",
    "consulUrl": "http://consul.example.com:8500",
    "serviceName": "openclaw-gateway",
    "healthCheckInterval": "10s"
  }
}

등록 및 해제

# 현재 노드 수동 등록
openclaw dns register

# 현재 노드 등록 해제
openclaw dns deregister

# 메타데이터를 지정하여 등록
openclaw dns register --meta role=primary --meta region=us-east

다른 노드 탐색

# 발견된 모든 노드 조회
openclaw dns discover

Discovered OpenClaw Nodes:
  Name        Address           Port   Role      Region    Status
  ────────────────────────────────────────────────────────────────
  gateway-1   192.168.1.10     3000   primary   us-east   ● Online
  gateway-2   192.168.1.11     3000   replica   us-east   ● Online
  gateway-3   10.0.0.5         3000   replica   eu-west   ● Online

로드 밸런싱 연동

서비스 디스커버리가 로드 밸런서의 백엔드 목록을 자동으로 업데이트할 수 있습니다:

{
  "dns": {
    "loadBalancer": {
      "enabled": true,
      "strategy": "round-robin",
      "healthCheck": {
        "interval": 10000,
        "timeout": 5000,
        "unhealthyThreshold": 3
      }
    }
  }
}

이벤트 모니터링

# 노드 변경 이벤트 모니터링
openclaw dns watch

Watching for node changes...
  [10:30:01] NODE_JOIN    gateway-4  192.168.1.13:3000
  [10:35:22] NODE_LEAVE   gateway-2  192.168.1.11:3000
  [10:35:25] NODE_JOIN    gateway-2  192.168.1.11:3000  (reconnected)

자동 설정 동기화

새 노드 발견 시 자동으로 설정을 동기화합니다:

{
  "dns": {
    "autoSync": {
      "enabled": true,
      "syncConfig": true,
      "syncSecrets": false,
      "primaryNode": "gateway-1"
    }
  }
}

진단

openclaw dns diagnose

DNS Discovery Diagnostics:
  ✓ mDNS service running
  ✓ Port 5353 available
  ✓ Network interface: eth0 (192.168.1.10)
  ✓ Multicast enabled
  ✓ 2 nodes discovered
  ✓ All nodes healthy

보안 설정

{
  "dns": {
    "security": {
      "requireAuth": true,
      "authToken": "{{DNS_AUTH_TOKEN}}",
      "encryptTraffic": true,
      "allowedNetworks": ["192.168.1.0/24", "10.0.0.0/8"]
    }
  }
}

서비스 디스커버리 비활성화

openclaw dns disable

정리

openclaw dns는 다중 노드 배포에 자동화된 서비스 디스커버리 기능을 제공합니다. 로컬 네트워크 내의 mDNS이든 네트워크 간 Consul 연동이든, 여러 Gateway 노드가 자동으로 서로를 발견하고 협력하여 분산 배포의 운영 복잡도를 크게 줄입니다.