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:
Josh Palmer
2026-02-02 15:46:45 +01:00
parent 2b1f68c928
commit 5676a6b38d
237 changed files with 2322 additions and 2337 deletions
+20 -23
View File
@@ -1,8 +1,8 @@
---
read_when:
- 你想通过浏览器操作 Gateway
- 你想通过浏览器操作 Gateway网关
- 你想通过 Tailnet 访问而无需 SSH 隧道
summary: 基于浏览器的 Gateway 控制界面(聊天、节点、配置)
summary: 基于浏览器的 Gateway网关控制界面(聊天、节点、配置)
title: 控制界面
x-i18n:
generated_at: "2026-02-01T21:44:27Z"
@@ -15,32 +15,31 @@ x-i18n:
# 控制界面(浏览器)
控制界面是一个由 Gateway 提供服务的小型 **Vite + Lit** 单页应用:
控制界面是一个由 Gateway网关提供服务的小型 **Vite + Lit** 单页应用:
- 默认地址:`http://<host>:18789/`
- 可选前缀:设置 `gateway.controlUi.basePath`(例如 `/openclaw`
它通过同一端口**直接与 Gateway WebSocket** 通信。
它通过同一端口**直接与 Gateway网关 WebSocket** 通信。
## 快速打开(本地)
如果 Gateway 在同一台计算机上运行,请打开:
如果 Gateway网关在这台计算机上运行,请打开:
- http://127.0.0.1:18789/(或 http://localhost:18789/
如果页面无法加载,请先启动 Gateway:`openclaw gateway`
如果页面无法加载,请先启动 Gateway网关`openclaw gateway`
认证在 WebSocket 握手期间通过以下方式提供:
- `connect.params.auth.token`
- `connect.params.auth.password`
仪表板设置面板允许你存储令牌;密码不会被持久化。
手引导向导默认会生成一个 Gateway 令牌,首次连接时请在此处粘贴。
手引导向导默认会生成一个 Gateway网关令牌,首次连接时请在此处粘贴。
## 设备配对(首次连接)
当你从新浏览器或设备连接到控制界面时,Gateway
需要进行**一次性配对审批** — 即使你在同一个 Tailnet 上且
当你从新浏览器或设备连接到控制界面时,Gateway网关需要进行**一次性配对审批** — 即使你在同一个 Tailnet 上且
设置了 `gateway.auth.allowTailscale: true`。这是一项防止
未授权访问的安全措施。
@@ -68,21 +67,21 @@ openclaw devices approve <requestId>
## 当前功能
- 通过 Gateway WS 与模型聊天(`chat.history``chat.send``chat.abort``chat.inject`
- 通过 Gateway网关 WS 与模型聊天(`chat.history``chat.send``chat.abort``chat.inject`
- 在聊天中流式传输工具调用 + 实时工具输出卡片(智能体事件)
- 渠道:WhatsApp/Telegram/Discord/Slack + 插件渠道(Mattermost 等)状态 + 二维码登录 + 每渠道配置(`channels.status``web.login.*``config.patch`
- 实例:在线列表 + 刷新(`system-presence`
- 会话:列表 + 每会话思考/详细模式覆盖(`sessions.list``sessions.patch`
- 定时任务:列表/添加/运行/启用/禁用 + 运行历史(`cron.*`
- 技能:状态、启用/禁用、安装、API 密钥更新(`skills.*`
- Skills:状态、启用/禁用、安装、API 密钥更新(`skills.*`
- 节点:列表 + 能力(`node.list`
- 执行审批:编辑 Gateway 或节点允许列表 + `exec host=gateway/node` 的询问策略(`exec.approvals.*`
- 执行审批:编辑 Gateway网关或节点允许列表 + `exec host=gateway/node` 的询问策略(`exec.approvals.*`
- 配置:查看/编辑 `~/.openclaw/openclaw.json``config.get``config.set`
- 配置:应用 + 带验证的重启(`config.apply`)并唤醒最后活跃的会话
- 配置写入包含基础哈希保护,防止覆盖并发编辑
- 配置模式 + 表单渲染(`config.schema`,包括插件 + 渠道模式);原始 JSON 编辑器仍然可用
- 调试:状态/健康/模型快照 + 事件日志 + 手动 RPC 调用(`status``health``models.list`
- 日志:实时跟踪 Gateway 文件日志,支持过滤/导出(`logs.tail`
- 日志:实时跟踪 Gateway网关文件日志,支持过滤/导出(`logs.tail`
- 更新:运行包/git 更新 + 重启(`update.run`)并附带重启报告
## 聊天行为
@@ -99,7 +98,7 @@ openclaw devices approve <requestId>
### 集成 Tailscale Serve(首选)
将 Gateway 保持在回环地址上,让 Tailscale Serve 通过 HTTPS 代理:
将 Gateway网关保持在 local loopback 上,让 Tailscale Serve 通过 HTTPS 代理:
```bash
openclaw gateway --tailscale serve
@@ -111,7 +110,7 @@ openclaw gateway --tailscale serve
默认情况下,当 `gateway.auth.allowTailscale``true` 时,Serve 请求可以通过 Tailscale 身份头
`tailscale-user-login`)进行认证。OpenClaw
通过使用 `tailscale whois` 解析 `x-forwarded-for` 地址并与头信息匹配来验证身份,且仅在请求通过带有 Tailscale `x-forwarded-*` 头的回环地址到达时才接受。如果你希望即使对 Serve 流量也要求令牌/密码,请设置
通过使用 `tailscale whois` 解析 `x-forwarded-for` 地址并与头信息匹配来验证身份,且仅在请求通过带有 Tailscale `x-forwarded-*` 头的 local loopback 到达时才接受。如果你希望即使对 Serve 流量也要求令牌/密码,请设置
`gateway.auth.allowTailscale: false`(或强制 `gateway.auth.mode: "password"`)。
### 绑定到 Tailnet + 令牌
@@ -135,7 +134,7 @@ OpenClaw **会阻止**没有设备身份的控制界面连接。
**推荐修复:**使用 HTTPSTailscale Serve)或在本地打开 UI
- `https://<magicdns>/`Serve
- `http://127.0.0.1:18789/`(在 Gateway 主机上)
- `http://127.0.0.1:18789/`(在 Gateway网关主机上)
**降级示例(仅令牌,通过 HTTP):**
@@ -156,7 +155,7 @@ OpenClaw **会阻止**没有设备身份的控制界面连接。
## 构建 UI
Gateway `dist/control-ui` 提供静态文件。使用以下命令构建:
Gateway网关`dist/control-ui` 提供静态文件。使用以下命令构建:
```bash
pnpm ui:build # 首次运行时自动安装 UI 依赖
@@ -174,12 +173,10 @@ OPENCLAW_CONTROL_UI_BASE_PATH=/openclaw/ pnpm ui:build
pnpm ui:dev # 首次运行时自动安装 UI 依赖
```
然后将 UI 指向你的 Gateway WS URL(例如 `ws://127.0.0.1:18789`)。
然后将 UI 指向你的 Gateway网关 WS URL(例如 `ws://127.0.0.1:18789`)。
## 调试/测试:开发服务器 + 远程 Gateway
控制界面是静态文件;WebSocket 目标可配置,可以
与 HTTP 源不同。当你想在本地使用 Vite 开发服务器但 Gateway 运行在其他地方时,这很方便。
## 调试/测试:开发服务器 + 远程 Gateway网关控制界面是静态文件;WebSocket 目标可配置,可以
与 HTTP 源不同。当你想在本地使用 Vite 开发服务器但 Gateway网关运行在其他地方时,这很方便。
1. 启动 UI 开发服务器:`pnpm ui:dev`
2. 打开类似以下的 URL
@@ -198,6 +195,6 @@ http://localhost:5173/?gatewayUrl=wss://<gateway-host>:18789&token=<gateway-toke
- `gatewayUrl` 在加载后存储到 localStorage 并从 URL 中移除。
- `token` 存储在 localStorage 中;`password` 仅保存在内存中。
- 当 Gateway 在 TLS 之后(Tailscale Serve、HTTPS 代理等)时使用 `wss://`
- 当 Gateway网关在 TLS 之后(Tailscale Serve、HTTPS 代理等)时使用 `wss://`
远程访问设置详情:[远程访问](/gateway/remote)。