SwitchBot OpenAPI

通过官方OpenAPI控制与查询SwitchBot智能家居设备。

其他 智能家居爱好者全栈开发 控制智能家居设备 通用 ★ 2.8k 更新于 2026-08-01

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:SwitchBot OpenAPI。
它的用途是:通过官方OpenAPI控制与查询SwitchBot智能家居设备。
完整的 Skill 内容见:https://321skill.com/skills/switchbot-openapi-x-8/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我把客厅的空调调到26度”,它会通过SwitchBot API向你的空调设备发送设置温度的命令。或者说:“检查一下所有房间的灯是否都关了”,它会查询并返回各个智能开关的当前状态。

介绍

这个Skill为SwitchBot智能家居设备提供了官方OpenAPI(v1.1)的调用能力。它解决了用户需要通过AI助手直接管理SwitchBot设备的需求,例如开关灯、调节温度或查询设备状态,而无需手动操作手机App或编写代码。

使用时,用户只需在对话中提出控制或查询指令,例如“打开卧室的灯”或“客厅的温湿度是多少?”,Skill便会调用相应的API来执行操作或获取信息。整个过程在对话中完成,实现了语音或文本对智能家居的自然控制。

它非常适合拥有SwitchBot设备的智能家居爱好者、希望简化设备操作流程的家庭用户,以及需要将智能家居控制集成到自动化流程中的开发者。对于追求高效、便捷生活方式的用户来说,这是一个实用的工具。

使用前,请确保你已在SwitchBot官方App中生成并妥善保管好Open Token和Secret Key,并在Skill中正确配置。请注意,该Skill依赖于SwitchBot的官方API服务,其可用性和功能范围受官方限制。

核心特点

这是基于SwitchBot官方OpenAPI(v1.1)开发的Skill,确保了与设备通信的稳定性和功能完整性,不同于可能依赖非官方逆向工程或模拟操作的解决方案。

注意事项

仅支持SwitchBot官方OpenAPI已覆盖的设备型号和功能,无法控制非SwitchBot品牌或其他未接入API的智能家居设备。

常见问题

如何获取SwitchBot的Open Token和Secret Key?

需要在SwitchBot官方手机App中,进入“我的”->“偏好设置”->“开发者选项”中生成。

支持控制哪些SwitchBot设备?

支持官方OpenAPI文档中列出的设备,如智能开关、窗帘机器人、温湿度计、扫地机器人等,具体请查阅官方文档。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/switchbot-openapi-x-8/raw/index.md 读取 SwitchBot OpenAPI 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。