** AI 조력자가 몸. **

VectorClaw는 OpenClaw와 같은 AI 조수 도구로 Anki Vector Robot 기능을 노출하는 MCP 서버입니다 - 완전히 로컬, 클라우드없는 스택을 통해 실제 로봇 작업을 bridging.

---

건축

모든 통신은 **로컬 전용 ** — 실행 시간에 클라우드 의존도 없음 (Wire-Pod 설정 경로).

전체 신뢰 모델에 대한 보안 아키텍처를 참조하십시오.

---

내용 표

• 건축
• 현재 상태
• 퀵스타트
• MCP 클라이언트 구성
• 사용 가능한 도구
• 기여
• Docs 지도

---

현재 상태

v1.0.0 출시 · 2026-03-01

16 도구 확인 ✅ 하드웨어에 | 7 도구 실험 ⚠️

만약 제한:

• vector_drive_on_charger - Vector의 최근 보존 된 세계 모델에 있어야 충전기가 필요합니다. vector_scan를 호출하여 Dock을 시도하기 전에 충전기를 찾습니다. 충전기가 실수하지 않는 동안 충전은 로봇 동작없이 명령을 시작합니다.)

🤖 VectorClaw

---

Architecture

┌─────────────┐    stdio MCP    ┌──────────────────┐    gRPC/WiFi    ┌─────────┐
│  AI Agent   │ ─────────────── │  vectorclaw-mcp  │ ─────────────── │  Vector │
│  (OpenClaw) │                 │  (Python 3.11+)  │                 │  Robot  │
└─────────────┘                 └──────────────────┘                 └─────────┘

All communication is local-only — no cloud dependency at runtime (Wire-Pod setup path).

See Security Architecture for the full trust model.

---

Table of Contents

• Architecture
• Current Status
• Quickstart
• MCP Client Configuration
• Available Tools
• Contributing
• Docs Map

---

Current Status

v1.0.0 Released · 2026-03-01

16 tools verified ✅ on hardware | 7 tools experimental ⚠️

Known limitations:

• vector_drive_on_charger — requires the charger to be in Vector’s recently-observed world model; call vector_scan first to give Vector a chance to locate the charger before attempting to dock (observed: invoking while charger is unobserved causes the command to time out without any robot motion)
• Perception tools (vector_find_faces, vector_list_visible_faces, vector_face_detection, vector_list_visible_objects) — return empty results when vision modes are not active; vision modes are enabled automatically at connect but will be disabled for the remainder of the session after a vector_vision_reset call (reconnect to restore)
• Idle behaviors — Vector’s autonomous animations can overlap with commanded behaviors; use one-command-at-a-time sequencing and wait for completion before issuing the next command

See ROADMAP.md for the full milestone plan.

---

Quickstart

Requirements: Python 3.11+ · Wire-Pod running · Vector on local WiFi

For the complete walkthrough (Wire-Pod install, robot auth, WiFi config, troubleshooting) see docs/SETUP.md.