Location command

Location command 문서는 OpenClaw 공식 문서(nodes/location-command)를 한국어로 정리한 가이드입니다. Location command for nodes, platform permission modes, and Linux GeoClue setup 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Location command for nodes, platform permission modes, and Linux GeoClue setup

한국어 가이드 범위: nodes/location-command 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

TL;DR
Why a selector (not just a switch)
Settings model
Permissions mapping (node.permissions)
Command: location.get
Background behavior
Linux node host
Model/tooling integration
UX copy (suggested)
관련 문서

상세 내용

TL;DR

주요 항목:

location.get is a node command, invoked via node.invoke or openclaw nodes location get.
Off by default.
Android third-party builds use a selector: Off / While Using / Always. Play builds remain Off / While Using.
Precise Location is a separate toggle.

Why a selector (not just a switch)

OS location permissions are multi-level. Precise location is a separate OS grant too (iOS 14+ "Precise", Android "fine" vs "coarse"). The in-app selector drives the requested mode, but the OS still decides the actual grant.

Settings model

주요 항목:

location.enabledMode: off | whileUsing | always
location.preciseEnabled: bool
Selecting whileUsing requests foreground permission.
Selecting always in the Android third-party build first requests foreground permission, explains the background access, then opens Android app settings for the separate Allow all the time grant.
Android Play builds do not declare background location permission or show always.
If the OS denies the requested level, the app reverts to the highest granted level and shows status.

Permissions mapping (node.permissions)

Optional. The macOS node reports location via the permissions map on node.list/node.describe; iOS/Android may omit it.

Command: location.get

Called via node.invoke, or the CLI helper:

주요 항목:

LOCATION_DISABLED: selector is off.
LOCATION_PERMISSION_REQUIRED: permission missing for requested mode.
LOCATION_BACKGROUND_UNAVAILABLE: app is backgrounded but only While Using is granted.
LOCATION_TIMEOUT: no fix in time.
LOCATION_UNAVAILABLE: system failure or no providers.

openclaw nodes location get --node <idOrNameOrIp>
openclaw nodes location get --node <idOrNameOrIp> --accuracy precise --max-age 15000 --location-timeout 10000

{
  "timeoutMs": 10000,
  "maxAgeMs": 15000,
  "desiredAccuracy": "coarse|balanced|precise"
}

{
  "lat": 48.20849,
  "lon": 16.37208,
  "accuracyMeters": 12.5,
  "altitudeMeters": 182.0,
  "speedMps": 0.0,
  "headingDeg": 270.0,
  "timestamp": "2026-01-03T12:34:56.000Z",
  "isPrecise": true,
  "source": "gps|wifi|cell|unknown"
}

Background behavior

주요 항목:

Android third-party builds accept background location.get only when the user selected Always and Android granted background location. The existing persistent node service adds the location service type and discloses Location: Always while active.
Android Play builds and While Using mode deny location.get while backgrounded.
Other node platforms may differ.

Linux node host

The bundled Linux Node plugin adds location.get to the CLI openclaw node service, including headless hosts without the Linux desktop app. Location defaults to off. Enable it under the plugin entry, then restart the node service:

{
  plugins: {
    entries: {
      "linux-node": {
        config: {
          location: { enabled: true },
        },
      },
    },
  },
}

Model/tooling integration

주요 항목:

Agent tool: the nodes tool's location_get action (node required).
CLI: openclaw nodes location get --node <id>.
Agent guidelines: only call when the user enabled location and understands the scope.

UX copy (suggested)

주요 항목:

Off: "Location sharing is disabled."
While Using: "Only when OpenClaw is open."
Always: "Allow requested location checks while OpenClaw is in the background."
Precise: "Use precise GPS location. Toggle off to share approximate location."

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/nodes/location-command
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

openclaw nodes location get --node <idOrNameOrIp>
openclaw nodes location get --node <idOrNameOrIp> --accuracy precise --max-age 15000 --location-timeout 10000

{
  "timeoutMs": 10000,
  "maxAgeMs": 15000,
  "desiredAccuracy": "coarse|balanced|precise"
}

{
  "lat": 48.20849,
  "lon": 16.37208,
  "accuracyMeters": 12.5,
  "altitudeMeters": 182.0,
  "speedMps": 0.0,
  "headingDeg": 270.0,
  "timestamp": "2026-01-03T12:34:56.000Z",
  "isPrecise": true,
  "source": "gps|wifi|cell|unknown"
}

{
  plugins: {
    entries: {
      "linux-node": {
        config: {
          location: { enabled: true },
        },
      },
    },
  },
}

