SwitchBot OpenAPI
用AI控制SwitchBot智能家居设备
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：SwitchBot OpenAPI。 它的用途是：用AI控制SwitchBot智能家居设备 完整的 Skill 内容见：https://321skill.com/skills/switchbot-openapi-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
「帮我打开客厅的灯，并把卧室窗帘拉开一半。」AI会调用SwitchBot OpenAPI，先查询客厅灯的设备ID，发送开灯指令；再查询卧室窗帘设备，发送调节到50%的命令。执行完成后回复「客厅灯已打开，卧室窗帘已拉开一半」。
介绍
SwitchBot OpenAPI 让 AI 助手直接接管你的智能家居设备，无需一次次打开手机 App。通过调用 SwitchBot 官方提供的 OpenAPI v1.1，你可以让 AI 实时查询设备状态（如温度、湿度、电量）、发送控制指令（开关灯、调节窗帘、启动机器人）、甚至执行场景联动。
使用非常简单：安装该 Skill 后，在对话中直接说出自然语言指令即可。例如「打开客厅灯」「查看卧室温度」「关闭所有窗帘」「把空调调到 26 度」。AI 会自动识别设备名称与动作，构造 API 请求并执行，执行结果会以文字反馈给你。
适合拥有 SwitchBot 设备的智能家居用户、希望将智能家居集成到 AI 工作流中的开发者，以及需要批量管理多个设备的后端工程师。无需编程基础，安装后即可语音或文字控制。
建议先获取 API Token（可在 SwitchBot App 的「开发者选项」中生成），并确保网络稳定。注意 API 存在调用频率限制，频繁操作可能触发限流。另外请妥善保管 Token，避免泄露导致他人控制你的设备。
核心特点
与通用智能家居 Skill 不同，SwitchBot OpenAPI 专为 SwitchBot 品牌设计，使用官方 API 接口，支持所有设备类型（灯、窗帘、传感器、机器人等），并获取实时状态反馈，而非模拟控制。
注意事项
仅支持 SwitchBot 品牌设备，且需要用户自行申请并配置 API Token。
常见问题
如何获取 SwitchBot API Token？
在 SwitchBot App 中进入「设置」→「开发者选项」，点击「获取 Token」即可生成，注意保存好。若忘记可重新生成，但旧 Token 会失效。
支持哪些设备？
支持所有 SwitchBot 设备，包括智能灯、窗帘、温度传感器、湿度传感器、机器人扫地机、加湿器、无线开关等。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/switchbot-openapi-x-2/raw/index.md 读取 SwitchBot OpenAPI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/switchbot-openapi-x-2/raw/index.md（查看排版版本）