位置命令
Location Command（位置命令）让 Agent 获得地理位置感知能力。通过移动节点的 GPS 数据，Agent 可以根据用户位置提供上下文相关的响应。
位置数据来源
位置数据主要来自 Mobile Node（移动节点）：
| 来源 | 精度 | 功耗 |
|---|---|---|
| GPS | ~3m | 高 |
| Wi-Fi 定位 | ~15m | 低 |
| 基站定位 | ~100m | 极低 |
| 融合定位 | ~5m | 中（推荐） |
yaml
location:
source: fused # gps / wifi / cell / fused
update_interval: 60 # 位置更新间隔（秒）
min_accuracy: 50 # 最小精度要求（米）融合定位
fused 模式结合 GPS、Wi-Fi 和基站数据，在精度和功耗之间取得最佳平衡，适合大多数场景。
获取当前位置
Agent 可以通过内置工具获取用户当前位置：
用户：我附近有什么好吃的？
Agent：[调用 get_location 工具]
你当前位于北京市朝阳区三里屯附近。
推荐以下餐厅：
1. 大董烤鸭 - 步行 5 分钟
2. 海底捞火锅 - 步行 8 分钟
...位置数据格式
json
{
"latitude": 39.9332,
"longitude": 116.4543,
"accuracy": 8.5,
"altitude": 45.2,
"speed": 0,
"heading": null,
"timestamp": "2026-03-05T10:30:00Z",
"address": {
"country": "中国",
"province": "北京市",
"city": "北京市",
"district": "朝阳区",
"street": "三里屯路"
}
}地理围栏（Geofencing）
Geofencing（地理围栏）允许你定义地理区域，当设备进入或离开该区域时触发 Agent 动作。
配置围栏
yaml
location:
geofences:
- name: home
latitude: 39.9042
longitude: 116.4074
radius: 200 # 半径（米）
on_enter: "我到家了"
on_exit: "我出门了"
- name: office
latitude: 39.9155
longitude: 116.4046
radius: 100
on_enter: "到公司了，帮我查看今天的日程"围栏事件
| 事件 | 触发条件 | 用途 |
|---|---|---|
on_enter | 设备进入围栏区域 | 到达提醒、自动打卡 |
on_exit | 设备离开围栏区域 | 离开提醒、关灯指令 |
on_dwell | 在围栏内停留超过指定时间 | 久坐提醒 |
yaml
location:
geofences:
- name: gym
latitude: 39.9100
longitude: 116.4100
radius: 50
on_dwell:
duration: 3600 # 停留 1 小时后触发
message: "你已经在健身房锻炼了 1 小时，记得补充水分！"位置感知响应
Agent 可以根据位置上下文调整回答：
yaml
location:
context:
enabled: true
include_address: true # 包含地址信息
include_weather: true # 包含当地天气
include_timezone: true # 包含时区信息模型上下文
开启后，Agent 的系统提示词会自动附加用户当前位置信息，使 Agent 能给出更贴合场景的回答。
隐私设置
位置隐私
位置数据属于高度敏感信息，必须做好隐私保护。
yaml
location:
privacy:
precision: reduced # full / reduced / city
share_with_agent: true # 是否分享给 Agent
log_history: false # 是否记录历史轨迹
require_consent: true # 每次获取位置前需要用户确认精度级别说明：
| 级别 | 精度 | 适用场景 |
|---|---|---|
full | 完整坐标 | 导航、精确推荐 |
reduced | ~1km | 天气、区域推荐 |
city | 城市级 | 新闻、大范围推荐 |
常用命令
bash
# 查看节点当前位置
openclaw node location
# 列出所有地理围栏
openclaw node location --list-fences
# 测试地理围栏触发
openclaw node location --test-fence home使用场景
| 场景 | 配置建议 |
|---|---|
| 附近餐厅推荐 | fused 定位 + full 精度 |
| 到家自动关灯 | geofence + on_enter |
| 出差行程提醒 | 城市级精度 + 天气上下文 |
| 跑步路线记录 | GPS 定位 + 高频更新 |
🇨🇳 中国用户须知
- 地图服务：国内 GPS 坐标存在 GCJ-02 偏移，OpenClaw 会自动处理坐标纠偏
- 逆地理编码：推荐使用高德地图或百度地图 API 进行地址解析，国内精度更高
- 隐私合规：根据《个人信息保护法》，位置数据属于敏感个人信息，建议开启
require_consent