OpenClaw Node 裝置（Device）功能完整攻略｜初學者指南：查電量、儲存、權限、健康狀態
OpenClaw Node 裝置（Device）功能完整攻略
這是給 OpenClaw 初學者的教學文章，幫助你了解如何使用 OpenClaw Node 的裝置查詢功能。
>
測試日期：2026-04-19
測試節點：V2514（Vivo V2514, Android 16）
OpenClaw 版本：ui v2026.4.17-dev
一、什麼是 Device 功能？
想像一下
當你連接手機到 OpenClaw Gateway 後，AI 助手就像變成你手機的「超能力助手」。它可以幫你：
- 🔋 查看手機還剩多少電
- 💾 檢查手機儲存空間還夠不夠
- 📶 確認網路連線狀態
- 🔒 查看哪些權限已經開啟
- 🌡️ 監控手機健康狀況
這些功能就是「Device（裝置）」指令家族。
二、Device 功能有哪些指令？
根據我們的完整測試，Android 上的 Device 功能共有 4 個指令：
重要特點： 所有 Device 指令都是「只讀取」，不需要特別開啟危險指令！
三、各指令詳細說明
1️⃣ device.status（裝置狀態）
基本用法
openclaw nodes invoke --node "V2514" --command device.status --params '{}'實際回傳
{
"battery": {
"level": 0.85,
"state": "unplugged",
"lowPowerModeEnabled": false
},
"thermal": { "state": "fair" },
"storage": {
"totalBytes": 486373556224,
"freeBytes": 328631029760,
"usedBytes": 157742526464
},
"network": {
"status": "satisfied",
"isExpensive": false,
"interfaces": ["wifi"]
},
"uptimeSeconds": 44880.33
}欄位說明
2️⃣ device.info（裝置資訊）
基本用法
openclaw nodes invoke --node "V2514" --command device.info --params '{}'實際回傳
{
"deviceName": "V2514",
"modelIdentifier": "V2514",
"systemName": "Android",
"systemVersion": "16",
"appVersion": "2026.4.17",
"appBuild": "2026041790",
"locale": "zh-Hant-TW"
}欄位說明
3️⃣ device.permissions（權限狀態）
基本用法
openclaw nodes invoke --node "V2514" --command device.permissions --params '{}'實際回傳
{
"permissions": {
"camera": { "status": "granted" },
"microphone": { "status": "granted" },
"location": { "status": "granted" },
"sms": {
"status": "granted",
"capabilities": {
"send": { "status": "granted" },
"read": { "status": "granted" }
}
},
"contacts": { "status": "granted" },
"calendar": { "status": "granted" },
"callLog": { "status": "granted" },
"notificationListener": { "status": "granted" },
"notifications": { "status": "granted" },
"photos": { "status": "granted" },
"motion": { "status": "granted" }
}
}欄位說明
權限狀態值
4️⃣ device.health（系統健康狀態）
基本用法
openclaw nodes invoke --node "V2514" --command device.health --params '{}'實際回傳
{
"memory": {
"pressure": "normal",
"totalRamBytes": 16110477312,
"availableRamBytes": 5554520064,
"usedRamBytes": 10555957248,
"lowMemory": false
},
"battery": {
"state": "unplugged",
"chargingType": "none",
"temperatureC": 39.9,
"currentMa": -733
},
"power": {
"dozeModeEnabled": false,
"lowPowerModeEnabled": false
},
"system": {
"securityPatchLevel": "2026-03-01"
}
}欄位說明
四、實用應用場景
場景一：每日健康檢查
設定 cron 工作，每天早上檢查一次：
每天 8:00 檢查一次如果你問 AI：「幫我檢查手機狀態」，AI 可以快速取得所有資訊。
場景二：空間不足警告
當 storage.freeBytes 低於某個值時，發送通知提醒你清理空間。
場景三：確認權限狀態
當某個功能無法使用時，先檢查 device.permissions 確認權限是否正常。
五、疑難排解
Q: 收到的資料是空的或錯誤？
可能原因：
- 節點連線中斷
- 節點處於休眠狀態
解決方法：
openclaw nodes status
# 確認節點是否 connectedQ: 某些欄位顯示 null？
可能原因：
- 該硬體不存在（如某些手機沒有溫度感測器）
- 權限被拒絕
解決方法：
檢查 device.permissions 確認權限狀態。
Q: 權限被拒絕怎麼辦？
解決方法：
- 打開手機「設定」
- 找到「應用程式」→「OpenClaw」
- 點擊「權限」
- 開啟對應的權限
六、V2514 實際測試結果
測試環境
目前狀態
所有權限狀態
V2514 的所有權限都已授權！ 包括：
- ✅ 相機、麥克風、位置
- ✅ 簡訊（讀/寫）、通訊錄、日曆
- ✅ 通話紀錄、通知、相簿
- ✅ 運動感測器
七、相關資源
- [OpenClaw 官方 Android 文件](https://docs.openclaw.ai/platforms/android.md)
- [OpenClaw Node 指令總覽](./openclaw-android-node-commands.md)
- [OpenClaw 危險指令指南](./openclaw-android-dangerous-commands-guide.md)
總結
文章更新：2026-04-19
留言
張貼留言
歡迎留下您的心靈足跡👍