Vector机器人控制 · vector-control

技能简介

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

业务背景

仓储巡检、展厅导览等场景需低成本自动化机器人方案。该技能通过本地网络直接操控Vector机器人，无需云端依赖即可执行移动巡逻、语音播报、环境拍摄等任务，适合对数据隐私敏感或网络条件受限的室内场所，提升现场管理智能化水平。

落地案例：某科技展厅部署Vector作为智能向导，工作人员在同一局域网内通过Wirepod发送指令：让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
来源类型：开源社区技能