Node(节点)是连接到 Gateway WebSocket 的伴侣设备,支持 macOS、iOS、Android 和无头服务器。
核心概念
Nodes 是外设,不是 Gateway。消息(Telegram/WhatsApp)落在 Gateway,不落在 Nodes。Node 连接后需通过设备配对审批。
设备配对
bash
openclaw devices list
openclaw devices approve <requestId>
openclaw nodes status部署远程节点
bash
openclaw node run --host <gateway-host> --port 18789 --display-name "Build Node"
openclaw node install --host <gateway-host> --port 18789SSH 隧道方式:
bash
ssh -N -L 18790:127.0.0.1:18789 user@gateway-host
export OPENCLAW_GATEWAY_TOKEN="<token>"
openclaw node run --host 127.0.0.1 --port 18790配置 exec 使用节点
bash
openclaw config set tools.exec.host node
openclaw config set tools.exec.node "<id-or-name>"
openclaw approvals allowlist add --node <id> "/usr/bin/uname"Canvas 操作
bash
openclaw nodes canvas snapshot --node <id> --format png
openclaw nodes canvas present --node <id> --target https://example.com
openclaw nodes canvas eval --node <id> --js "document.title"相机与屏幕
bash
openclaw nodes camera snap --node <id>
openclaw nodes camera clip --node <id> --duration 10s
openclaw nodes screen record --node <id> --duration 10s --fps 10位置获取
bash
openclaw nodes location get --node <id> --accuracy preciseAndroid 命令
bash
openclaw nodes invoke --node <id> --command sms.send --params "{\"to\":\"+1555\",\"message\":\"Hi\"}"
openclaw nodes invoke --node <id> --command notifications.list --params "{}"
openclaw nodes invoke --node <id> --command photos.latest --params "{\"limit\":1}"系统命令
bash
openclaw nodes run --node <id> -- echo "Hello"
openclaw nodes notify --node <id> --title "提醒" --body "内容"原文来源:OpenClaw 官方文档 https://docs.openclaw.ai/nodes