Vectorclaw MCP

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_look and vector_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_SERIAL environment variable set

Quick setup

1. Install package: pip install vectorclaw-mcp
2. Configure SDK: python3 -m anki_vector.configure
3. Export robot serial: export VECTOR_SERIAL=your-serial
4. 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