13. OpenClaw 行動端接入：iOS 與 Android 節點

適用於 OpenClaw v2026.2 | 本文假設你已完成 Gateway 部署，想在行動裝置上使用。

TL;DR: iOS/Android App 作為「節點」連接 Gateway，提供攝影機、螢幕錄製、位置、通知能力。配對流程：開啟 App → 發現 Gateway → 輸入配對碼。指令：camera.snap（拍照）、screen.record（錄螢幕）、location.get（位置）、notification.send（通知）。語音喚醒僅 iOS 支援說 “Hey Claw”。

行動端功能概覽

功能對比

架構圖

[iOS/Android App] <--WiFi/Cellular--> [Gateway] <---> [Agent]
        |                                    |
    [Node API]                        [Tools/Skills]
        |                                    |
   [裝置能力]                         [外部服務]
    - 攝影機
    - 螢幕
    - 位置
    - 通知

iOS 安裝

系統需求

安裝方式

方式一：TestFlight（推薦）

1. 加入 TestFlight 測試
2. 安裝 OpenClaw iOS App
3. 開啟 App 進行配對

方式二：原始碼編譯

# 複製儲存庫
git clone https://github.com/openclaw/openclaw.git
cd openclaw/apps/ios

# 安裝依賴
pod install

# 開啟 Xcode
open OpenClaw.xcworkspace

# 編譯並安裝到裝置

iOS 權限設定

Android 安裝

系統需求

安裝方式

方式一：APK 直接安裝

1. 下載最新 APK
2. 允許未知來源安裝
3. 安裝並開啟 App

方式二：原始碼編譯

# 複製儲存庫
git clone https://github.com/openclaw/openclaw.git
cd openclaw/apps/android

# 編譯
./gradlew assembleDebug

# 安裝到裝置
adb install app/build/outputs/apk/debug/app-debug.apk

Android 權限設定

節點配對

配對流程

sequenceDiagram
    participant A as 行動 App
    participant G as Gateway
    participant D as 發現服務
    
    A->>D: 廣播發現請求
    D-->>A: 發現 Gateway
    A->>G: 請求配對
    G-->>A: 回傳配對碼
    A->>A: 顯示配對碼
    Note over A,G: 使用者在 App 輸入配對碼
    A->>G: 提交配對碼
    G->>G: 驗證配對碼
    G-->>A: 配對成功
    A->>G: 註冊節點能力
    G-->>A: 確認註冊

配對步驟

1. 確保 Gateway 運行

# 啟動 Gateway
openclaw gateway --port 18789

# 檢查狀態
openclaw health

2. 開啟行動 App

開啟 OpenClaw iOS/Android App。

3. 發現 Gateway

App 會自動掃描區域網路的 Gateway，或手動輸入 Gateway 位址：

http://192.168.1.100:18789

4. 取得配對碼

在 Gateway 終端檢視配對碼：

openclaw pairing list

# 輸出範例：
# Node     Code     Platform
# ios-1    ABC123   iOS
# android-1 XYZ789  Android

5. 輸入配對碼

在 App 中輸入配對碼，完成配對。

設定節點

{
  "nodes": {
    "ios-1": {
      "platform": "ios",
      "capabilities": ["camera", "screen_record", "location", "notification"],
      "autoConnect": true
    },
    "android-1": {
      "platform": "android",
      "capabilities": ["camera", "screen_record", "location", "notification", "sms"],
      "autoConnect": true
    }
  }
}

攝影機功能

拍照讓 AI 分析

使用者：幫我看看冰箱裡有什麼

Agent：好的，讓我透過你的手機攝影機看看...
[呼叫 camera.snap]
[分析影像]
你的冰箱裡有：
- 牛奶（半瓶）
- 雞蛋（6個）
- 小黃瓜（2根）
- 番茄（幾個）
建議可以做番茄炒蛋~

攝影機指令

設定攝影機

