SwitchBot 釋出 OpenAPI CLI：不是給人用的工具，是給 AI agent 控制你家的介面

SwitchBot Japan 4 月 22 日發了一則看起來很低調的開發者 tweet：「SwitchBot OpenAPI 向け CLI ツールを公開しました」，附上 GitHub（OpenWonderLabs/switchbot-openapi-cli）和 npm 連結（@switchbot/openapi-cli）。

看起來就是一個 IoT 廠商開源的命令列工具，但點開 repo 的 agent-guide.md 就會發現，這個 CLI 的設計目標不是給人類開發者用的。

這個 CLI 是寫給 agent 看的

Repo 的 agent-guide.md 開頭第一句：「If you're a human looking for a tour, start with the top-level README. This file assumes you're writing code that calls the CLI or embeds the MCP server.」

意思很清楚——人類看 README，agent 看 agent-guide。這是 2026 年產品文件的新寫法：預設讀者不是人。

技術面向上對應的設計：

switchbot mcp serve — CLI 內建 MCP server。一個指令就把整個 SwitchBot Cloud API 暴露成 Claude Desktop / 其他 MCP client 可以直接呼叫的工具介面
switchbot agent-bootstrap — 給 agent 用的初始化流程，自動建立需要的認證和 catalog
switchbot schema export — 把設備 schema 輸出成結構化格式（JSON/YAML），讓 agent 知道每種設備有哪些可控制的 attribute
switchbot capabilities --json — 查詢當前帳號能控制哪些設備類型
switchbot devices list --format=tsv --fields=deviceId,deviceName,type,cloud — 輸出格式可調整，TSV 讓 agent 處理起來 token 用量最小
switchbot doctor --json | jq .checks — 健康檢查有 JSON 輸出，agent 可以自己診斷問題
catalog 快取機制 --cache=5m — 減少重複查 API 造成的 token 壓力

agent-guide 明講：「This CLI is the authoritative machine-readable surface.」翻譯：CLI 是我們對 agent 的權威介面，conversational skill（Phase 3B 計畫中的包裝層）是外掛不是主體。

實際可以控制什麼

SwitchBot Cloud API v1.1 支援的設備類型很完整：

燈泡、智慧插座、窗簾、捲簾
智慧鎖（Lock、Lock Pro、Lock Ultra、Lock Vision）
溫濕度計、CO2 監測、水漏偵測、動作感測器、存在感測器、門窗感測器
空氣清淨機、加濕器、循環扇
掃地機器人（K10+、K20+ Pro、S10）
IR 家電控制（透過 Hub Mini / Hub 2 / Hub 3）：冷氣、電視、風扇、音響

實際用 Claude Desktop 把 SwitchBot 接上的流程：

{
  "mcpServers": {
    "switchbot": {
      "command": "npx",
      "args": ["-y", "@switchbot/openapi-cli", "mcp", "serve"],
      "env": {
        "SWITCHBOT_TOKEN": "...",
        "SWITCHBOT_SECRET": "..."
      }
    }
  }
}

配好後對 Claude 說「把客廳的冷氣開到 24 度」、「晚上 10 點把所有燈關掉」、「看一下臥室溫度現在多少」，Claude 會自動呼叫對應的 MCP tool。這不是 demo，是 SwitchBot 官方支援的使用情境。

為什麼 SwitchBot 現在做這件事

2026 年智慧家庭生態的底層情勢：

Matter 1.4：Apple Home、Google Home、Amazon Alexa、SmartThings 的共通協定穩定了，互通成本下降
家用 agent 成為主流：Claude Desktop、ChatGPT Desktop、各種 MCP-compatible client 開始變成日常生產力工具
MCP 協定成形：Anthropic 推的 Model Context Protocol 在 2025-2026 變成 agent 和外部工具串接的實質標準

在這個時點，家電廠面對的選擇是：等 agent client 自己實作 API 整合（慢、品質不一致、每個 client 要重做），或是自己提供官方 MCP server（快、一致、可控制）。SwitchBot 選了後者。

這個選擇也暗示了 SwitchBot 對自己產品線的判斷——CES 2026 他們推 onero H1 家用機器人（22 個自由度、on-device OmniSense VLA 模型），還有 AI Hub 支援本地 AI。整個生態朝「embodied AI + voice/text agent 能控制一切」方向走，CLI + MCP 是同一個策略的最便宜的第一層。

產業訊號

SwitchBot 不是第一個做 MCP server 的廠商，但是第一批「把 agent 當一等公民」的家電品牌之一。合理預期接下來幾個月會跟進的：

Aqara / Tuya / 小米：這些廠商已經有完整 OpenAPI，差的是「給 agent 用的封裝」。一個 CLI + MCP 的 repo 的工程量不大，看誰先做
Nanoleaf、Govee、LIFX 這類燈光廠：燈光控制是 agent 最常用的 smart home 功能之一
掃地機器人廠（Roborock、iRobot、Ecovacs）：已經有 cloud API，把它包成 MCP 是下一步
車廠已經在做類似的事（Mercedes、BMW 都在試 LLM 車內介面），但介面封裝還沒公開

對開發者來說，SwitchBot 這個 repo 的參考價值不只在於能不能用 —— agent-guide.md 本身就是「給 agent 看的文件應該怎麼寫」的範本。

該擔心的部分

把家電控制權交給 LLM 有一些不能忽略的問題：

誤下指令：LLM 不是確定性系統。如果你說「把門鎖起來」，agent 理解對了是好事；如果 prompt injection 進來、或模型誤判 context，就可能發生把你自己鎖在門外、或半夜突然開冷氣之類的事。SwitchBot 的 CLI 本身沒辦法解這個問題，只能在每個高風險操作加 confirmation step。

API key 管理：SWITCHBOT_TOKEN 和 SECRET 放在 MCP config 裡，等於給 agent 全帳戶控制權。如果你的 Claude Desktop 被有惡意的 prompt injection 利用（例如請 Claude 讀一個暗中植入指令的網頁），agent 可能會被誘導去執行你沒同意的設備操作。

雲端依賴：SwitchBot OpenAPI 走 Cloud API v1.1，需要網路。沒網路就不能控制。對智慧鎖這種關鍵設備是有風險的——Matter-over-Wi-Fi 或 BLE 直連是比較穩的 fallback，但 CLI 走的是雲端路徑。

資料流向：你的家每天做了什麼（幾點開燈、誰回家、溫度變化），當 agent 能呼叫 API 查這些資料時，agent 也會看到。這些資料如果被 agent 記錄到對話歷史或 memory，就成為 LLM 訓練或服務商留存的一部分。

結語

SwitchBot OpenAPI CLI 不只是一個 CLI。它是一個表態：SwitchBot 認為 2026-2027 年家電控制的主要介面會從手機 app 轉向 AI agent，所以我們主動把自己的設備接好。

這個判斷對不對還要再看——很多人還是偏好按實體開關，agent 控制家電的穩定度還有待證明。但產業的訊號很清楚：手機 app 作為智慧家庭第一個介面的時代正在結束。對家電廠，做不做 MCP server 不是「要不要做」，是「幾月做」。

OpenWonderLabs/switchbot-openapi-cli 是這波的早期公開範本，agent-guide.md 的寫法值得其他廠商抄。