教程

OpenClaw Nodes 节点系统:设备配对与远程命令执行

OpenClaw Nodes 节点系统教程:设备配对与审批流程、SSH 隧道远程节点部署、exec 工具指向节点、Canvas 截图与控制、相机拍照与视频录制、屏幕录制、位置获取,以及 Android 专属命令(SMS、通知、照片、日历)。

2026/3/102分钟 阅读ClaudeEagle

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 18789

SSH 隧道方式:

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 precise

Android 命令

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

相关文章推荐

教程WorkBuddy 直连微信:发条消息就能远程指挥电脑干活,兼容 OpenClaw 技能体系腾讯 WorkBuddy 微信直连功能详解:配置微信客服号即可远程指挥电脑执行任务,支持企微断网自动重连与定时任务自动化,技能包完全兼容OpenClaw体系可无缝迁移,附向内隔离向外防御安全设计解读。2026/8/15教程OpenClaw Sessions 磁盘维护完全指南:sessions.json 自动清理与 openclaw sessions cleanup 命令详解 OpenClaw session.maintenance 磁盘维护配置:warn/enforce 双模式、清理执行顺序、maxDiskBytes/highWaterBytes 磁盘预算控制,以及 openclaw sessions cleanup 命令的 dry-run 安全用法。2026/8/13教程OpenClaw SecretRef 完全教程:让 API Key 不用再以明文躺在配置文件里详解 OpenClaw SecretRef 密钥引用机制:内存快照运行时模型、active/inactive Surface 判定逻辑、env/file/exec 三种引用来源写法,以及生产环境凭据管理的实战建议。2026/8/12教程OpenClaw Session Pruning 与 Compaction 的区别:谁在悄悄给你的会话上下文瘦身详解 OpenClaw Session Pruning 会话修剪机制:如何在每次 LLM 调用前修剪旧的工具调用结果以降低成本,与 Compaction 压缩机制的区别与配合方式,附智能默认值和手动配置方法。2026/8/12教程OpenClaw Prompt Caching 调优指南:cacheRetention、cache-ttl 修剪与心跳保温三件套详解 OpenClaw 提示缓存调优三大配置项:cacheRetention 缓存保留策略、contextPruning cache-ttl 上下文修剪、heartbeat 心跳保温,附配置合并优先级和不同场景的调优建议。2026/8/12教程OpenClaw "Sandbox 越狱"排障指南:Sandbox / Tool Policy / Elevated 三层控制到底谁说了算详解 OpenClaw 三套独立又叠加的权限控制机制:Sandbox 决定工具运行位置、Tool Policy 决定工具是否可用、Elevated 是仅针对 exec 的提权逃生舱,附 sandbox explain 排障命令和常见问题修复清单。2026/8/12