一行命令让 AI 接管全屋智能:FeyaGate Skill 保姆级接入教程,小米/涂鸦/美的/易微联全搞定

摘要:在 AI Agent 生态爆发式生长的 2025 年,如何让 OpenClaw、Hermes 或 Claude Code 直接控制物理世界的智能设备,成了高阶开发者的“最后一道坎”。本文带你零基础部署 FeyaGate Skill——一个基于 MCP 协议的智能家居统一网关,一行命令安装,十分钟完成米家授权,让你的 AI 通过 JSON-RPC 2.0 轻松操控小米、涂鸦、美的、易微联四大平台设备,并实现摄像头 P2P 抓拍、AI 视觉分析、小爱 TTS 播报、触发自动化等进阶玩法。全文附详细代码示例,免费版即可覆盖 70% 家用场景。


目录

  1. 为什么 AI Agent 控制智能家居这么难
  2. FeyaGate Skill 是什么
  3. 技术架构与 MCP 工具清单
  4. 安装与启动:真·一行命令
  5. 平台授权配置(小米/涂鸦/美的/易微联)
  6. 实战一:用 AI 说人话控灯
  7. 实战二:摄像头 P2P 抓拍 + AI 安全分析
  8. 实战三:小爱音箱当 AI 的嘴替
  9. 实战四:触发引擎实现主动式自动化
  10. 技术亮点解析
  11. 许可证说明与免费版权益
  12. 总结与入门资源

一、为什么 AI Agent 控制智能家居这么难

如果你正用 OpenClawClaude CodeHermes 构建 Agent,大概率遇到过这个瓶颈:Agent 能写代码、能做推理,却打不开客厅的灯。

智能家居领域碎片化持续多年:小米用 MIOT 私有协议,涂鸦开发者平台版本割裂,美的依靠封闭云服务,易微联走 CoolKit……想让 Agent 调用设备?你得分别阅读四套 SDK 文档,为每个平台写适配层,再处理认证、轮询和异常。

这就是物理世界与 AI 之间的“协议鸿沟”。

FeyaGate Skill 用 MCP 标准把这道鸿沟填平了。

二、FeyaGate Skill 是什么

FeyaGate Skill 是一款运行在 桌面端(macOS / Linux / Windows)的智能家居 MCP 网关,原生支持 MCP(Model Context Protocol),通过 HTTP + JSON-RPC 2.0 协议为 AI Agent 暴露统一的多平台设备控制工具。

一句话:

一次部署,让 Agent 像调本地 API 一样操控小米、涂鸦、美的、易微联全屋设备。

核心特征:

  • 🧩 多平台统一抽象:底层适配四套完全不同 SDK,上层统一为 23+ 个 MCP 工具
  • 📹 摄像头 P2P 直连:不经过厂商云,延迟 < 500 ms,返回 base64 JPEG
  • 🤖 AI 视觉分析管道:定时抓拍 + 多模态模型推理,直接输出结构化结果
  • 🔊 小爱音箱全控制:TTS 播报、静默语音控制设备
  • 自动化引擎:Cron 定时任务 + 摄像头条件触发规则
  • 🆓 免费版白嫖小米全家桶:覆盖国内 70% 以上智能设备

三、技术架构与 MCP 工具清单

3.1 架构总览

AI Agent (Claude Code / OpenClaw / 自定义客户端)
        │
        │  MCP over HTTP (JSON-RPC 2.0)
        ▼
 miloco-mcp-server (桌面端 MCP 服务)
 localhost:38080/mcp/http
        │
   ┌────┼────┬────┬────┐
   ▼    ▼    ▼    ▼
 Xiaomi Tuya Midea eWeLink

MCP Server 内部使用策略模式封装 IDeviceProvider,对上层 Agent 完全透明。

3.2 核心 MCP 工具一览

跨平台基础工具(4 个):

工具名 功能
device/list 按平台、房间、类型筛选设备
device/specs 获取指定设备属性定义(siid/piid)
auth/platforms 查看各平台授权状态
gateway/info 网关版本、许可证信息

小米平台(16 个工具):
涵盖 OAuth 授权、MIOT 属性读写、摄像头 P2P 连接与抓拍、小爱 TTS/控制……

涂鸦 / 美的 / 易微联(各 4 个):
授权、设备刷新、属性读写统一封装。

自动化引擎(12 个工具):
Cron 定时任务、摄像头触发规则管理。

系统工具:
许可证管理、视觉 AI 配置、统计面板。

所有这些工具都通过统一的 JSON-RPC 2.0 接口暴露,只需在 MCP 客户端配置 URL 即可使用。

四、安装与启动:真·一行命令

4.1 一键在线安装

macOS / Linux:

curl -fsSL https://www.feyagate.com/install.sh | bash

Windows PowerShell:

iwr -useb https://www.feyagate.com/install.ps1 | iex

脚本会自动完成:

  1. 从 OTA 服务获取最新版本信息
  2. 克隆 feyagate-skill 仓库(含脚本与配置模板)
  3. 下载对应平台二进制包并校验 MD5
  4. 解压至 bin/lib/webui/
  5. 生成默认配置文件

指定安装路径: curl ... | bash -s -- --dir ~/my-skill

4.2 启动服务

cd feyagate-skill
bash scripts/start.sh
bash scripts/health_check.sh   # 输出 "OK" 即启动成功

服务默认监听 http://localhost:38080/mcp/http,可通过 --port 指定其他端口。

五、平台授权配置

5.1 米家账号授权(必须)

python3 scripts/auth.py
  1. 控制台输出 OAuth 授权链接
  2. 浏览器打开链接,登录小米账号
  3. 登录成功后跳转至 https://127.0.0.1/?code=xxxxxx
  4. 复制完整 URL 粘贴回终端,回车完成

