SwitchBot OpenAPI
官方API控制SwitchBot智能设备
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：SwitchBot OpenAPI。 它的用途是：官方API控制SwitchBot智能设备 完整的 Skill 内容见：https://321skill.com/skills/switchbot-openapi-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我关闭卧室的SwitchBot窗帘，并查看书房当前的温度'。AI会先调用SwitchBot OpenAPI发送关闭窗帘的指令，再查询书房温湿度传感器的状态，最后将结果回复给你。整个过程无需手动操作App。
介绍
SwitchBot OpenAPI 是一个基于官方 v1.1 接口的智能家居控制技能，让你能够通过自然语言指令直接查询和管理 SwitchBot 系列智能设备。它解决了在没有专用 App 或 Web 面板的情况下，快速开关灯、调节窗帘、查看温湿度传感器数据等日常操作需求，尤其适合需要将智能家居控制集成到 AI 助手工作流中的场景。
使用方式非常简单：你只需向 AI 助手说出类似“打开客厅的SwitchBot灯”或“查询卧室温度”的指令，AI 便会自动调用该技能，通过官方 API 向你的 SwitchBot 账号发送请求，并返回执行结果或状态数据。该技能支持列出所有设备、获取单个设备状态、发送控制命令（如开关、旋转、调节亮度等）以及查询设备历史记录。
适合已拥有 SwitchBot 智能家居设备并希望用 AI 替代手动操作的用户，尤其是智能家居发烧友、物联网开发者以及需要批量控制设备的场景。它也适合作为智能体开发者的基础工具，用于构建更复杂的家庭自动化流程。
使用前请确保已在 SwitchBot App 中获取 API Token 并绑定设备。该技能依赖网络连接，且每次操作均需通过官方服务器验证，因此响应速度受网络延迟影响。建议将常操作的设备命名清晰，以便 AI 准确识别。
核心特点
相比通过 Home Assistant 或第三方桥接器控制 SwitchBot 设备，本技能直接使用官方 OpenAPI，无需额外中间件，延迟更低、权限控制更精确，且完全遵循官方安全规范。
注意事项
无法控制未绑定到当前 SwitchBot 账号的设备，且不支持红外遥控类非智能设备。
常见问题
如何获取SwitchBot API Token？
在SwitchBot App中进入「设置」→「开发者选项」→「获取Token」，复制并保存即可。
支持哪些设备类型？
支持所有接入SwitchBot生态的智能设备，包括灯、窗帘、温湿度计、机器人、智能开关等。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/switchbot-openapi-x/raw/index.md 读取 SwitchBot OpenAPI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/switchbot-openapi-x/raw/index.md（查看排版版本）