位置情報コマンド

# 要約

• location.get はノードコマンドです（node.invoke 経由）。
• デフォルトではオフです。
• Android アプリ設定ではセレクターを使います: オフ / 使用中のみ。
• 別のトグル: 正確な位置情報。

# セレクターを使う理由（単なるスイッチではない理由）

OS の権限は複数レベルです。アプリ内でセレクターを表示できますが、実際の許可は引き続き OS が決定します。

• iOS/macOS では、システムプロンプト/設定に 使用中のみ または 常に許可 が表示される場合があります。
• Android アプリは現在、フォアグラウンドの位置情報のみをサポートしています。
• 正確な位置情報は別の許可です（iOS 14+ の「正確」、Android の「fine」と「coarse」）。

UI のセレクターは要求モードを制御します。実際の許可は OS 設定にあります。

# 設定モデル

ノードデバイスごと:

• location.enabledMode: off | whileUsing
• location.preciseEnabled: bool

UI の動作:

• whileUsing を選択すると、フォアグラウンド権限を要求します。
• OS が要求レベルを拒否した場合は、許可済みの最上位レベルに戻し、ステータスを表示します。

# 権限マッピング（node.permissions）

任意です。macOS ノードは権限マップ経由で location を報告します。iOS/Android では省略される場合があります。

# コマンド: location.get

node.invoke 経由で呼び出します。

パラメーター（推奨）:

{
  "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"
}

エラー（安定コード）:

• LOCATION_DISABLED: セレクターがオフです。
• LOCATION_PERMISSION_REQUIRED: 要求モードに必要な権限がありません。
• LOCATION_BACKGROUND_UNAVAILABLE: アプリがバックグラウンドにありますが、使用中のみが許可されています。
• LOCATION_TIMEOUT: 時間内に位置を取得できませんでした。
• LOCATION_UNAVAILABLE: システム障害 / プロバイダーがありません。

# バックグラウンド動作

• Android アプリは、バックグラウンド中の location.get を拒否します。
• Android で位置情報を要求するときは、OpenClaw を開いたままにしてください。
• 他のノードプラットフォームでは異なる場合があります。

# モデル/ツール統合

• ツールサーフェス: nodes ツールは location_get アクションを追加します（ノードが必須）。
• CLI: openclaw nodes location get --node <id>。
• エージェントガイドライン: ユーザーが位置情報を有効にしており、そのスコープを理解している場合にのみ呼び出します。

# UX コピー（推奨）

• オフ: 「位置情報共有は無効です。」
• 使用中のみ: 「OpenClaw が開いているときのみ。」
• 正確: 「正確な GPS 位置情報を使用します。おおよその位置情報を共有するにはトグルをオフにします。」

# 関連

• チャンネル位置情報の解析
• カメラキャプチャ
• トークモード