openclaw node

运行连接到网�?WebSocket 并在此机器上暴露 system.run / system.which �?无头节点主机*�?

为什么使用节点主机？

当你想让智能体在网络中的**其他机器上运行命�?*而不需要安装完整的 macOS 伴侣应用时，可以使用节点主机�?

常见用例�?

• 在远�?Linux/Windows 机器上运行命令（构建服务器、实验室机器、NAS）�?
• �?exec **沙盒�?*在网关上，但将批准的运行委托给其他主机�?
• 为自动化�?CI 节点提供轻量级、无头的执行目标�?

执行仍然由节点主机上�?*执行审批**和每个智能体允许列表保护，因此你可以保持命令访问范围明确�?

浏览器代理（零配置）

如果节点上未禁用 browser.enabled，节点主机会自动宣传浏览器代理。这允许智能体在该节点上使用浏览器自动化，无需额外配置�?

如需要，在节点上禁用它：

{
  nodeHost: {
    browserProxy: {
      enabled: false,
    },
  },
}

运行（前台）

openclaw node run --host <gateway-host> --port 18789

选项�?

• --host <host>：网�?WebSocket 主机（默认：127.0.0.1�?
• --port <port>：网�?WebSocket 端口（默认：18789�?
• --tls：为网关连接使用 TLS
• --tls-fingerprint <sha256>：预期的 TLS 证书指纹（sha256�?
• --node-id <id>：覆盖节�?ID（清除配对令牌）
• --display-name <name>：覆盖节点显示名�?

服务（后台）

将无头节点主机安装为用户服务�?

openclaw node install --host <gateway-host> --port 18789

选项�?

• --host <host>：网�?WebSocket 主机（默认：127.0.0.1�?
• --port <port>：网�?WebSocket 端口（默认：18789�?
• --tls：为网关连接使用 TLS
• --tls-fingerprint <sha256>：预期的 TLS 证书指纹（sha256�?
• --node-id <id>：覆盖节�?ID（清除配对令牌）
• --display-name <name>：覆盖节点显示名�?
• --runtime <runtime>：服务运行时（node �?bun�?
• --force：如果已安装则重新安�?覆盖

管理服务�?

openclaw node status
openclaw node stop
openclaw node restart
openclaw node uninstall

使用 openclaw node run 运行前台节点主机（无服务）�?

服务命令接受 --json 以获取机器可读输出�?

配对

首次连接会在网关上创建待处理的节点配对请求。通过以下方式批准�?

openclaw nodes pending
openclaw nodes approve <requestId>

节点主机将其节点 ID、令牌、显示名称和网关连接信息存储�?~/.openclaw/node.json 中�?

执行审批

system.run 受本地执行审批限制：

• ~/.openclaw/exec-approvals.json
• Exec approvals
• openclaw approvals --node <id|name|ip>（从网关编辑�?