雷达防撞预警 Skill

配置

在

~/.openclaw/workspace/TOOLS.md

中添加树莓派的 IP 地址：

### 雷达预警
- 树莓派 IP: <你的树莓派IP>
- rosbridge 端口: 8080（默认）

或通过环境变量传入：

export RADAR_HOST=192.168.137.100  # 树莓派 IP
export RADAR_PORT=8080             # rosbridge 端口（默认）

架构概览

OpenClaw (本机)
  └── skill: call_radar_service.js
        └── rosbridge WebSocket (ws://<树莓派IP>:8080)
              └── 树莓派 rosbridge_server
                    └── ROS2 Service: /radar_collision_warning (std_srvs/Trigger)
                          └── radar_collision_warning_node
                                └── 订阅 /scan (LaserScan) ← 乐动激光雷达

rosbridge WebSocket 端口:

8080

ROS2 Service 名称:

/radar_collision_warning

碰撞阈值: 默认 0.05m（5cm），调用时可用

-t/--threshold

覆盖

使用方式

依赖: Node.js 18+（

globalThis.WebSocket

为内置，无需安装任何包）

单次查询

当用户说"雷达防撞预警"、"检查障碍物距离"、"开启雷达监控"时，调用：

node ~/.openclaw/workspace/skills/radar-collision-warning/scripts/call_radar_service.js

可加参数覆盖阈值（单位：米）：

node ~/.openclaw/workspace/skills/radar-collision-warning/scripts/call_radar_service.js --threshold 0.10

持续监控模式

当用户要求"持续监控"、"实时雷达监控"时，在 后台 启动轮询：

node ~/.openclaw/workspace/skills/radar-collision-warning/scripts/call_radar_service.js --monitor --interval 2.0

使用

exec

工具的

background:true

模式运行，后台运行时按 Ctrl+C 或发信号停止。

返回格式（JSON stdout）

{
  "success": true,
  "distance_m": 0.032,
  "distance_cm": 3.2,
  "warning": true,
  "message": "⚠️ 碰撞危险！距离仅 3.2cm",
  "threshold_m": 0.05
}

或安全状态：

{
  "success": true,
  "distance_m": 1.234,
  "distance_cm": 123.4,
  "warning": false,
  "message": "✅ 安全，最近障碍物距离 1.23m",
  "threshold_m": 0.05
}

连接失败时：

{
  "success": false,
  "error": "无法连接到 rosbridge 服务器",
  "message": "⚠️ 雷达服务不可用，请检查树莓派是否开机"
}

树莓派侧准备（首次配置时参考）

1. 安装 rosbridge

sudo apt install ros-jazzy-rosbridge-suite

2. ROS2 包配置

在树莓派上创建雷达预警包：

cd ~/ros_ws/src
ros2 pkg create radar_pkg --build-type ament_python
# 将 radar_collision_warning_node.py 复制到:
#   ~/ros_ws/src/radar_pkg/radar_pkg/
# 添加 setup.py 入口点:
#   'radar_collision_warning_node = radar_pkg.radar_collision_warning_node:main'
cd ~/ros_ws && colcon build && source install/setup.bash

3. 一键启动

bash ~/ros_ws/start_radar_rosbridge.sh

返回值解读

• warning: true

  → 距离 < 阈值，应提醒用户"注意防撞"

• warning: false

  → 距离正常

• success: false

  → 连接失败或服务异常