openclaw/docs/zh-CN/cli/node.md

read_when, summary, title, x-i18n

read_when	summary	title	x-i18n
运行无头节点主机 为 system.run 配对非 macOS 节点	`openclaw node`（无头节点主机）的 CLI 参考	node	generated_at model provider source_hash source_path workflow 2026-02-01T20:21:18Z claude-opus-4-5 pi a8b1a57712663e2285c9ecd306fe57d067eb3e6820d7d8aec650b41b022d995a cli/node.md 14

openclaw node

运行一个无头节点主机，连接到 Gateway WebSocket 并在本机上暴露 system.run / system.which。

为什么使用节点主机？

当你希望智能体在网络中的其他机器上运行命令，而无需在那些机器上安装完整的 macOS 伴侣应用时，可以使用节点主机。

常见用例：

• 在远程 Linux/Windows 机器上运行命令（构建服务器、实验室机器、NAS）。
• 在 Gateway 上保持执行沙箱化，但将已批准的运行委派给其他主机。
• 为自动化或 CI 节点提供轻量级、无头的执行目标。

执行仍受执行审批和节点主机上的按智能体白名单保护，因此你可以保持命令访问的范围明确可控。

浏览器代理（零配置）

如果节点上的 browser.enabled 未被禁用，节点主机会自动通告浏览器代理。这使智能体无需额外配置即可在该节点上使用浏览器自动化。

如需在节点上禁用：

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

前台运行

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

选项：

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

服务（后台运行）

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

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

选项：

• --host <host>：Gateway WebSocket 主机（默认：127.0.0.1）
• --port <port>：Gateway WebSocket 端口（默认：18789）
• --tls：为 Gateway 连接使用 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 以获取机器可读输出。

配对

首次连接会在 Gateway 上创建一个待处理的节点配对请求。 通过以下方式批准：

openclaw nodes pending
openclaw nodes approve <requestId>

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

执行审批

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

• ~/.openclaw/exec-approvals.json
• 执行审批
• openclaw approvals --node <id|name|ip>（从 Gateway 编辑）