danmartinez78/vectorclaw

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

21 stars 4 forks 质量 80 趋势 24MIT

Repository Install

通过MCP实现Anki Vector + OpenClaw集成。给你的AI助手一个身体。MCP服务器连接Anki矢量机器人和OpenClaw。你的助手，现在带轮子了。

概览

VectorClaw 是一个 MCP 服务器，将 Anki Vector 机器人功能展示为 OpenClaw 等 AI 助手的工具——通过完全本地、无云的栈将自然语言与现实机器人动作连接起来。所有通信都是——运行时不依赖云（Wire-Pod 设置路径）。完整信任模型请参见安全架构。 - vector_drive_on_charger — 要求充电器位于Vector最近观察到的世界模型中;先呼叫vector_scan，给Vector机会定位充电器再尝试对接（观察：充电器未被观察时调用会使命令超时，机器人无动作）- 感知工具（vector_find_faces、vector_list_visible_faces、vector_face_detection、vector_list_visible_objects）——视觉模式未激活时返回空结果;视觉模式在连接时自动启用，但在vector_vision_reset调用后（重新连接以恢复）后会话剩余时间内关闭。- 空闲行为 — Vector的......

概述（AI 翻译）

给你的AI助手一个身体。

VectorClaw 是一个 MCP 服务器，将 Anki Vector 机器人功能展示为 OpenClaw 等 AI 助手的工具——通过完全本地、无云的栈将自然语言与现实机器人动作连接起来。

建筑

所有通信都是仅本地——运行时不依赖云（Wire-Pod设置路径）。

完整信任模型请参见安全架构。

当前状态

v1.0.0 发布 ·2026-03-01

16个工具已✅验证在硬件上 |7个实验⚠️工具

已知限制：

vector_drive_on_charger — 要求充电器位于矢量最近观测到的世界模型中;先呼叫vector_scan，让矢量有机会找到充电器，然后再尝试对接（观察：在充电器未被观察时调用，命令会超时，且机器人没有任何动作）

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

🤖 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.

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.

在 GitHub 查看完整 README

安装

uvx vectorclaw-mcp

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "vectorclaw": {
      "command": "uvx",
      "args": ["vectorclaw-mcp"],
      "env": {
        "VECTOR_SERIAL": "your-serial-here"
      }
    }
  }
}