OpenClaw Node 相簿（Photos）功能完整攻略｜初學者指南：讀取相簿、隱私設定、與 Camera 的區別
OpenClaw Node 相簿（Photos）功能完整攻略
這是給 OpenClaw 初學者的教學文章，幫助你了解如何使用 OpenClaw Node 的相簿功能。
>
測試日期：2026-04-19
測試節點：V2514（Vivo V2514, Android 16）
OpenClaw 版本：ui v2026.4.17-dev
一、什麼是 Photos 功能？
想像一下
當你連接手機到 OpenClaw Gateway 後，AI 助手可以幫你讀取手機相簿中的照片。
這個功能可以用在：
- 📸 問 AI「幫我看看我最近拍了什麼照片」
- 🖼️ 取得照片讓 AI 分析或辨識
- 📁 備份照片時先查看相簿內容
二、Photos 功能只有一個指令
就這樣！ Photos 功能在 Android 上只有一個指令，非常單純。
三、photos.latest 完整說明
基本用法
openclaw nodes invoke --node "V2514" --command photos.latest --params '{}'完整參數範例
openclaw nodes invoke --node "V2514" --command photos.latest --params '{
"limit": 3,
"maxWidth": 800,
"quality": 0.9
}'四、支援的參數
參數說明
limit（數量）
- 決定要取得幾張照片
- 預設是 1 張
- 最大可以設定到 20 張
- 但實際數量受限於相簿裡的照片數量
maxWidth（最大寬度）
- 決定圖片的寬度上限
- 如果照片太寬，會自動縮小
- 預設 1600 像素
- 範圍：240-4096 像素
quality（品質）
- 決定 JPEG 壓縮品質
- 1.0 = 最高品質（檔案較大）
- 0.1 = 最低品質（檔案較小）
- 預設 0.85（平衡品質和大小）
五、回傳格式說明
實際回傳
{
"ok": true,
"command": "photos.latest",
"payload": {
"photos": [
{
"format": "jpeg",
"base64": "......（Base64 編碼的圖片）......",
"width": 1260,
"height": 2800,
"createdAt": "[拍攝時間]"
}
]
}
}欄位說明
六、測試結果
V2514 測試結果
V2514 相簿現況
七、與 Camera 的區別
這是非常重要的區別！
簡單說
- Camera（相機） = 現拍現用
- Photos（相簿） = 看舊照片
八、照片取得邏輯
排序方式
照片是根據拍攝時間降序排列，也就是最新的照片會先出現。
大小限制
原始碼中有兩個重要限制：
如果照片太大，會自動：
- 降低 JPEG 品質
- 縮小圖片尺寸
- 如果還是太大，就略過那張照片
權限要求
需要取得「相片」權限：
- Android 13+（API 33+）：
READMEDIAIMAGES - Android 12 以下：
READEXTERNALSTORAGE
九、錯誤代碼
十、常見問題
Q: 為什麼設定 limit: 10 只回傳 1 張？
可能原因： 手機相簿裡的照片數量不足。
Q: 收到的照片為什麼很小/模糊？
可能原因： 照片太大超過大小限制，系統自動降低品質和尺寸。
解決方法：
- 提高
quality參數（但可能還是會被壓縮） - 降低
maxWidth可以減少被壓縮的機率
Q: 可以取得特定日期的照片嗎？
不行。 目前只支援取得「最新的 N 張照片」，不支援日期篩選。
Q: 可以刪除照片嗎？
不行。 Photos 功能只有讀取權限，沒有刪除功能。
十一、沒有這些功能
根據我們的完整調查，確認不存在以下功能：
十二、相關資源
- [OpenClaw 官方 Android 文件](https://docs.openclaw.ai/platforms/android.md)
- [OpenClaw Node 指令總覽](./openclaw-android-node-commands.md)
- [OpenClaw Camera 功能攻略](./openclaw-android-camera-guide.md)
總結
文章更新：2026-04-19
留言
張貼留言
歡迎留下您的心靈足跡👍