{
  "nodes": {
    "ios-1": {
      "camera": {
        "defaultCamera": "back",
        "quality": "high",
        "saveToGallery": false
      }
    }
  }
}

螢幕錄製

錄製並分享

使用者：幫我看看這個 App 怎麼用

Agent：好的，請開始錄製螢幕...

[使用者操作 App]

Agent：我看到了，這是一個待辦事項 App。
你可以：
1. 點選右下角的 + 號新增任務
2. 向左滑動刪除任務
3. 點選任務可以編輯詳情

螢幕錄製設定

{
  "nodes": {
    "ios-1": {
      "screenRecord": {
        "maxDuration": 300,
        "quality": "medium",
        "withAudio": true
      }
    }
  }
}

位置服務

取得目前位置

使用者：附近有什麼好吃的？

Agent：讓我看看你在哪裡...
[呼叫 location.get]
你目前在台北市信義區附近。
推薦幾家評分高的餐廳：
1. 鼎泰豐 - 4.8分，小籠包
2. 添好運 - 4.7分，港式點心
3. ...

位置指令

位置設定

{
  "nodes": {
    "ios-1": {
      "location": {
        "accuracy": "high",
        "distanceFilter": 100
      }
    }
  }
}

通知功能

傳送通知

Agent：任務已完成，我傳送一個通知到你的手機。

[呼叫 notification.send]

手機收到通知：
標題：任務完成
內容：程式碼已部署到正式環境

通知設定

{
  "nodes": {
    "ios-1": {
      "notification": {
        "enabled": true,
        "sound": true,
        "badge": true
      }
    }
  }
}

語音喚醒（iOS）

設定語音喚醒

{
  "nodes": {
    "ios-1": {
      "voiceWake": {
        "enabled": true,
        "keyword": "hey claw",
        "sensitivity": "medium"
      }
    }
  }
}

使用語音喚醒

1. 說 “Hey Claw”
2. App 自動啟動監聽
3. 說出你的問題
4. Agent 回應

Canvas 行動端

Canvas 在行動端

行動端 Canvas 提供與桌面端相同的視覺化體驗：

• 互動式儀表板
• 即時資料展示
• 表單輸入
• 圖表和表格

行動端 Canvas 最佳化

{
  "canvas": {
    "mobile": {
      "adaptiveLayout": true,
      "touchGestures": true,
      "performanceMode": "balanced"
    }
  }
}

節點管理

檢視節點

# 列出所有節點
openclaw nodes list

# 輸出範例：
# Node        Platform  Status   Capabilities
# ios-1       iOS       online   camera,location,notification
# android-1   Android   offline  camera,location,sms

# 檢視節點詳情
openclaw nodes show ios-1

節點操作

# 啟用節點
openclaw nodes enable ios-1

# 停用節點
openclaw nodes disable ios-1

# 中斷節點連線
openclaw nodes disconnect ios-1

# 重新命名節點
openclaw nodes rename ios-1 --name "我的 iPhone"

故障排查

節點無法連線

# 檢查 Gateway 狀態
openclaw health

# 檢查網路
ping 192.168.1.100

# 檢視節點日誌
openclaw logs --node ios-1

權限問題

# 檢查節點權限
openclaw nodes permissions ios-1

# 輸出範例：
# Permission      Status
# Camera          Granted
# Location        Granted
# Notification    Granted
# Microphone      Denied

配對失敗

1. 確保 Gateway 正在運行
2. 檢查網路連線（同一區域網路）
3. 檢查防火牆設定
4. 嘗試重新配對

小結

行動端節點擴展了 OpenClaw 的能力：

• 攝影機：拍照分析、影片錄製
• 位置：取得目前位置
• 通知：推播訊息到手機
• Canvas：行動端視覺化介面
• 語音喚醒：Hands-free 操作

更新記錄：

• 2026-02-26：初版發布

系列導航：

• ← 上一篇：遠端部署方案
• → 下一篇：自動化與排程任務