教程

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 Skills 完整指南:技能加载优先级、配置门控和 ClawHub 安装OpenClaw Skills 官方文档中文整理:技能目录结构、加载位置和优先级、per-agent 与 shared skills、插件技能、ClawHub 安装、metadata.openclaw 依赖门控、环境变量和安全边界。2026/6/4教程OpenClaw Sub-agents 使用指南:后台并行任务、结果回传和线程绑定OpenClaw Sub-agents 官方文档中文整理:什么时候用 sub-agent、如何后台并行执行任务、结果如何 announce 回主会话、thread-bound session、嵌套编排、工具权限、超时和自动归档。2026/6/4教程OpenClaw ACP Agents 完整指南:把 Codex、Claude Code、Gemini 接入聊天线程OpenClaw ACP Agents 官方文档中文整理:什么是 ACP runtime、如何把 Codex/Claude Code/Gemini CLI 绑定到聊天、current conversation bind、thread-bound session、持久会话、运行时配置和适用场景。2026/6/4教程OpenClaw Skills 开发完全指南:从零编写高质量 SKILL.md 自定义技能文件OpenClaw Skills 开发完整教程:SKILL.md 文件结构详解、自动触发 vs 显式触发原理、三个实战模板(GitHub 仓库管理/每日信息简报/代码健康检查)、让技能精准自动触发的描述写法,以及技能质量标准和 clawhub.ai 使用方法。2026/4/19教程OpenClaw 零基础完全入门:安装、Telegram 配置、记忆系统和技能插件完整指南OpenClaw 从零开始完整教程:用宠物龙虾类比理解架构、npm 安装步骤、Telegram Bot 配置、SOUL.md 性格定义、三层记忆系统(每日日志/长期记忆/MEMORY.md)、HEARTBEAT.md 主动任务、技能安装,以及安全配置和常见问题解决。2026/4/18教程OpenClaw 快速入门:用 Telegram 控制 AI Agent,5 分钟搭建个人 AI 助理OpenClaw 5 分钟快速入门:用 Telegram 控制 AI Agent,含安装配置、Bot 创建、Skills 定义、多渠道支持、Claude Code 编程任务集成,以及与 Claude Code CLI 的区别和互补关系。2026/4/13