SwitchBot智能家居控制

技能简介

通过SwitchBot Cloud API v1.1控制各类智能设备，包括窗帘、插座、灯具、门锁、温湿度计等。支持设备发现、状态查询和远程操控。

能做什么

• 开合智能窗帘并设置具体位置（0-100%）
• 开关插座与灯具，调节亮度颜色
• 查看温湿度传感器数据
• 控制智能门锁上锁/解锁
• 批量管理多个设备

使用说明

首次配置：

1. 获取API凭证：打开SwitchBot App → 个人资料 → 偏好设置 → 关于 → 开发者选项，复制Token和Secret Key
2. 安全存储凭证：

   mkdir -p ~/.config/switchbot
   chmod 700 ~/.config/switchbot
   cat > ~/.config/switchbot/credentials.json << 'EOF'
   {
     "token": "YOUR_TOKEN_HERE",
     "secret": "YOUR_SECRET_HERE"
   }
   EOF
   chmod 600 ~/.config/switchbot/credentials.json

3. 发现设备：

   python3 <skill_path>/scripts/switchbot.py list

常用操作：

• 列出所有设备：python3 <skill_path>/scripts/switchbot.py list
• 打开窗帘：python3 <skill_path>/scripts/switchbot.py curtain <device_id> open
• 关闭窗帘：python3 <skill_path>/scripts/switchbot.py curtain <device_id> close
• 设置窗帘位置：python3 <skill_path>/scripts/switchbot.py curtain <device_id> 50
• 开关插座/灯：python3 <skill_path>/scripts/switchbot.py plug <device_id> on/off
• 查看状态：python3 <skill_path>/scripts/switchbot.py status <device_id>

输入与输出

见下方输入与输出表格。

风险提示

• 凭证文件需设置600权限，避免泄露
• 切勿在日志中记录或显示Token/Secret
• 设备离线（错误码151）时检查Hub连接状态
• 部分命令可能不被特定设备型号支持（错误码152）

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/daaab/switchbot/SKILL.md
来源类型：GitHub仓库