最近，CLI（命令行工具）正在成為AI Agent時代的基礎(chǔ)設(shè)施。

飛書、企業(yè)微信、釘釘?shù)榷嗉抑髁鬓k公協(xié)作平臺，相繼開源了各自的CLI工具，將消息、文檔、日程等產(chǎn)品能力封裝為命令行接口，供開發(fā)者和AI Agent直接調(diào)用。

背后的邏輯很明確：命令行是AI編程Agent最成熟的交互方式，Agent天生適合執(zhí)行結(jié)構(gòu)化的CLI指令。

辦公場景的CLI化已經(jīng)走在前面。但對AI+IoT開發(fā)者來說，一個問題隨之浮現(xiàn)：消息可以CLI了，文檔可以CLI了，日程可以CLI了——設(shè)備控制呢？

查看設(shè)備在線狀態(tài)、調(diào)整空調(diào)溫度、批量關(guān)閉某個房間的燈光、查詢用電數(shù)據(jù)——這些日常開發(fā)中的高頻操作，以往只能通過編寫代碼調(diào)用API，或者打開手機(jī)App手動完成。

今天，涂鴉正式開源tuya-smart-control-cli，為AI+IoT開發(fā)者提供了一套完整的設(shè)備管理命令行工具。

一、Enduser API與CLI是什么關(guān)系？

在介紹CLI之前，有必要先厘清兩個概念。

Tuya Enduser API是涂鴉開放給開發(fā)者的官方接口，用于獲取設(shè)備列表、控制設(shè)備、查詢數(shù)據(jù)、發(fā)送通知等。能力完整，覆蓋3000+設(shè)備品類、200+國家和地區(qū)。使用API需要編寫代碼、處理簽名邏輯、管理Token生命周期、構(gòu)造HTTP請求，適合二次開發(fā)和系統(tǒng)集成。

tuya-smart-control-cli是基于上述Enduser API封裝的命令行工具。底層調(diào)用的是同一套API能力，但開發(fā)者無需編寫完整代碼，在終端輸入命令即可完成設(shè)備查詢、控制、通知等操作。CLI內(nèi)置了鑒權(quán)流程和參數(shù)格式化，適合快速調(diào)試、批量操作和輕量級腳本編排。

需要特別說明：API Key等憑證仍然必須配置。CLI不會內(nèi)置密鑰，也不支持免密使用。CLI省去的是編寫代碼、處理簽名和構(gòu)造請求的步驟，身份驗證和權(quán)限管理與直接調(diào)用API完全一致。

簡而言之：API是底層能力，CLI是基于這套API打造的開箱即用的命令行工具。

二、AI+IoT開發(fā)者為什么需要CLI？

01

設(shè)備調(diào)試效率大幅提升

開發(fā)者在硬件聯(lián)調(diào)階段需要頻繁查看設(shè)備狀態(tài)、測試指令下發(fā)。以往的流程是：編寫腳本→引入SDK →處理簽名→發(fā)起請求→解析返回，一輪調(diào)試往往需要十幾分鐘。

使用CLI后，一條命令即可完成：

tuyadevice detail0620068884f3eb414579

幾秒內(nèi)即可看到設(shè)備當(dāng)前的屬性狀態(tài)——開關(guān)狀態(tài)、亮度值、工作模式等。切換到下一臺設(shè)備，只需更改device_id重新執(zhí)行。

02

批量操作無需開發(fā)管理后臺

方案商在酒店、公寓、辦公樓等場景下，往往需要同時管理大量設(shè)備。CLI配合Shell腳本，可以實(shí)現(xiàn)輕量化的批量運(yùn)維：

# 查詢某個房間下的所有設(shè)備tuya device list --room 333
# 批量關(guān)閉房間內(nèi)所有燈光tuya device list --room 333 --json | jq -r'.[].device_id'|\ whilereadid;do tuya device control"$id"'{"switch_led":false}' done

無需單獨(dú)開發(fā)管理系統(tǒng)，一個Shell腳本配合cron定時任務(wù)即可滿足基礎(chǔ)運(yùn)維需求。

03

為AI Agent提供設(shè)備操作入口

當(dāng)前各類AI Agent的核心交互方式就是執(zhí)行Shell命令。當(dāng)涂鴉的設(shè)備控制能力被封裝為CLI后，AI Agent便可以在終端中直接操控智能設(shè)備——與它調(diào)用git、docker等工具的方式完全一致。

04

支持JSON輸出，便于數(shù)據(jù)處理與集成

所有查詢命令均支持--json參數(shù)，輸出結(jié)構(gòu)化JSON數(shù)據(jù)，方便與jq等工具配合使用，或作為管道數(shù)據(jù)傳遞給其他程序：

# 導(dǎo)出設(shè)備列表tuyadevice list --json > devices.json
# 提取所有設(shè)備IDtuya device list --json | jq'.[].device_id'
# 篩選在線設(shè)備tuya device list --json | jq'[.[] | select(.online==true)]'

三、5分鐘完成安裝與配置

環(huán)境要求

Node.js >= 18

涂鴉API Key（中國區(qū)：tuyasmart.com｜ 海外區(qū)：tuya.ai）

安裝

gitclonehttps://github.com/tuya/tuya-smart-control-cli.gitcdtuya-smart-control-clinpm installnpmlink

執(zhí)行npm link后，tuya命令將在全局可用。

配置

# 交互式配置（推薦）tuya init
# 或通過環(huán)境變量配置exportTUYA_API_KEY="sk-AYxxxxxxxxxxxx"

