mirror of
https://github.com/openclaw/openclaw.git
synced 2026-02-19 18:39:20 -05:00
a3ec2d0734
What: - update zh-CN glossary, TM, and translator prompt - regenerate zh-CN docs and apply targeted fixes - add zh-CN AGENTS pipeline guidance Why: - address terminology/spacing feedback from #6995 Tests: - pnpm build && pnpm check && pnpm test
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-03T07:45:07Z"
|
||
model: claude-opus-4-5
|
||
provider: pi
|
||
source_hash: a8b1a57712663e2285c9ecd306fe57d067eb3e6820d7d8aec650b41b022d995a
|
||
source_path: cli/node.md
|
||
workflow: 15
|
||
---
|
||
|
||
# `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（清除配对 token）
|
||
- `--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（清除配对 token）
|
||
- `--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、token、显示名称和 Gateway 网关连接信息存储在
|
||
`~/.openclaw/node.json` 中。
|
||
|
||
## 执行批准
|
||
|
||
`system.run` 受本地执行批准限制：
|
||
|
||
- `~/.openclaw/exec-approvals.json`
|
||
- [执行批准](/tools/exec-approvals)
|
||
- `openclaw approvals --node <id|name|ip>`（从 Gateway 网关编辑）
|