X 文章 · 原文写于 2026.03。下文保留当时的记录,工具版本与价格以当前官方信息为准

原题:手把手带你玩转OpenClaw node

查看 X 原文 ↗

本文分享使用openclaw node 模式相关实操。介绍其概念、配置方式以及使用场景,希望对您有所帮助

一、OpenClaw node 概念

官方解释:节点是一个伴随设备(macOS/iOS/Android/无头设备),它以 role: “node” 连接到网关 WebSocket (与操作员使用相同的端口),并通过 node.invoke 公开命令界面(例如 canvas.* 、 camera.* 、 device.* 、 notifications.* 、 system.* )。

说人话:就是龙虾作为控制中心可以控制的各种设备都可以叫做node。这些node通过ws 与 OpenClaw Gateway连接,使得Gateway里的龙虾可以控制设备执行特定任务

我们来具体举几个例子大家就清楚了

二、场景示例

Node 是一个轻量级的执行代理,它向 Gateway 注册自己的身份和能力,接收来自 Gateway 的指令,并在本地环境中执行这些指令后将结果返回。这种架构使得 OpenClaw 能够突破单一设备的限制,构建真正的分布式 AI 系统。

Node 可以运行在任何支持的设备上,包括桌面电脑、移动设备甚至嵌入式系统

设备控制能力:Node 可以执行摄像头拍照(camera snap/clip)、屏幕录制(screen record)、获取地理位置(location.get)以及发送系统通知(notifications)。这些能力使 AI 助手能够感知和操作物理世界。

2.1 跨设备协同

如图:岚叔的龙虾(gateway)部署在vps上,然后我将mac电脑与龙虾配队后,就可以实现vps 控制mac的效果,从而实现随时随地通过手机操作mac的能力,是不是很好玩😊

原文配图 1

附一张我的叼龙虾想要通过node搞我的idea😂简直是丧心病狂:

原文配图 2

当然,这也说明这种模式下还是有很多好玩的场景值得探索。当然除了控制电脑,还可以控制你的其他设备,只要这些设备有跑Gateway的龙虾配对即可

还有一个场景设想:一个家庭自动化场景:在门口的树莓派上运行 Node 连接摄像头,当检测到有人按门铃时,Node 拍摄照片并通过 Gateway 发送到你的 Telegram,你可以回复 “开门” 或 “告诉他我不在家”,AI 助手会相应地控制门锁或播放预录的语音消息。

2.2 企业级案例设想

岚叔有相关未来各种服务器,不是装gateway,而是跑openclaw node 模式即可,会有几台服务器集中化部署gateway,然后通过node接管所有服务器。这样既实现了openclaw 运维所有服务器的设想,同时操控各种类型的服务器,快速实现一套企业级的IT环境

三、配置

我们以mac 电脑与vps 上的openclaw gateway 配对为例

  • 首先大家可以确认一个事情:那就是谁跑了gateway 谁就是控制端,谁就是中心

openclaw gateway 就是我们现在小龙虾安装部署的玩法,以及有很多教程了这里不再赘述,感兴趣的可以参考之前的文章:

本文只讲mac 电脑起node 模式及配置

3.1 mac 安装openclaw 二进制文件

注意这一步仅安装二进制文件,不用完整配置,更不需要启动gateway

安全性上来说,只会使你的mac与vps连接,风险可控

npm install -g openclaw@latest
# 或使用 pnpm
pnpm add -g openclaw@latest

3.2 mac 上启动node模式

这里补充说明一下: 如果你的vps gateway bind的是loopback 模式(也是推荐的模式),那么你的gateway 默认是其他服务无法直接访问的,最方便的方式就是通过ssh隧道的方式端口转发一下,配置如下:

注意需要替换自己gateway 的ip ,vps ssh密钥文件,以及gateway端口

#1. 开通隧道
ssh root@<你的龙虾gateway IP地址>  -i ~xxx/xxx.pem -N -L 18790:127.0.0.1:18800
#说明: - i xxx 表示使用密钥文件等了机器,将远程的gateway端口,比如18800 映射到本地的18790 (端口号可以自己制定)

#2. 启动node 模式
# edit mac 配置文件
.openclaw/exec-approvals.json

{
  "version": 1,
  "socket": {
    "path": "~/.openclaw/exec-approvals.sock",
    "token": "your_gateway_token”
  },
  "defaults": {
    "security": "full",
    "ask": "off",
    "askFallback": "full"
  },
  "agents": {}
}

openclaw node run --host 127.0.0.1 --port 18790 --display-name "lanshu-Mac-Node"

网络打通还有一种安全的方式:就是走tailscale 方式,总之就是要使你的设备能连上你的openclaw gateway 端口

更精细化的权限控制可以参考如下配置:

# Allowlist the commands  将命令列入允许列表
# Exec approvals are per node host. Add allowlist entries from the #gateway:
#执行审批是按节点主机进行的。从网关添加允许列表条目:
 # 复制
openclaw approvals allowlist add --node <id|name|ip> "/usr/bin/uname"
openclaw approvals allowlist add --node <id|name|ip> "/usr/bin/sw_vers"
Approvals live on the node host at ~/.openclaw/exec-approvals.json.
审批信息存储在节点主机 ~/.openclaw/exec-approvals.json 上。

3.3 gateway 授权

openclaw devices list
openclaw devices approve <requestId>

查看配对情况: openclaw nodes status

原文配图 3

status: connected 表明配对成功了!

然后直接在聊天软件里问龙虾就可以了,它也可以告诉你一句配对成功了

原文配图 4 原文配图 5

如截图,龙虾让查一下mac明日日程,非常方便!当然也可以写日程等相关操作,等待朋友们挖掘

Node 使 AI 助手能够真正融入用户的数字生活和物理环境。随着 AI 能力的不断增强和边缘计算的普及,我们可以预见 Node 类架构将在更多场景中发挥作用:从智能家居到工业自动化,从个人生产力工具到企业级 AI 基础设施。

期待朋友们的探索和点赞💗

✳感谢阅读。下次做点新的,再来分享