教程

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

相关文章推荐

教程OpenClaw Standing Orders 完全指南:让 AI 记住你的长期规则和行为偏好OpenClaw Standing Orders(常驻指令)功能完整教程:Standing Orders 与 SOUL.md 的区别(动态运行时规则 vs 静态人格文件)、通过对话动态添加/查看/删除常驻指令、指令的持久化存储与跨会话生效机制、适合写入 Standing Orders 的内容类型(格式偏好/禁止行为/固定工作流)、与 Hooks 的协同使用、按渠道/Agent 设置不同的 Standing Orders,以及常驻指令的最佳实践(写清晰的规则、避免矛盾冲突、定期清理过时规则)。2026/3/26教程OpenClaw 多媒体处理完全指南:图片识别、音频转写与视频理解实战OpenClaw 多媒体处理(Media)完整教程:发送图片给 AI 进行视觉分析(OCR/物体识别/图表解读/代码截图)、音频消息自动转写为文字(Whisper/系统STT)、视频消息关键帧提取与理解、Node 摄像头实时拍照触发分析、媒体消息的渠道支持差异(各渠道的图片/音频/视频支持情况对比)、大文件处理策略(分割/压缩/超时设置)、媒体消息在不同 AI 模型上的能力对比(Claude Vision/GPT-4V/Gemini Pro Vision),以及本地媒体文件分析(read 工具读取图片路径)。2026/3/25教程OpenClaw TUI 完全指南:纯键盘操作的终端管理界面使用详解OpenClaw TUI(Terminal User Interface,终端用户界面)完整使用指南:TUI 与 Control UI(浏览器)的定位对比、适合 TUI 的场景(SSH 远程/无浏览器服务器/低带宽环境)、启动命令(openclaw tui)及参数、界面布局(Agents 面板/Sessions 面板/Channels 状态/Logs 实时流)、全键盘快捷键手册(导航/选择/搜索/刷新/退出)、在 TUI 中发送测试消息、实时日志过滤与搜索,以及 TUI 与 tmux/screen 配合使用的后台运行方案。2026/3/25教程OpenClaw Control UI 与 Dashboard 完全指南:浏览器管理 AI 助手的全功能界面OpenClaw Control UI(控制面板)与 Dashboard(仪表盘)完整使用指南:Control UI 的功能布局(Agents 管理/Tools 工具面板/Sessions 会话查看/Channel 渠道状态)、浏览器访问方式(本地 localhost:18789 vs 远程 SSH 隧道)、在 Control UI 中实时修改 Agent 配置(SOUL.md 编辑/模型切换/工具开关)、Dashboard 数据概览(Token 用量/渠道在线状态/会话列表/Node 节点健康)、从 Dashboard 发起诊断(doctor 命令)、以及 TUI(终端界面)的使用场景与快捷键。2026/3/24教程OpenClaw 群消息完全指南:群组配置、@ 触发、白名单与多 Bot 协同实战OpenClaw 群消息(Group Messages)完整配置教程:群组消息的触发方式(requireMention/commandPrefix/respondToAll)、各渠道群组配置差异(Telegram群/Discord服务器/Slack频道/WhatsApp群)、群组白名单与黑名单管理、限制特定成员才能触发 AI(allowedUsers/allowedRoles)、响应限速防刷屏(cooldown)、多 Bot 在同一群组协同分工的配置方案、群组 Session 的记忆与上下文管理,以及群组中 AI 的礼貌边界设计(何时发言/何时沉默)。2026/3/24教程OpenClaw 接入 Nextcloud Talk:自托管视频会议平台 AI 助手完全配置指南OpenClaw 接入 Nextcloud Talk 的完整教程:Nextcloud Talk 的自托管通信平台特点(视频会议+聊天+文件协作)、插件安装(@openclaw/nextcloud-talk)、通过 occ CLI 创建 Bot 账户并注册 Webhook、OpenClaw 最简配置(serverUrl+appPassword+sharedSecret)、DM 私信与房间(Room)访问控制、Markdown 消息格式和表情反应支持、局域网/内网部署注意事项(WebSocket vs Polling),以及 Nextcloud Talk AI 助手的典型使用场景(会议摘要/文件问答/任务分派)。2026/3/24