Vector机器人控制

技能简介

该技能通过Wirepod的本地HTTP API控制Vector机器人，支持在同一网络环境下完成移动、头部/升降台调节、语音播报、摄像头画面捕获以及巡逻/探索任务。

能做什么

• 远程控制Vector前进、后退、转向
• 调节头部角度和升降台高度
• 让Vector播报指定文本
• 捕获摄像头实时画面并保存为图片
• 执行确定性巡逻或随机探索路线
• 播放本地MP3/WAV音频文件

使用说明

安装前提：需在同一局域网部署Wirepod，并确保Vector已配对。从GitHub仓库获取技能文件后，无需额外依赖安装，直接使用内置Python脚本。

基础操作步骤：

1. 查找Vector序列号（ESN）：读取 /etc/wire-pod/wire-pod/jdocs/botSdkInfo.json
2. 获取控制权：
   python3 skills/vector-control/scripts/vector_control.py --serial <ESN> assume
3. 执行具体指令（移动、语音、摄像等）
4. 释放控制权：
   python3 skills/vector-control/scripts/vector_control.py --serial <ESN> release

常用指令示例：

• 移动：--move --lw 120 --rw 120 --time 1.0（左右轮速0-200，持续时间秒）
• 语音：--say --text "Hello"（建议语音后等待1-2秒再移动）
• 拍照：--snapshot --out /tmp/vector.mjpg，再用ffmpeg转JPEG
• 巡逻：--patrol --steps 6 --speed 140 --step-time 1.2 --turn-time 0.8
• 探索：--explore --steps 8
• 播放音频：--play --file /path/to/music.mp3（自动转为8kHz单声道WAV）

输入与输出

见下方输入与输出表格。

风险提示

• 必须先assume获取控制权，否则指令无效；异常时及时release
• 语音可能被运动或摄像头操作打断，建议语音后短暂停顿
• 高速移动可能导致机器人倾倒，建议使用短时间低速度指令
• 摄像头流为MJPG格式，需外部工具转换才能得静态图片
• 音频播放依赖网络稳定性，大文件可能延迟

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/dbeadle1/vector-control/SKILL.md
来源类型：开源社区技能