github/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-05-03 03:48:22 +00:00
Code Issues Packages Projects Releases Wiki Activity

Docs: normalize zh-CN terminology + tone

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files

36
docs/zh-CN/tools/chrome-extension.md
View File

@@ -1,7 +1,7 @@
---
read_when:
- 你想让智能体控制现有的 Chrome 标签页（工具栏按钮）
- 你需要通过 Tailscale 实现远程 Gateway + 本地浏览器自动化
- 你需要通过 Tailscale 实现远程 Gateway网关 + 本地浏览器自动化
- 你想了解浏览器接管的安全影响
summary: Chrome 扩展：让 OpenClaw 控制你现有的 Chrome 标签页
title: Chrome 扩展
@@ -24,8 +24,8 @@ OpenClaw Chrome 扩展让智能体控制你**现有的 Chrome 标签页**（你
包含三个部分：
- **浏览器控制服务**（Gateway 或节点）：智能体/工具调用的 API（通过 Gateway）
- **本地中继服务器**（回环 CDP）：在控制服务和扩展之间建立桥接（默认 `http://127.0.0.1:18792`）
- **浏览器控制服务**（Gateway网关或节点）：智能体/工具调用的 API（通过 Gateway网关）
- **本地中继服务器**（local loopback CDP）：在控制服务和扩展之间建立桥接（默认 `http://127.0.0.1:18792`）
- **Chrome MV3 扩展**：使用 `chrome.debugger` 附加到活动标签页，并将 CDP 消息传递给中继
OpenClaw 随后通过常规的 `browser` 工具界面（选择正确的配置文件）控制附加的标签页。
@@ -100,34 +100,34 @@ openclaw browser create-profile \
如果你看到 `!`：
- 确保 Gateway 在本地运行（默认设置），或者如果 Gateway 在其他地方运行，请在本机运行一个节点主机。
- 确保 Gateway网关在本地运行（默认设置），或者如果 Gateway网关在其他地方运行，请在本机运行一个节点主机。
- 打开扩展选项页面；它会显示中继是否可达。
## 远程 Gateway（使用节点主机）
## 远程 Gateway网关（使用节点主机）
### 本地 Gateway（与 Chrome 在同一台机器上）——通常**无需额外步骤**
### 本地 Gateway网关（与 Chrome 在同一台机器上）——通常**无需额外步骤**
如果 Gateway 与 Chrome 在同一台机器上运行，它会在回环地址上启动浏览器控制服务
并自动启动中继服务器。扩展与本地中继通信；CLI/工具调用发送到 Gateway。
如果 Gateway网关与 Chrome 在同一台机器上运行，它会在 local loopback 上启动浏览器控制服务
并自动启动中继服务器。扩展与本地中继通信；CLI/工具调用发送到 Gateway网关。
### 远程 Gateway（Gateway 在其他机器上运行）——**运行一个节点主机**
### 远程 Gateway网关（Gateway网关在其他机器上运行）——**运行一个节点主机**
如果你的 Gateway 在另一台机器上运行，请在运行 Chrome 的机器上启动一个节点主机。
Gateway 会将浏览器操作代理到该节点；扩展 + 中继保持在浏览器所在机器的本地。
如果你的 Gateway网关在另一台机器上运行，请在运行 Chrome 的机器上启动一个节点主机。
Gateway网关会将浏览器操作代理到该节点；扩展 + 中继保持在浏览器所在机器的本地。
如果连接了多个节点，使用 `gateway.nodes.browser.node` 固定一个节点，或设置 `gateway.nodes.browser.mode`。
## 沙箱化（工具容器）
## 沙箱隔离（工具容器）
如果你的智能体会话是沙箱化的（`agents.defaults.sandbox.mode != "off"`），`browser` 工具可能会受到限制：
如果你的智能体会话是沙箱隔离的（`agents.defaults.sandbox.mode != "off"`），`browser` 工具可能会受到限制：
- 默认情况下，沙箱化会话通常指向**沙箱浏览器**（`target="sandbox"`），而非你的宿主机 Chrome。
- 默认情况下，沙箱隔离会话通常指向**沙箱浏览器**（`target="sandbox"`），而非你的宿主机 Chrome。
- Chrome 扩展中继接管需要控制**宿主机**的浏览器控制服务。
选项：
- 最简单：从**非沙箱化**的会话/智能体使用扩展。
- 或允许沙箱化会话控制宿主机浏览器：
- 最简单：从**非沙箱隔离**的会话/智能体使用扩展。
- 或允许沙箱隔离会话控制宿主机浏览器：
```json5
{
@@ -149,7 +149,7 @@ Gateway 会将浏览器操作代理到该节点；扩展 + 中继保持在浏览
## 远程访问提示
- 将 Gateway 和节点主机保持在同一个 tailnet 上；避免将中继端口暴露到局域网或公网。
- 将 Gateway网关和节点主机保持在同一个 tailnet 上；避免将中继端口暴露到局域网或公网。
- 有意识地配对节点；如果你不需要远程控制，请禁用浏览器代理路由（`gateway.nodes.browser.mode="off"`）。
## "extension path" 的工作原理
@@ -174,7 +174,7 @@ CLI 故意**不会**打印 `node_modules` 路径。请始终先运行 `openclaw
建议：
- 优先使用专用的 Chrome 配置文件（与个人浏览分开）进行扩展中继使用。
- 将 Gateway 和所有节点主机保持在仅限 tailnet 的环境中；依赖 Gateway 认证 + 节点配对。
- 将 Gateway网关和所有节点主机保持在仅限 tailnet 的环境中；依赖 Gateway网关认证 + 节点配对。
- 避免在局域网（`0.0.0.0`）上暴露中继端口，也避免使用 Funnel（公网）。
- 中继会阻止非扩展来源，并要求 CDP 客户端提供内部认证令牌。