dvcrn VectorClaw MCP
VectorClaw connects OpenClaw to an Anki / Digital Dream Labs Vector robot through MCP. It provides practical robot control primitives for speech, movement, camera capture, and status/sensor reads.
What you can do
- Speak text with
vector_say - Move and position with
vector_drive,vector_head,vector_lift - Capture camera images with
vector_lookandvector_capture_image - Read robot state with
vector_status,vector_pose,vector_proximity_status,vector_touch_status - Build look → reason → act workflows
Vision requirement for look → reason → act
For see → reason → act workflows, the agent must either be vision-capable itself (e.g., a VLM) or have access to a separate vision model/image-interpretation tool to analyze camera images before choosing actions.
Requirements
- Vector robot configured and reachable
- Wire-Pod running
- SDK configured at
~/.anki_vector/sdk_config.ini VECTOR_SERIALenvironment variable set
Quick setup
- Install package:
pip install vectorclaw-mcp - Configure SDK:
python3 -m anki_vector.configure - Export robot serial:
export VECTOR_SERIAL=your-serial - Add MCP server:
{
"mcpServers": {
"vectorclaw": {
"command": "python3",
"args": ["-m", "vectorclaw_mcp.server"],
"env": { "VECTOR_SERIAL": "${VECTOR_SERIAL}" }
}
}
}
Tool coverage
Hardware-verified core tools
vector_say, vector_drive_off_charger, vector_drive, vector_emergency_stop, vector_head, vector_lift, vector_look, vector_capture_image, vector_face, vector_scan, vector_vision_reset, vector_pose, vector_status, vector_charger_status, vector_touch_status, vector_proximity_status
Experimental tools
vector_animate, vector_drive_on_charger, vector_find_faces, vector_list_visible_faces, vector_face_detection, vector_list_visible_objects, vector_cube
Current limitations
- Charger return (
vector_drive_on_charger) is currently unreliable - Face/object detection is currently inconsistent
- Visual interpretation requires the vision capability described above
Documentation
- MCP API:
docs/MCP_API_REFERENCE.md - SDK Reference:
docs/VECTOR_SDK_REFERENCE.md - Hardware log:
docs/HARDWARE_SMOKE_LOG.md - Repo: https://github.com/danmartinez78/VectorClaw