名称： vector-robot
描述： 通过 wire-pod 控制 Anki Vector 机器人。可通过 Vector 说话、查看其摄像头画面、移动头部/升降臂/轮子、更改眼睛颜色、触发动画。当用户提及 Vector 机器人、想通过机器人说话、控制实体机器人或与 wire-pod 交互时使用。

Vector 机器人控制

控制运行 wire-pod 的 Anki Vector 机器人。

前提条件

• 已刷入 escape pod 固件的 Anki Vector 机器人
• 正在运行的 wire-pod（https://github.com/kercre123/wire-pod）
• 用于语音输入的 OpenClaw 代理服务器（可选）

快速参考

所有 API 调用都需要 &serial=SERIAL 参数。默认序列号为 00501a68。

SERIAL="00501a68"
WIREPOD="http://127.0.0.1:8080"

语音输出

# 让 Vector 说话（文本需进行 URL 编码）
curl -s -X POST "$WIREPOD/api-sdk/assume_behavior_control?priority=high&serial=$SERIAL"
curl -s -X POST "$WIREPOD/api-sdk/say_text?text=Hello%20world&serial=$SERIAL"
curl -s -X POST "$WIREPOD/api-sdk/release_behavior_control?serial=$SERIAL"

或使用辅助脚本：scripts/vector-say.sh "Hello world"

摄像头

# 从 MJPEG 流中捕获一帧
timeout 2 curl -s "$WIREPOD/cam-stream?serial=$SERIAL" > /tmp/stream.mjpeg
# 使用 Python 提取 JPEG（参见 scripts/vector-see.sh）

运动控制

⚠️ 安全提示：在行为控制期间，悬崖传感器会被禁用。操作轮子时请务必小心！

# 头部：速度范围 -2 到 2
curl -s -X POST "$WIREPOD/api-sdk/move_head?speed=2&serial=$SERIAL"  # 向上
curl -s -X POST "$WIREPOD/api-sdk/move_head?speed=-2&serial=$SERIAL" # 向下
curl -s -X POST "$WIREPOD/api-sdk/move_head?speed=0&serial=$SERIAL"  # 停止

# 升降臂：速度范围 -2 到 2
curl -s -X POST "$WIREPOD/api-sdk/move_lift?speed=2&serial=$SERIAL"  # 上升
curl -s -X POST "$WIREPOD/api-sdk/move_lift?speed=-2&serial=$SERIAL" # 下降

# 轮子：左右轮速度范围 -200 到 200（请谨慎使用）
curl -s -X POST "$WIREPOD/api-sdk/move_wheels?lw=100&rw=100&serial=$SERIAL"  # 前进
curl -s -X POST "$WIREPOD/api-sdk/move_wheels?lw=-50&rw=50&serial=$SERIAL"   # 左转
curl -s -X POST "$WIREPOD/api-sdk/move_wheels?lw=0&rw=0&serial=$SERIAL"      # 停止

设置

# 音量：0-5
curl -s -X POST "$WIREPOD/api-sdk/volume?volume=5&serial=$SERIAL"

# 眼睛颜色：0-6
curl -s -X POST "$WIREPOD/api-sdk/eye_color?color=4&serial=$SERIAL"

# 电池状态
curl -s "$WIREPOD/api-sdk/get_battery?serial=$SERIAL"

动作/意图

curl -s -X POST "$WIREPOD/api-sdk/cloud_intent?intent=intent_imperative_dance&serial=$SERIAL"

可用意图：intent_imperative_dance、intent_system_sleep、intent_system_charger、intent_imperative_fetchcube、explore_start

语音输入（OpenClaw 集成）

要接收来自 Vector 的语音命令，请运行代理服务器：

node scripts/proxy-server.js

配置 wire-pod 知识图谱（访问 http://127.0.0.1:8080 → 服务器设置）：
- 提供商：自定义
- API 密钥：openclaw
- 端点：http://localhost:11435/v1
- 模型：openclaw

代理服务器会将接收到的提问写入 request.json。通过写入 response.json 来响应：

{"timestamp": 1234567890000, "answer": "你的回复内容"}

LaunchAgent（macOS 自动启动）

安装到 ~/Library/LaunchAgents/com.openclaw.vector-proxy.plist 以实现自动启动。详见 scripts/install-launchagent.sh。

API 参考

完整端点文档请参阅 references/api.md。