5676a6b38d
What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style Tests: pnpm docs:build
116 lines
3.3 KiB
Markdown
116 lines
3.3 KiB
Markdown
---
|
||
read_when:
|
||
- 运行无头节点主机
|
||
- 为 system.run 配对非 macOS 节点
|
||
summary: "`openclaw node`（无头节点主机）的 CLI 参考"
|
||
title: node
|
||
x-i18n:
|
||
generated_at: "2026-02-01T20:21:18Z"
|
||
model: claude-opus-4-5
|
||
provider: pi
|
||
source_hash: a8b1a57712663e2285c9ecd306fe57d067eb3e6820d7d8aec650b41b022d995a
|
||
source_path: cli/node.md
|
||
workflow: 14
|
||
---
|
||
|
||
# `openclaw node`
|
||
|
||
运行一个**无头节点主机**，连接到 Gateway网关 WebSocket 并在本机上暴露
|
||
`system.run` / `system.which`。
|
||
|
||
## 为什么使用节点主机？
|
||
|
||
当你希望智能体**在网络中的其他机器上运行命令**，而无需在那些机器上安装完整的 macOS 伴侣应用时，可以使用节点主机。
|
||
|
||
常见用例：
|
||
|
||
- 在远程 Linux/Windows 机器上运行命令（构建服务器、实验室机器、NAS）。
|
||
- 在 Gateway网关上保持执行**沙箱隔离**，但将已批准的运行委派给其他主机。
|
||
- 为自动化或 CI 节点提供轻量级、无头的执行目标。
|
||
|
||
执行仍受**执行审批**和节点主机上的按智能体白名单保护，因此你可以保持命令访问的范围明确可控。
|
||
|
||
## 浏览器代理（零配置）
|
||
|
||
如果节点上的 `browser.enabled` 未被禁用，节点主机会自动通告浏览器代理。这使智能体无需额外配置即可在该节点上使用浏览器自动化。
|
||
|
||
如需在节点上禁用：
|
||
|
||
```json5
|
||
{
|
||
nodeHost: {
|
||
browserProxy: {
|
||
enabled: false,
|
||
},
|
||
},
|
||
}
|
||
```
|
||
|
||
## 前台运行
|
||
|
||
```bash
|
||
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>`：覆盖节点显示名称
|
||
|
||
## 服务（后台运行）
|
||
|
||
将无头节点主机安装为用户服务。
|
||
|
||
```bash
|
||
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`：如果已安装则重新安装/覆盖
|
||
|
||
管理服务：
|
||
|
||
```bash
|
||
openclaw node status
|
||
openclaw node stop
|
||
openclaw node restart
|
||
openclaw node uninstall
|
||
```
|
||
|
||
使用 `openclaw node run` 进行前台节点主机运行（无服务）。
|
||
|
||
服务命令支持 `--json` 以获取机器可读输出。
|
||
|
||
## 配对
|
||
|
||
首次连接会在 Gateway网关上创建一个待处理的节点配对请求。
|
||
通过以下方式批准：
|
||
|
||
```bash
|
||
openclaw nodes pending
|
||
openclaw nodes approve <requestId>
|
||
```
|
||
|
||
节点主机将其节点 ID、令牌、显示名称和 Gateway网关连接信息存储在
|
||
`~/.openclaw/node.json` 中。
|
||
|
||
## 执行审批
|
||
|
||
`system.run` 受本地执行审批控制：
|
||
|
||
- `~/.openclaw/exec-approvals.json`
|
||
- [执行审批](/tools/exec-approvals)
|
||
- `openclaw approvals --node <id|name|ip>`（从 Gateway网关编辑）
|