SwitchBot OpenAPI
通过官方OpenAPI控制与查询SwitchBot智能家居设备。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：SwitchBot OpenAPI。 它的用途是：通过官方OpenAPI控制与查询SwitchBot智能家居设备。 完整的 Skill 内容见：https://321skill.com/skills/switchbot-openapi-x-6/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我把客厅的灯打开，然后检查一下卧室的温湿度。’，它会通过SwitchBot OpenAPI向你的智能开关发送‘打开’指令，并查询温湿度计传感器的当前读数，将结果一并反馈给你。或者，你可以说：‘列出我家里所有的SwitchBot设备。’，它会调用设备列表接口，将所有已绑定的设备名称和类型清晰地展示出来。
介绍
本Skill通过调用SwitchBot官方OpenAPI (v1.1)，为用户提供了在AI对话环境中直接管理和查询其SwitchBot智能家居设备的能力。它解决了用户需要离开当前对话环境，手动打开手机App或调用其他工具来控制设备的痛点，将智能家居控制无缝集成到AI工作流中。
使用时，用户只需在对话中提出相关指令，例如询问设备状态或发送控制命令，本Skill便会自动调用对应的OpenAPI接口，获取或执行操作，并将结果清晰地反馈给用户，整个过程无需用户手动操作API或切换应用。
它非常适合智能家居爱好者、经常使用SwitchBot设备的家庭用户，以及希望通过自动化流程（如结合其他智能体或定时任务）来管理家居环境的开发者。对于需要在特定场景下（如回家前、睡觉时）快速调整设备状态的用户来说尤其便利。
使用前，用户需要在SwitchBot官方平台获取并配置好API Token和Secret。请注意，本Skill的功能完全依赖于SwitchBot官方OpenAPI的可用性与权限范围，无法控制未授权或非SwitchBot品牌的设备。建议在家庭网络环境中使用，以确保设备通信的稳定性。
核心特点
这是官方认证的OpenAPI集成，确保了与SwitchBot设备通信的稳定性和功能完整性，不同于第三方可能存在的兼容性问题或功能缺失。
注意事项
仅支持已接入SwitchBot生态的设备，无法控制其他品牌的智能家居产品。
常见问题
如何获取SwitchBot的API密钥？
需要下载SwitchBot App，在“我的”->“偏好设置”->“开发者选项”中开启并创建Token和Secret。
可以控制哪些类型的SwitchBot设备？
支持官方OpenAPI列出的设备，如智能开关、窗帘机、温湿度计、扫地机器人等，具体以官方文档为准。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/switchbot-openapi-x-6/raw/index.md 读取 SwitchBot OpenAPI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/switchbot-openapi-x-6/raw/index.md（查看排版版本）