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

潘祖记2026-05-06 8:26

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

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

如果你正用 OpenClaw 、Claude Code 或 Hermes 构建 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：

bash 复制代码 
curl -fsSL https://www.feyagate.com/install.sh | bash

Windows PowerShell：

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 启动服务

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

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

五、平台授权配置

5.1 米家账号授权（必须）

bash 复制代码 
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 工具获取二维码：

json 复制代码 
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "auth/tuya_qr",
    "arguments": {}
  }
}

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

5.3 美的 / 易微联

使用 auth/midea_login 或 auth/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 连接摄像头

bash 复制代码 
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 秒，完成后抓拍：

bash 复制代码 
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 巡检

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

bash 复制代码 
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 语音播报

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

静默控制（音箱不发声）

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

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

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

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

json 复制代码 
{
  "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 统一了碎片化的智能家居协议，让开发者只需关注业务逻辑，而非平台适配。

快速开始

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

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

# 米家授权
python3 scripts/auth.py

相关链接

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

欢迎使用Markdown编辑器

你好！ 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。

新的改变

我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：

  1. 全新的界面设计 ，将会带来全新的写作体验；
  2. 在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
  3. 增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
  4. 全新的 KaTeX数学公式 语法；
  5. 增加了支持甘特图的mermaid语法[1](#甘特图的mermaid语法1) 功能；
  6. 增加了 多屏幕编辑 Markdown文章功能；
  7. 增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
  8. 增加了 检查列表 功能。

功能快捷键

撤销：Ctrl/Command + Z

重做：Ctrl/Command + Y

加粗：Ctrl/Command + B

斜体：Ctrl/Command + I

标题：Ctrl/Command + Shift + H

无序列表：Ctrl/Command + Shift + U

有序列表：Ctrl/Command + Shift + O

检查列表：Ctrl/Command + Shift + C

插入代码：Ctrl/Command + Shift + K

插入链接：Ctrl/Command + Shift + L

插入图片：Ctrl/Command + Shift + G

查找：Ctrl/Command + F

替换：Ctrl/Command + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。

输入2次#，并按下space后，将生成2级标题。

以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

删除文本

引用文本

H2O is是液体。

210 运算结果是 1024.

插入链接与图片

链接: link.

图片:

带尺寸的图片:

居中的图片:

居中并且带尺寸的图片:

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.

javascript 复制代码 
// An highlighted block
var foo = 'bar';

生成一个适合你的列表

  • 项目
    • 项目
      • 项目
  1. 项目1
  2. 项目2
  3. 项目3
  • 计划任务
  • 完成任务

创建一个表格

一个简单的表格是这么创建的：

项目 Value
电脑 $1600
手机 $12
导管 $1

设定内容居中、居左、居右

使用:---------:居中

使用:----------居左

使用----------:居右

第一列 第二列 第三列
第一列文本居中 第二列文本居右 第三列文本居左

SmartyPants

SmartyPants 是一个文本转换工具，主要功能是将普通的 ASCII 标点符号自动转换为更美观的印刷体标点符号。例如：

原始符号 转换后 说明
"引号" "引号" 直引号变弯引号
'单引号' '单引号' 直单引号变弯单引号
-- -- 两个连字符变短破折号
--- --- 三个连字符变长破折号
... ... 三个点变省略号

创建一个自定义列表

:
Text-to- conversion tool
:
John
:
Luke

如何创建一个注脚

一个具有注脚的文本。[2](#2)

注释也是必不可少的

Markdown将文本转换为 。

KaTeX数学公式

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示 Γ ( n ) = ( n − 1 ) ! ∀ n ∈ N \Gamma(n) = (n-1)!\quad\forall n\in\mathbb N Γ(n)=(n−1)!∀n∈N 是通过欧拉积分

Γ ( z ) = ∫ 0 ∞ t z − 1 e − t d t   . \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. Γ(z)=∫0∞tz−1e−tdt.

你可以找到更多关于的信息 LaTeX 数学表达式here.

新的甘特图功能，丰富你的文章

2014-01-07 2014-01-09 2014-01-11 2014-01-13 2014-01-15 2014-01-17 2014-01-19 2014-01-21 已完成 进行中 计划一 计划二 现有任务 Adding GANTT diagram functionality to mermaid

  • 关于 甘特图 语法，参考 这儿,

UML图表

可以使用UML图表进行渲染，例如下面产生的一个序列图：
王五 李四 张三 王五 李四 张三 李四想了很长时间, 文字太长了 不适合放在一行. 你好！李四, 最近怎么样? 你最近怎么样，王五？ 我很好，谢谢! 我很好，谢谢! 打量着王五... 很好... 王五, 你怎么样?

  • 关于 UML图表 语法，参考 这儿,

流程图

链接
长方形
圆
圆角长方形
菱形

  • 关于 Mermaid 语法，参考 这儿,

FLowchart流程图

我们依旧会支持flowchart.js的流程图语法：
Created with Raphaël 2.3.0 开始 我的操作 确认？ 结束 yes no

  • 关于 Flowchart流程图 语法，参考 这儿.

导出与导入

导出

如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ，生成一个.md文件或者.html文件进行本地保存。

导入

如果你想加载一篇你写过的.md文件，在上方工具栏可以选择导入功能进行对应扩展名的文件导入，

继续你的创作。

  1. mermaid语法说明 ↩︎

  2. 注脚的解释 ↩︎

*[HTML]: 超文本标记语言

相关推荐
joshchen2153 小时前
强化学习基础（赵世钰）第二章 贝尔曼方程
人工智能·python·机器学习·强化学习
魔术师Grace3 小时前
普通人学 AI，不要一上来就学提示词
前端·人工智能·程序员
数字化转型20253 小时前
10年之后的未来：AI + 机器人成为主要价值创造者
人工智能
ZhengEnCi3 小时前
01d-前馈神经网络代码实现 💻
人工智能·深度学习·神经网络
冬奇Lab3 小时前
一天一个开源项目（第93篇）：Symphony - OpenAI 官方定义的 AI 代理编排规范
人工智能·openai·agent
雷帝木木3 小时前
Python 中的配置文件管理：从基础到高级应用
人工智能·python·深度学习·机器学习
小龙报3 小时前
【必装软件】python及pycharm的安装与环境配置
开发语言·人工智能·python·语言模型·自然语言处理·pycharm·语音识别
雷帝木木3 小时前
Python元编程高级技巧：深入理解代码生成与动态行为
人工智能·python·深度学习·机器学习
草莓熊Lotso3 小时前
Python 入门必吃透：函数、列表与元组核心用法（附实战案例）
大数据·服务器·开发语言·c++·人工智能·python·qt
热门推荐
01要裂开了！ChatGPT要手机号验证了？注册Codex要求验证电话号码怎么办？2026年登陆Codex要手机号验证的解决办法02GitHub 镜像站点03Codex 接入 DeepSeek API 完整配置文档04零基础教你claude code 接入 deepseek V405【AI】2026 年具身智能模型和世界模型总结06裂开！ChatGPT 居然开始要手机号验证，附详细解决方法07Linux 核弹级高危漏洞 CVE-2026-31431 完整修复指南08CVE-2026-31431 (Copy Fail) 漏洞复现与验证记录09几个好用的ip纯净度检测网站102026年AI前瞻：量子AI、具身智能与科学发现的新纪元