運(yùn)行tuya init會引導(dǎo)開發(fā)者輸入API Key。CLI根據(jù)Key前綴自動識別所屬區(qū)域并匹配對應(yīng)的服務(wù)端地址，全球7個數(shù)據(jù)中心無需手動配置：

驗證連通性

tuyadoctor

該命令會依次檢查配置文件、API Key有效性、網(wǎng)絡(luò)連通性以及賬號下的家庭數(shù)據(jù)：

Tuya CLI Doctor─────────────── Configfile: /Users/you/.tuya-cli/config.json API Key: sk-AY****xxxx (fromconfigfile) Base URL: https://openapi.tuyacn.com (China) API connection: OK (2home(s) found)

全部顯示即表示配置完成。

四、完整命令參考

▍設(shè)備管理（核心功能）

# 列出所有設(shè)備tuyadevice list
# 按家庭或房間篩選tuyadevice list --home tuyadevice list --room
# 查看設(shè)備詳情（含當(dāng)前屬性狀態(tài)）tuyadevice detail
# 查看設(shè)備物模型（了解設(shè)備支持的操作能力）tuyadevice model
# 控制設(shè)備——單屬性tuyadevice control '{"switch_led":true}'
# 控制設(shè)備——多屬性同時設(shè)置tuyadevice control '{"switch_led":true,"bright_value":800}'
# 重命名設(shè)備tuyadevice rename "客廳主燈"

典型調(diào)試流程：device list定位設(shè)備→ device detail確認(rèn)當(dāng)前狀態(tài)→ device model查看可操作屬性→ device control下發(fā)指令。四步完成一輪調(diào)試，全程無需編寫代碼。

▍家庭與房間管理

# 列出所有家庭tuyahome list
# 列出指定家庭下的房間tuya home rooms

▍天氣查詢

# 按經(jīng)緯度查詢天氣tuyaweather39.90116.40
# 指定查詢字段tuyaweather39.90116.40--codes '["w.temp","w.humidity"]'

▍消息通知

支持短信、語音電話、郵件、App推送四種通知方式，均為發(fā)送給當(dāng)前登錄用戶：

# 短信通知tuyanotify sms"設(shè)備已關(guān)閉"
# 語音電話通知tuya notify voice"警告：檢測到異常溫度"
# 郵件通知tuya notify mail"設(shè)備日報""所有設(shè)備運(yùn)行正常"
# App推送通知tuya notify push"安防提醒""客廳檢測到異常移動"

在設(shè)備告警場景中，可以結(jié)合cron定時任務(wù)實(shí)現(xiàn)自動化監(jiān)控——例如每小時檢查一次設(shè)備狀態(tài)，發(fā)現(xiàn)離線設(shè)備即自動發(fā)送短信通知。

▍數(shù)據(jù)統(tǒng)計

# 查看可用的統(tǒng)計配置tuyastats config
# 查詢某設(shè)備的用電量數(shù)據(jù)（按小時維度）tuyastats data ele_usage SUM20250331002025033123

五、支持的控制類型

說明：當(dāng)前CLI暫不支持門鎖操作、視頻/攝像頭訪問、圖像處理、固件升級、設(shè)備配網(wǎng)/移除等功能。這些操作請通過涂鴉App或完整API實(shí)現(xiàn)。

六、常見問題排查

運(yùn)行tuya doctor即可自動檢測大部分配置問題。常見錯誤碼及處理方式：

七、適用場景與目標(biāo)開發(fā)者

涂鴉生態(tài)開發(fā)者：硬件聯(lián)調(diào)階段的設(shè)備調(diào)試效率將大幅提升——無需反復(fù)編寫測試腳本，終端命令即可完成查詢和控制。

方案商：酒店、公寓、辦公樓等商業(yè)場景下的設(shè)備批量管理，可以通過CLI腳本實(shí)現(xiàn)輕量化運(yùn)維，降低管理系統(tǒng)的開發(fā)成本。

AI Agent開發(fā)者：為Agent項目提供物理設(shè)備控制能力。CLI的命令行接口天然適配AI Agent的執(zhí)行方式，可以與其他CLI工具組合使用。

硬件測試工程師：設(shè)備功能的反復(fù)測試不再依賴手機(jī)App的手動操作，終端中即可批量運(yùn)行測試用例。

回到文章開頭的觀察：辦公協(xié)作平臺集體CLI化，本質(zhì)上是在回答同一個問題——AI Agent時代，軟件應(yīng)該長什么樣？

答案正在變得清晰：每一個軟件都需要兩種形態(tài)。GUI服務(wù)于人，CLI服務(wù)于AI。當(dāng)軟件把自身能力封裝為命令行接口的那一刻，它就從一個"需要人來操作的工具"，變成了"可以被AI Agent直接調(diào)用的能力模塊"。

這個趨勢在辦公軟件領(lǐng)域已經(jīng)發(fā)生。而AI+IoT領(lǐng)域的CLI化，意味著AI Agent的能力邊界正在從數(shù)字世界延伸到物理世界——從"幫你發(fā)消息、寫文檔"，到"幫你管理真實(shí)空間中的每一臺設(shè)備"。

tuya-smart-control-cli的開源，是涂鴉推動AI進(jìn)入物理世界邁出的堅實(shí)一步。

當(dāng)這些物理設(shè)備控制的能力，以命令行的形式向AI Agent敞開時，AI進(jìn)入物理世界的萬千應(yīng)用爆發(fā)才剛剛開始。