---
read_when:
    - 运维或调试由 Gateway 网关启动的云端工作节点
    - 验证工作节点准入、会话分配或本地工具隔离
summary: 受限云端工作节点运行时内部操作员参考文档
title: 工作节点
x-i18n:
    generated_at: "2026-07-16T11:34:24Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 6591eb66c201a56e60638ce832c569b030d2d4a01b984d577e0ea44c10a0fa5e
    source_path: cli/worker.md
    workflow: 16
---

# `openclaw worker`

`openclaw worker` 是受限的运行时入口点，供云端工作节点编排器在准备好的工作节点环境中启动。它不是用于手动注册工作节点的通用命令。

Gateway 网关会安装匹配的 OpenClaw 软件包，并打开固定主机密钥的反向 SSH 隧道。工作节点启动器使用准备好的任务分配来启动此命令。该命令通过隧道转发的本地套接字进行连接，并以专用的 `worker` 角色准入。

## 启动契约

该命令从标准输入中读取且仅读取一个有界的 JSON 启动信封。该信封包含本地套接字位置、即时签发的工作节点凭据、软件包和协议标识、所有者纪元，以及唯一分配的会话和轮次。绝不通过命令行参数接受凭据，并且本页面特意不提供凭据或手写信封示例。

如果信封无效、凭据被拒绝、软件包或协议功能不匹配，或者会话和所有者纪元已不再是当前值，准入将以关闭方式失败。操作员应通过云端工作节点编排器启动工作节点，而不是直接调用此入口点。

## 运行时边界

该进程使用受限后端运行常规的嵌入式 Agent loop：

- `read`、`write`、`edit`、`apply_patch`、`exec` 和 `process` 编码工具在工作节点工作区中本地运行。
- 模型调用使用 Gateway 网关推理代理。不加载本地模型身份验证配置文件。
- 对话记录写入使用 Gateway 网关的对话记录提交 RPC。
- 流式传输和工具生命周期更新使用 Gateway 网关的实时事件 RPC。
- 仅接受已分配的会话和轮次。

工作节点模式不会启动渠道、Gateway HTTP 接口，也不会在已分配的会话工具集之外自动启动插件。它使用一次性状态目录，并且没有常驻的提供商或 Forge 凭据。

此模式不提供工作节点之间的会话分派。放置和分派仍归 Gateway 网关所有：操作员可以通过 Gateway 网关分派现有的本地托管工作树会话，而工作节点进程不能分派自身或其他工作节点。

准备好的任务分配包含对话记录上下文、已接受的基础叶节点、提交序列和实时事件游标。隧道重新连接时，进程使用相同的凭据和所有者纪元重新准入，保留已接受的对话记录基础，重放其未确认的实时事件尾部，并使用相同标识重新附加到进行中的推理轮次。如果流式增量发生遗漏，则终止推理消息具有权威性。后续接替的所有者纪元会隔离该进程，并使其正常退出。

`stale-base-leaf` 对话记录拒绝会使当前运行立即停止。工作节点模式不会针对不同的叶节点重试被拒绝的序列，因此不会产生重复提交；该次运行中仍未提交的内存尾部将会丢失。重新启动由里程碑 3 的放置所有者负责，该所有者必须根据 Gateway 网关中具有权威性的对话记录和提交账本创建新的任务分配。同样，Gateway 网关进程重启会以提供商错误终止待处理的推理轮次；只有隧道或工作节点 WebSocket 重新连接才能重新附加到同一活动进程中的推理流。

有关封闭的工作节点 RPC 接口，请参阅 [Gateway protocol](/zh-CN/gateway/protocol#worker-role-and-closed-protocol)；有关架构和安全模型，请参阅[云端工作节点计划](/zh-CN/plan/cloud-workers)。