验证授权:
调用 xiaomi/auth_status,返回 authorized: true 即成功。

5.2 涂鸦平台(扫码授权)

通过 MCP 工具获取二维码:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "auth/tuya_qr",
    "arguments": {}
  }
}

用涂鸦智能 App 扫码,再轮询 auth/tuya_qr_status 确认授权。

5.3 美的 / 易微联

使用 auth/midea_loginauth/ewelink_login,传入账号密码即可完成绑定。

六、实战一:用 AI 说人话控灯

搭配 Claude Code 等 MCP 客户端,只需自然语言指令:

“打开客厅的灯,调成暖色,亮度 50%”

Agent 内部自动执行序列:

  1. 调用 device/list 获取设备列表并筛选“客厅灯”
  2. 调用 device/specs 获取亮度(siid=2, piid=2)和色温(siid=2, piid=3)属性定义
  3. 调用 set_xiaomi_device_property 设置电源(siid=2, piid=1, value=true)
  4. 调用 set_xiaomi_device_property 调整亮度和色温

全程无需手动查询 did、siid、piid,Agent 自动适配。

七、实战二:摄像头 P2P 抓拍 + AI 安全分析

7.1 连接摄像头

curl -X POST http://localhost:38080/mcp/http \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"tools/call",
    "params":{
      "name":"xiaomi/camera_connect",
      "arguments":{
        "camera_id":"YOUR_CAMERA_DID"
      }
    }
  }'

P2P 穿透需等待 3~5 秒,完成后抓拍:

curl -X POST http://localhost:38080/mcp/http \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "id":2,
    "method":"tools/call",
    "params":{
      "name":"xiaomi/camera_snapshot",
      "arguments":{
        "camera_id":"YOUR_CAMERA_DID",
        "count":1
      }
    }
  }'

返回 JSON 中包含 base64 字段,可直接传给 GPT-4V、Claude 等多模态模型。

7.2 定时 AI 巡检

内置脚本实现自动化管道:

python3 scripts/scheduled_analysis.py \
  --camera-id YOUR_CAMERA_DID \
  --interval 300 \
  --auto-connect \
  --prompt "Describe the scene. Flag any security concerns."

每 300 秒抓拍 → 调用多模态推理 → 输出结构化告警。可作为家庭安防的核心组件。

八、实战三:小爱音箱当 AI 的嘴替

TTS 语音播报

{
  "jsonrpc":"2.0",
  "id":3,
  "method":"tools/call",
  "params":{
    "name":"xiaoai/tts",
    "arguments":{
      "device_id":"SPEAKER_DID",
      "text":"欢迎回家,已为您打开客厅灯和空调"
    }
  }
}

静默控制(音箱不发声)

{
  "jsonrpc":"2.0",
  "id":4,
  "method":"tools/call",
  "params":{
    "name":"xiaoai/control",
    "arguments":{
      "device_id":"SPEAKER_DID",
      "command":"打开客厅灯",
      "silence":true
    }
  }
}

结合 Agent 的场景感知,可实现回家自动播报 + 静默执行全屋场景。

九、实战四:触发引擎实现主动式自动化

通过 trigger/create 工具定义规则,示例:摄像头检测到人 → 开灯 + TTS。

{
  "name": "客厅有人检测",
  "cameras": ["CAMERA_DID"],
  "condition": "vision_ai_detects_person",
  "actions": [
    {
      "tool": "set_xiaomi_device_property",
      "args": {
        "deviceId": "LAMP_DID",
        "siid": 2,
        "piid": 1,
        "value": true
      }
    },
    {
      "tool": "xiaoai/tts",
      "args": {
        "device_id": "SPEAKER_DID",
        "text": "客厅有人"
      }
    }
  ]
}

触发引擎支持多个摄像头与条件组合,完全可编程。

十、技术亮点解析

  1. MCP 原生,即插即用
    Anthropic 发布的 Model Context Protocol 已成为 AI 工具调用的事实标准。FeyaGate Skill 直接实现了 MCP 服务端,Claude Code、OpenClaw 配置 URL 后立即获得设备控制能力,无需额外 SDK。

  2. 跨平台统一抽象
    基于 IDeviceProvider 策略模式,将小米 MIOT、涂鸦 OpenAPI、美的云、易微联 CoolKit 全部封装为同一套工具集。上层 Agent 完全无需感知平台差异。

  3. 摄像头 P2P 直连
    采用 P2P 协议穿透,不经过小米云端服务器,既保护隐私又降低延迟(< 500ms),返回 base64 编码可直接入模推理。

  4. 全平台二进制交付
    macOS (Intel/Apple Silicon)、Linux x86_64、Windows x64 均提供原生二进制,无需依赖 Docker 或 Python 环境。

十一、许可证说明与免费版权益

版本 支持平台 核心功能
免费版 小米全生态 设备控制、摄像头 P2P、小爱音箱、MCP 代理、自动化引擎
付费版 小米 + 涂鸦 + 美的 + 易微联 全部工具

免费版已包含自动化规则、定时任务、视觉分析等进阶能力,足以覆盖绝大多数以米家为中心的智能家居场景。

十二、总结与入门资源

FeyaGate Skill 解决了 AI Agent 进入物理世界的“最后一公里”问题:用 MCP 统一了碎片化的智能家居协议,让开发者只需关注业务逻辑,而非平台适配。

快速开始

# 安装
curl -fsSL https://www.feyagate.com/install.sh | bash

# 启动
cd feyagate-skill
bash scripts/start.sh

# 米家授权
python3 scripts/auth.py

相关链接


如果本文帮你节省了对接四大平台的时间,欢迎点赞、收藏、关注三连。评论区留下你的智能家居场景,我会挑选高赞需求输出更多实战教程。@TOC

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