Location command

핵심 요약

Location command for nodes, platform permission modes, and Linux GeoClue setup

한국어 가이드 범위: nodes/location-command 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

TL;DR
Why a selector (not just a switch)
Settings model
Permissions mapping (node.permissions)
Command: location.get
Background behavior
Linux node host
Model/tooling integration
UX copy (suggested)
관련 문서

상세 내용

TL;DR

주요 항목:

location.get is a node command, invoked via node.invoke or openclaw nodes location get.
Off by default.
Android third-party builds use a selector: Off / While Using / Always. Play builds remain Off / While Using.
Precise Location is a separate toggle.

Why a selector (not just a switch)

Settings model

주요 항목:

location.enabledMode: off | whileUsing | always
location.preciseEnabled: bool
Selecting whileUsing requests foreground permission.
Selecting always in the Android third-party build first requests foreground permission, explains the background access, then opens Android app settings for the separate Allow all the time grant.
Android Play builds do not declare background location permission or show always.
If the OS denies the requested level, the app reverts to the highest granted level and shows status.

Permissions mapping (node.permissions)

Optional. The macOS node reports location via the permissions map on node.list/node.describe; iOS/Android may omit it.

Command: location.get

Called via node.invoke, or the CLI helper:

주요 항목:

LOCATION_DISABLED: selector is off.
LOCATION_PERMISSION_REQUIRED: permission missing for requested mode.
LOCATION_BACKGROUND_UNAVAILABLE: app is backgrounded but only While Using is granted.
LOCATION_TIMEOUT: no fix in time.
LOCATION_UNAVAILABLE: system failure or no providers.

openclaw nodes location get --node <idOrNameOrIp>
openclaw nodes location get --node <idOrNameOrIp> --accuracy precise --max-age 15000 --location-timeout 10000

{
  "timeoutMs": 10000,
  "maxAgeMs": 15000,
  "desiredAccuracy": "coarse|balanced|precise"
}

{
  "lat": 48.20849,
  "lon": 16.37208,
  "accuracyMeters": 12.5,
  "altitudeMeters": 182.0,
  "speedMps": 0.0,
  "headingDeg": 270.0,
  "timestamp": "2026-01-03T12:34:56.000Z",
  "isPrecise": true,
  "source": "gps|wifi|cell|unknown"
}

Background behavior

주요 항목:

Android third-party builds accept background location.get only when the user selected Always and Android granted background location. The existing persistent node service adds the location service type and discloses Location: Always while active.
Android Play builds and While Using mode deny location.get while backgrounded.
Other node platforms may differ.

Linux node host

{
  plugins: {
    entries: {
      "linux-node": {
        config: {
          location: { enabled: true },
        },
      },
    },
  },
}

Model/tooling integration

주요 항목:

Agent tool: the nodes tool's location_get action (node required).
CLI: openclaw nodes location get --node <id>.
Agent guidelines: only call when the user enabled location and understands the scope.

UX copy (suggested)

주요 항목:

Off: "Location sharing is disabled."
While Using: "Only when OpenClaw is open."
Always: "Allow requested location checks while OpenClaw is in the background."
Precise: "Use precise GPS location. Toggle off to share approximate location."

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/nodes/location-command
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

openclaw nodes location get --node <idOrNameOrIp>
openclaw nodes location get --node <idOrNameOrIp> --accuracy precise --max-age 15000 --location-timeout 10000

{
  "timeoutMs": 10000,
  "maxAgeMs": 15000,
  "desiredAccuracy": "coarse|balanced|precise"
}

{
  "lat": 48.20849,
  "lon": 16.37208,
  "accuracyMeters": 12.5,
  "altitudeMeters": 182.0,
  "speedMps": 0.0,
  "headingDeg": 270.0,
  "timestamp": "2026-01-03T12:34:56.000Z",
  "isPrecise": true,
  "source": "gps|wifi|cell|unknown"
}

{
  plugins: {
    entries: {
      "linux-node": {
        config: {
          location: { enabled: true },
        },
      },
    },
  },
}

Location command

핵심 요약

문서 구성

상세 내용

TL;DR

Why a selector (not just a switch)

Settings model

Permissions mapping (node.permissions)

Command: location.get

Background behavior

Linux node host

Model/tooling integration

UX copy (suggested)

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드

Location command

핵심 요약

문서 구성

상세 내용

TL;DR

Why a selector (not just a switch)

Settings model

Permissions mapping (node.permissions)

Command: location.get

Background behavior

Linux node host

Model/tooling integration

UX copy (suggested)

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드