mirror of
https://github.com/farcasclaudiu/openclaw.git
synced 2026-06-29 15:01:48 +03:00
Docs: normalize zh-CN terminology + tone
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
This commit is contained in:
@@ -2,9 +2,9 @@
|
||||
read_when:
|
||||
- 在没有 macOS UI 的情况下实现节点配对审批
|
||||
- 添加用于审批远程节点的 CLI 流程
|
||||
- 扩展 Gateway 协议以支持节点管理
|
||||
summary: Gateway 拥有的节点配对(方案 B),适用于 iOS 及其他远程节点
|
||||
title: Gateway 拥有的配对
|
||||
- 扩展 Gateway网关协议以支持节点管理
|
||||
summary: Gateway网关拥有的节点配对(方案 B),适用于 iOS 及其他远程节点
|
||||
title: Gateway网关拥有的配对
|
||||
x-i18n:
|
||||
generated_at: "2026-02-01T20:35:26Z"
|
||||
model: claude-opus-4-5
|
||||
@@ -14,9 +14,9 @@ x-i18n:
|
||||
workflow: 14
|
||||
---
|
||||
|
||||
# Gateway 拥有的配对(方案 B)
|
||||
# Gateway网关拥有的配对(方案 B)
|
||||
|
||||
在 Gateway 拥有的配对模式中,**Gateway** 是决定哪些节点允许加入的权威来源。UI(macOS 应用、未来的客户端)只是用于批准或拒绝待处理请求的前端。
|
||||
在 Gateway网关拥有的配对模式中,**Gateway网关** 是决定哪些节点允许加入的权威来源。UI(macOS 应用、未来的客户端)只是用于批准或拒绝待处理请求的前端。
|
||||
|
||||
**重要说明:**WS 节点在 `connect` 过程中使用**设备配对**(角色 `node`)。`node.pair.*` 是一个独立的配对存储,**不会**控制 WS 握手。只有显式调用 `node.pair.*` 的客户端才使用此流程。
|
||||
|
||||
@@ -24,14 +24,14 @@ x-i18n:
|
||||
|
||||
- **待处理请求**:节点请求加入,需要审批。
|
||||
- **已配对节点**:已批准的节点,带有已签发的认证令牌。
|
||||
- **传输层**:Gateway WS 端点转发请求但不决定成员资格。(旧版 TCP 桥接支持已弃用/移除。)
|
||||
- **传输层**:Gateway网关 WS 端点转发请求但不决定成员资格。(旧版 TCP 桥接支持已弃用/移除。)
|
||||
|
||||
## 配对工作原理
|
||||
|
||||
1. 节点连接到 Gateway WS 并请求配对。
|
||||
2. Gateway 存储一个**待处理请求**并发出 `node.pair.requested` 事件。
|
||||
1. 节点连接到 Gateway网关 WS 并请求配对。
|
||||
2. Gateway网关存储一个**待处理请求**并发出 `node.pair.requested` 事件。
|
||||
3. 你批准或拒绝该请求(通过 CLI 或 UI)。
|
||||
4. 批准后,Gateway 签发一个**新令牌**(重新配对时令牌会轮换)。
|
||||
4. 批准后,Gateway网关签发一个**新令牌**(重新配对时令牌会轮换)。
|
||||
5. 节点使用该令牌重新连接,此时即为"已配对"状态。
|
||||
|
||||
待处理请求会在 **5 分钟**后自动过期。
|
||||
@@ -48,7 +48,7 @@ openclaw nodes rename --node <id|name|ip> --name "Living Room iPad"
|
||||
|
||||
`nodes status` 显示已配对/已连接的节点及其能力。
|
||||
|
||||
## API 接口(Gateway 协议)
|
||||
## API 接口(Gateway网关协议)
|
||||
|
||||
事件:
|
||||
|
||||
@@ -74,13 +74,13 @@ openclaw nodes rename --node <id|name|ip> --name "Living Room iPad"
|
||||
macOS 应用可在以下条件满足时选择性地尝试**静默批准**:
|
||||
|
||||
- 请求标记为 `silent`,且
|
||||
- 应用能够使用同一用户验证与 Gateway 主机的 SSH 连接。
|
||||
- 应用能够使用同一用户验证与 Gateway网关主机的 SSH 连接。
|
||||
|
||||
如果静默批准失败,则回退到常规的"批准/拒绝"提示。
|
||||
|
||||
## 存储(本地,私有)
|
||||
|
||||
配对状态存储在 Gateway 状态目录下(默认 `~/.openclaw`):
|
||||
配对状态存储在 Gateway网关状态目录下(默认 `~/.openclaw`):
|
||||
|
||||
- `~/.openclaw/nodes/paired.json`
|
||||
- `~/.openclaw/nodes/pending.json`
|
||||
@@ -95,5 +95,5 @@ macOS 应用可在以下条件满足时选择性地尝试**静默批准**:
|
||||
## 传输层行为
|
||||
|
||||
- 传输层是**无状态的**;它不存储成员信息。
|
||||
- 如果 Gateway 离线或配对功能被禁用,节点无法配对。
|
||||
- 如果 Gateway 处于远程模式,配对仍然基于远程 Gateway 的存储进行。
|
||||
- 如果 Gateway网关离线或配对功能被禁用,节点无法配对。
|
||||
- 如果 Gateway网关处于远程模式,配对仍然基于远程 Gateway网关的存储进行。
|
||||
|
||||
Reference in New Issue
Block a user