设备节点
OpenClaw 节点让 Agent 可以与物理设备交互——拍照、录屏、定位、发送短信等。支持手机、远程主机和 macOS 应用。
节点类型
| 类型 | 说明 |
|---|---|
| 伴侣设备 | 手机（iOS/Android）作为 Agent 的感官 |
| 远程主机 | 远程服务器上运行的节点进程 |
| macOS 应用 | 原生 macOS 应用作为节点 |
设备配对
节点通过配对码机制连接到 Gateway：
# 在 Gateway 主机上生成配对码
openclaw node pair
# 在设备上输入配对码完成配对
# 或通过 QR 码扫描配对
# 查看已配对设备
openclaw nodes list
# 审批待配对设备
openclaw pairing approve node <CODE>远程节点
在远程主机上运行节点进程：
# 前台模式
openclaw node host --gateway wss://your-gateway:port
# 服务模式（systemd）
openclaw node host --install
# 通过 SSH 隧道连接
ssh -L 3001:localhost:3001 remote-host
openclaw node host --gateway ws://localhost:3001设备能力
| 能力 | 平台 | 说明 |
|---|---|---|
| camera | iOS/Android | 拍照和录制视频 |
| audio | 所有 | 录音和语音转写 |
| location | iOS/Android | 获取 GPS 位置 |
| screen | macOS | 录屏（MP4） |
| sms | Android | 发送短信 |
| voicewake | macOS | 语音唤醒 |
| system.run | 所有 | 执行系统命令 |
音频与语音转写
节点可以录制音频并自动转写为文本。支持多种转写引擎：
- Deepgram — 高质量云端转写
- OpenAI Whisper — OpenAI 语音模型
- Mistral Voxtral — Mistral 语音模型
- 本地 CLI — 本地转写工具（自动检测）
检测顺序：本地 CLI → Gemini CLI → Provider 密钥。 群组中的语音消息支持预检转写以进行提及检测。
Android 特有功能
- 设备状态和信息查询
- 权限管理
- 健康数据
- 通知读取
- 相册浏览
- 通讯录和日历访问
- 运动数据
注意事项
- 节点功能需要设备授予相应权限
- 音频/视频大小受
mediaMaxMb限制 - 远程节点建议通过 SSH 隧道或 Tailscale 连接
- headless 模式可在无 GUI 的服务器上运行节点