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
2026-06-29 09:02:02 +03:00 · 2026-02-02 15:46:45 +01:00
parent 2b1f68c928
commit 5676a6b38d
237 changed files with 2322 additions and 2337 deletions
@@ -1,9 +1,9 @@
 ---
 read_when:
  - 从零开始的首次设置
-  - 您希望找到从安装 → 上手引导 → 发送第一条消息的最快路径
-summary: 新手指南：从零开始到发送第一条消息（向导、认证、渠道、配对）
-title: 快速入门
+  - 你希望找到从安装 → 新手引导 → 发送第一条消息的最快路径
+summary: 入门指南：从零开始到发送第一条消息（向导、认证、渠道、配对）
+title: 入门指南
 x-i18n:
  generated_at: "2026-02-01T13:38:44Z"
  model: claude-opus-4-5
@@ -13,26 +13,26 @@ x-i18n:
  workflow: 9
 ---

-# 快速入门
+# 入门指南

 目标：从 **零开始** → **第一次成功聊天** （使用合理的默认配置）尽可能快地完成。

 最快聊天方式：打开控制界面（无需设置渠道）。运行 `openclaw dashboard`
-然后在浏览器中聊天，或打开 `http://127.0.0.1:18789/` （在 Gateway 主机上）。
+然后在浏览器中聊天，或打开 `http://127.0.0.1:18789/` （在 Gateway网关主机上）。
 文档： [仪表盘](/web/dashboard) 和 [控制界面](/web/control-ui)。

-推荐路径：使用 **CLI 上手引导向导** （`openclaw onboard`）。它会设置：
+推荐路径：使用 **CLI 新手引导向导** （`openclaw onboard`）。它会设置：

 - 模型/认证（推荐使用 OAuth）
- Gateway 设置
+- Gateway网关设置
 - 渠道（WhatsApp/Telegram/Discord/Mattermost（插件）/...）
 - 配对默认设置（安全私信）
- 工作区引导 + 技能
+- 工作区引导 + Skills
 - 可选的后台服务

-如果您需要更详细的参考页面，请跳转至： [向导](/start/wizard), [设置](/start/setup), [配对](/start/pairing), [安全](/gateway/security)。
+如果你需要更详细的参考页面，请跳转至： [向导](/start/wizard), [设置](/start/setup), [配对](/start/pairing), [安全](/gateway/security)。

-沙箱注意事项： `agents.defaults.sandbox.mode: "non-main"` 使用 `session.mainKey` （默认 `"main"`），因此群组/渠道会话是沙箱化的。如果您希望主智能体始终在主机上运行，请设置显式的逐智能体覆盖：
+沙盒注意事项： `agents.defaults.sandbox.mode: "non-main"` 使用 `session.mainKey` （默认 `"main"`），因此群组/渠道会话是沙箱隔离的。如果你希望主智能体始终在主机上运行，请设置显式的逐智能体覆盖：

 ```json
 {
@@ -55,7 +55,7 @@ x-i18n:
  `openclaw configure --section web` （存储 `tools.web.search.apiKey`）。
  参见 [网络工具](/tools/web)。

-macOS：如果您计划构建应用程序，请安装 Xcode / CLT。如果仅使用 CLI + Gateway，Node 就足够了。
+macOS：如果你计划构建应用程序，请安装 Xcode / CLT。如果仅使用 CLI + Gateway网关，Node 就足够了。
 Windows：使用 **WSL2** （推荐 Ubuntu）。强烈推荐使用 WSL2；原生 Windows 未经测试，问题较多，且工具兼容性较差。请先安装 WSL2，然后在 WSL 内执行 Linux 步骤。参见 [Windows (WSL2)](/platforms/windows)。

 ## 1）安装 CLI（推荐）
@@ -82,35 +82,33 @@ npm install -g openclaw@latest
 pnpm add -g openclaw@latest
 ```

-## 2）运行上手引导向导（并安装服务）
+## 2）运行新手引导向导（并安装服务）

 ```bash
 openclaw onboard --install-daemon
 ```

-您需要选择的内容：
+你需要选择的内容：

- **本地 vs 远程** Gateway
+- **本地 vs 远程** Gateway网关
 - **认证**：OpenAI Code (Codex) 订阅（OAuth）或 API 密钥。对于 Anthropic，我们推荐使用 API 密钥； `claude setup-token` 也受支持。
 - **提供商**：WhatsApp 二维码登录、Telegram/Discord 机器人令牌、Mattermost 插件令牌等。
 - **守护进程**：后台安装（launchd/systemd；WSL2 使用 systemd）
  - **运行时**：Node（推荐；WhatsApp/Telegram 必需）。Bun 为 **不推荐**。
- **Gateway 令牌**：向导默认会生成一个（即使在回环地址上）并将其存储在 `gateway.auth.token`。
+- **Gateway网关令牌**：向导默认会生成一个（即使在 local loopback 上）并将其存储在 `gateway.auth.token`。

 向导文档： [向导](/start/wizard)

-### 认证：存储位置（重要）
+### 凭证：存储位置（重要）

- **推荐的 Anthropic 路径：** 设置 API 密钥（向导可以将其存储以供服务使用）。 `claude setup-token` 如果您想复用 Claude Code 凭据，也受支持。
+- **推荐的 Anthropic 路径：** 设置 API 密钥（向导可以将其存储以供服务使用）。 `claude setup-token`：你可以复用 Claude Code 凭据。

 - OAuth 凭据（旧版导入）： `~/.openclaw/credentials/oauth.json`
 - 认证配置文件（OAuth + API 密钥）： `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`

-无头/服务器提示：先在普通机器上完成 OAuth，然后复制 `oauth.json` 到 Gateway 主机上。
+无头/服务器提示：先在普通机器上完成 OAuth，然后复制 `oauth.json` 到 Gateway网关主机上。

-## 3）启动 Gateway
-
-如果您在上手引导过程中安装了服务，Gateway 应该已经在运行：
+## 3）启动 Gateway网关如果你在新手引导过程中安装了服务，Gateway网关应该已经在运行：

 ```bash
 openclaw gateway status
@@ -122,10 +120,10 @@ openclaw gateway status
 openclaw gateway --port 18789 --verbose
 ```

-仪表盘（本地回环）： `http://127.0.0.1:18789/`
+仪表盘（本地 local loopback）： `http://127.0.0.1:18789/`
 如果配置了令牌，请将其粘贴到控制界面设置中（存储为 `connect.params.auth.token`）。

-⚠️ **Bun 警告（WhatsApp + Telegram）：** Bun 在这些渠道上存在已知问题。如果您使用 WhatsApp 或 Telegram，请使用 **Node **。
+⚠️ **Bun 警告（WhatsApp + Telegram）：** Bun 在这些渠道上存在已知问题。如果你使用 WhatsApp 或 Telegram，请使用 **Node **。

 ## 3.5）快速验证（2 分钟）

@@ -135,7 +133,7 @@ openclaw health
 openclaw security audit --deep
 ```

-## 4）配对 + 连接您的第一个聊天界面
+## 4）配对 + 连接你的第一个聊天界面

 ### WhatsApp（二维码登录）

@@ -149,18 +147,18 @@ WhatsApp 文档： [WhatsApp](/channels/whatsapp)

 ### Telegram / Discord / 其他

-向导可以为您写入令牌/配置。如果您更喜欢手动配置，请从以下内容开始：
+向导可以为你写入令牌/配置。如果你更喜欢手动配置，请从以下内容开始：

 - Telegram： [Telegram](/channels/telegram)
 - Discord： [Discord](/channels/discord)
 - Mattermost（插件）： [Mattermost](/channels/mattermost)

-**Telegram 私信提示：** 您的第一条私信会返回一个配对码。请批准它（参见下一步），否则机器人将不会响应。
+**Telegram 私信提示：** 你的第一条私信会返回一个配对码。请批准它（参见下一步），否则机器人将不会响应。

 ## 5）私信安全（配对审批）

 默认策略：未知私信会收到一个短码，消息在批准之前不会被处理。
-如果您的第一条私信没有收到回复，请批准配对：
+如果你的第一条私信没有收到回复，请批准配对：

 ```bash
 openclaw pairing list whatsapp
@@ -171,7 +169,7 @@ openclaw pairing approve whatsapp <code>

 ## 从源码安装（开发）

-如果您正在开发 OpenClaw 本身，请从源码运行：
+如果你正在开发 OpenClaw 本身，请从源码运行：

 ```bash
 git clone https://github.com/openclaw/openclaw.git
@@ -182,10 +180,10 @@ pnpm build
 openclaw onboard --install-daemon
 ```

-如果您尚未进行全局安装，请通过以下方式运行上手引导步骤 `pnpm openclaw ...` （从仓库中）。
-`pnpm build` 也会打包 A2UI 资源；如果您只需要运行该步骤，请使用 `pnpm canvas:a2ui:bundle`。
+如果你尚未进行全局安装，请通过以下方式运行新手引导流程 `pnpm openclaw ...` （从仓库中）。
+`pnpm build` 也会打包 A2UI 资源；如果你只需要运行该步骤，请使用 `pnpm canvas:a2ui:bundle`。

-Gateway（从此仓库）：
+Gateway网关（从此仓库）：

 ```bash
 node openclaw.mjs gateway --port 18789 --verbose
@@ -202,7 +200,7 @@ openclaw message send --target +15555550123 --message "Hello from OpenClaw"
 如果 `openclaw health` 显示"未配置认证"，请返回向导设置 OAuth/密钥认证——智能体在没有认证的情况下将无法响应。

 提示： `openclaw status --all` 是最佳的可粘贴只读调试报告。
-健康探针： `openclaw health` （或 `openclaw status --deep`）向运行中的 Gateway 请求健康快照。
+健康探针： `openclaw health` （或 `openclaw status --deep`）向运行中的 Gateway网关请求健康快照。

 ## 后续步骤（可选，但强烈推荐）

@@ -19,11 +19,11 @@ x-i18n:
 ## 从这里开始

 - [索引](/)
- [快速入门](/start/getting-started)
- [上手引导](/start/onboarding)
+- [入门指南](/start/getting-started)
+- [新手引导](/start/onboarding)
 - [向导](/start/wizard)
 - [设置](/start/setup)
- [仪表盘（本地 Gateway）](http://127.0.0.1:18789/)
+- [仪表盘（本地 Gateway网关）](http://127.0.0.1:18789/)
 - [帮助](/help)
 - [配置](/gateway/configuration)
 - [配置示例](/gateway/configuration-examples)
@@ -84,11 +84,11 @@ x-i18n:
 - [Webhooks](/automation/webhook)
 - [Gmail Pub/Sub](/automation/gmail-pubsub)

-## Gateway + 运维
+## Gateway网关 + 运维

- [Gateway 运行手册](/gateway)
- [Gateway 配对](/gateway/pairing)
- [Gateway 锁](/gateway/gateway-lock)
+- [Gateway网关运行手册](/gateway)
+- [Gateway网关配对](/gateway/pairing)
+- [Gateway网关锁](/gateway/gateway-lock)
 - [后台进程](/gateway/background-process)
 - [健康检查](/gateway/health)
 - [心跳](/gateway/heartbeat)
@@ -98,7 +98,7 @@ x-i18n:
 - [仪表盘](/web/dashboard)
 - [控制界面](/web/control-ui)
 - [远程访问](/gateway/remote)
- [远程 Gateway README](/gateway/remote-gateway-readme)
+- [远程 Gateway网关 README](/gateway/remote-gateway-readme)
 - [Tailscale](/gateway/tailscale)
 - [安全](/gateway/security)
 - [故障排除](/gateway/troubleshooting)
@@ -157,16 +157,16 @@ x-i18n:
 - [macOS 远程](/platforms/mac/remote)
 - [macOS 签名](/platforms/mac/signing)
 - [macOS 发布](/platforms/mac/release)
- [macOS Gateway (launchd)](/platforms/mac/bundled-gateway)
+- [macOS Gateway网关 (launchd)](/platforms/mac/bundled-gateway)
 - [macOS XPC](/platforms/mac/xpc)
- [macOS 技能](/platforms/mac/skills)
+- [macOS Skills](/platforms/mac/skills)
 - [macOS Peekaboo](/platforms/mac/peekaboo)

 ## 工作区 + 模板

- [技能](/tools/skills)
+- [Skills](/tools/skills)
 - [ClawHub](/tools/clawhub)
- [技能配置](/tools/skills-config)
+- [Skills配置](/tools/skills-config)
 - [默认 AGENTS](/reference/AGENTS.default)
 - [模板：AGENTS](/reference/templates/AGENTS)
 - [模板：BOOTSTRAP](/reference/templates/BOOTSTRAP)
@@ -178,7 +178,7 @@ x-i18n:

 ## 实验（探索性）

- [上手引导配置协议](/experiments/onboarding-config-protocol)
+- [新手引导配置协议](/experiments/onboarding-config-protocol)
 - [定时任务加固笔记](/experiments/plans/cron-add-hardening)
 - [群组策略加固笔记](/experiments/plans/group-policy-hardening)
 - [研究：记忆](/experiments/research/memory)
@@ -18,7 +18,7 @@ _一个关于龙虾、蜕壳和过多 token 的故事。_

 ## 起源故事

-最初，有一个叫 **Warelay** 的东西——一个给 WhatsApp Gateway 起的合理名字。它做好了自己的工作，还不错。
+最初，有一个叫 **Warelay** 的东西——一个给 WhatsApp Gateway网关起的合理名字。它做好了自己的工作，还不错。

 但后来，出现了一只太空龙虾。

@@ -1,9 +1,9 @@
 ---
 read_when:
-  - 设计 macOS 上手引导助手
+  - 设计 macOS 新手引导助手
  - 实现认证或身份设置
-summary: OpenClaw 首次运行上手引导流程（macOS 应用）
-title: 上手引导
+summary: OpenClaw 首次运行新手引导流程（macOS 应用）
+title: 新手引导
 x-i18n:
  generated_at: "2026-02-01T21:38:45Z"
  model: claude-opus-4-5
@@ -13,16 +13,16 @@ x-i18n:
  workflow: 15
 ---

-# 上手引导（macOS 应用）
+# 新手引导（macOS 应用）

-本文档描述了**当前**的首次运行上手引导流程。目标是打造流畅的"第 0 天"体验：选择 Gateway 运行位置、连接认证、运行向导，然后让智能体自行完成引导。
+本文档描述了**当前**的首次运行新手引导流程。目标是打造流畅的"第 0 天"体验：选择 Gateway网关运行位置、连接认证、运行向导，然后让智能体自行完成引导。

 ## 页面顺序（当前）

 1. 欢迎 + 安全提示
-2. **Gateway 选择**（本地 / 远程 / 稍后配置）
+2. **Gateway网关选择**（本地 / 远程 / 稍后配置）
 3. **认证（Anthropic OAuth）** — 仅限本地
-4. **设置向导**（Gateway 驱动）
+4. **设置向导**（Gateway网关驱动）
 5. **权限**（TCC 提示）
 6. **CLI**（可选）
 7. **引导聊天**（专用会话）
@@ -34,17 +34,17 @@ x-i18n:

 ## 2) 本地 vs 远程

-**Gateway** 在哪里运行？
+**Gateway网关** 在哪里运行？

- **本地（本机 Mac）：** 上手引导可以运行 OAuth 流程并在本地写入凭据。
- **远程（通过 SSH/Tailnet）：** 上手引导**不会**在本地运行 OAuth；凭据必须存在于 Gateway 主机上。
+- **本地（本机 Mac）：** 新手引导可以运行 OAuth 流程并在本地写入凭据。
+- **远程（通过 SSH/Tailnet）：** 新手引导**不会**在本地运行 OAuth；凭据必须存在于 Gateway网关主机上。
 - **稍后配置：** 跳过设置，保持应用未配置状态。

-Gateway 认证提示：
+Gateway网关认证提示：

- 向导现在即使对回环地址也会生成**令牌**，因此本地 WS 客户端必须进行认证。
+- 向导现在即使对 local loopback 也会生成**令牌**，因此本地 WS 客户端必须进行认证。
 - 如果禁用认证，任何本地进程都可以连接；仅在完全可信的机器上使用此选项。
- 对于多机访问或非回环地址绑定，请使用**令牌**。
+- 对于多机访问或非 local loopback 绑定，请使用**令牌**。

 ## 3) 仅限本地的认证（Anthropic OAuth）

@@ -56,13 +56,13 @@ macOS 应用支持 Anthropic OAuth（Claude Pro/Max）。流程如下：

 其他提供商（OpenAI、自定义 API）目前通过环境变量或配置文件进行配置。

-## 4) 设置向导（Gateway 驱动）
+## 4) 设置向导（Gateway网关驱动）

-应用可以运行与 CLI 相同的设置向导。这使上手引导与 Gateway 端的行为保持同步，避免在 SwiftUI 中重复逻辑。
+应用可以运行与 CLI 相同的设置向导。这使新手引导与 Gateway网关端的行为保持同步，避免在 SwiftUI 中重复逻辑。

 ## 5) 权限

-上手引导会请求以下所需的 TCC 权限：
+新手引导会请求以下所需的 TCC 权限：

 - 通知
 - 辅助功能
@@ -99,7 +99,7 @@ openclaw webhooks gmail setup --account you@gmail.com

 ## 远程模式说明

-当 Gateway 在另一台机器上运行时，凭据和工作区文件位于**该主机上**。如果你需要在远程模式下使用 OAuth，请在 Gateway 主机上创建：
+当 Gateway网关在另一台机器上运行时，凭据和工作区文件位于**该主机上**。如果你需要在远程模式下使用 OAuth，请在 Gateway网关主机上创建：

 - `~/.openclaw/credentials/oauth.json`
 - `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
@@ -1,6 +1,6 @@
 ---
 read_when:
-  - 上手引导新的助手实例
+  - 新手引导新的助手实例
  - 审查安全/权限影响
 summary: 将 OpenClaw 作为个人助手运行的端到端指南，包含安全注意事项
 title: 个人助手设置
@@ -15,7 +15,7 @@ x-i18n:

 # 使用 OpenClaw 构建个人助手

-OpenClaw 是一个面向 **Pi** 智能体的 WhatsApp + Telegram + Discord + iMessage Gateway。插件可添加 Mattermost 支持。本指南介绍"个人助手"设置：一个专用的 WhatsApp 号码，作为你始终在线的智能体。
+OpenClaw 是一个面向 **Pi** 智能体的 WhatsApp + Telegram + Discord + iMessage Gateway网关。插件可添加 Mattermost 支持。本指南介绍"个人助手"设置：一个专用的 WhatsApp 号码，作为你始终在线的智能体。

 ## ⚠️ 安全第一

@@ -82,7 +82,7 @@ pnpm link --global
 openclaw channels login
 ```

-2. 启动 Gateway（保持运行）：
+2. 启动 Gateway网关（保持运行）：

 ```bash
 openclaw gateway --port 18789
@@ -98,7 +98,7 @@ openclaw gateway --port 18789

 现在从你的允许列表手机给助手号码发消息。

-上手引导完成后，我们会自动打开带有 Gateway 令牌的仪表盘并打印令牌化链接。以后重新打开：`openclaw dashboard`。
+新手引导完成后，我们会自动打开带有 Gateway网关令牌的仪表盘并打印令牌化链接。以后重新打开：`openclaw dashboard`。

 ## 给智能体一个工作区（AGENTS）

@@ -229,8 +229,8 @@ OpenClaw 会提取这些内容并将其作为媒体与文本一起发送。
 ```bash
 openclaw status          # 本地状态（凭证、会话、排队事件）
 openclaw status --all    # 完整诊断（只读，可粘贴）
-openclaw status --deep   # 添加 Gateway 健康探测（Telegram + Discord）
-openclaw health --json   # Gateway 健康快照（WS）
+openclaw status --deep   # 添加 Gateway网关健康探测（Telegram + Discord）
+openclaw health --json   # Gateway网关健康快照（WS）
 ```

 日志位于 `/tmp/openclaw/`（默认：`openclaw-YYYY-MM-DD.log`）。
@@ -238,7 +238,7 @@ openclaw health --json   # Gateway 健康快照（WS）
 ## 后续步骤

 - 网页聊天：[网页聊天](/web/webchat)
- Gateway 运维：[Gateway 运维手册](/gateway)
+- Gateway网关运维：[Gateway网关运维手册](/gateway)
 - 定时任务 + 唤醒：[定时任务](/automation/cron-jobs)
 - macOS 菜单栏伴侣应用：[OpenClaw macOS 应用](/platforms/macos)
 - iOS 节点应用：[iOS 应用](/platforms/ios)
@@ -20,7 +20,7 @@ x-i18n:
 它用于两个场景：

 1. **私信配对**（谁被允许与机器人对话）
-2. **节点配对**（哪些设备/节点被允许加入 Gateway 网络）
+2. **节点配对**（哪些设备/节点被允许加入 Gateway网关网络）

 安全上下文：[安全](/gateway/security)

@@ -56,7 +56,7 @@ openclaw pairing approve telegram <CODE>

 ## 2) 节点设备配对（iOS/Android/macOS/无头节点）

-节点以 `role: node` 的**设备**身份连接到 Gateway。Gateway 会创建一个需要批准的设备配对请求。
+节点以 `role: node` 的**设备**身份连接到 Gateway网关。Gateway网关会创建一个需要批准的设备配对请求。

 ### 批准节点设备

@@ -75,7 +75,7 @@ openclaw devices reject <requestId>

 ### 注意事项

- 旧版 `node.pair.*` API（CLI：`openclaw nodes pending/approve`）是一个独立的 Gateway 所拥有的配对存储。WebSocket 节点仍然需要设备配对。
+- 旧版 `node.pair.*` API（CLI：`openclaw nodes pending/approve`）是一个独立的 Gateway网关所拥有的配对存储。WebSocket 节点仍然需要设备配对。

 ## 相关文档

@@ -20,8 +20,8 @@ x-i18n:
 ## 简而言之

 - **个性化配置存放在仓库之外：** `~/.openclaw/workspace`（工作区）+ `~/.openclaw/openclaw.json`（配置）。
- **稳定工作流：** 安装 macOS 应用；让它运行内置的 Gateway。
- **前沿工作流：** 自行通过 `pnpm gateway:watch` 运行 Gateway，然后让 macOS 应用以本地模式接入。
+- **稳定工作流：** 安装 macOS 应用；让它运行内置的 Gateway网关。
+- **前沿工作流：** 自行通过 `pnpm gateway:watch` 运行 Gateway网关，然后让 macOS 应用以本地模式接入。

 ## 前置条件（从源码构建）

@@ -34,7 +34,7 @@ x-i18n:
 如果你想要"100% 按我的方式定制"*同时*方便更新，请将自定义内容放在：

 - **配置：** `~/.openclaw/openclaw.json`（JSON/JSON5 风格）
- **工作区：** `~/.openclaw/workspace`（技能、提示词、记忆；建议设为私有 git 仓库）
+- **工作区：** `~/.openclaw/workspace`（Skills、提示词、记忆；建议设为私有 git 仓库）

 初始化一次：

@@ -53,8 +53,8 @@ openclaw setup
 ## 稳定工作流（macOS 应用优先）

 1. 安装并启动 **OpenClaw.app**（菜单栏）。
-2. 完成上手引导/权限检查清单（TCC 授权提示）。
-3. 确保 Gateway 处于**本地**模式并正在运行（由应用管理）。
+2. 完成新手引导/权限检查清单（TCC 授权提示）。
+3. 确保 Gateway网关处于**本地**模式并正在运行（由应用管理）。
 4. 关联聊天界面（示例：WhatsApp）：

 ```bash
@@ -67,13 +67,13 @@ openclaw channels login
 openclaw health
 ```

-如果你的版本中上手引导不可用：
+如果你的版本中新手引导不可用：

- 运行 `openclaw setup`，然后 `openclaw channels login`，接着手动启动 Gateway（`openclaw gateway`）。
+- 运行 `openclaw setup`，然后 `openclaw channels login`，接着手动启动 Gateway网关（`openclaw gateway`）。

-## 前沿工作流（在终端中运行 Gateway）
+## 前沿工作流（在终端中运行 Gateway网关）

-目标：开发 TypeScript Gateway，获得热重载，同时保持 macOS 应用界面接入。
+目标：开发 TypeScript Gateway网关，获得热重载，同时保持 macOS 应用界面接入。

 ### 0)（可选）同样从源码运行 macOS 应用

@@ -83,25 +83,23 @@ openclaw health
 ./scripts/restart-mac.sh
 ```

-### 1) 启动开发 Gateway
+### 1) 启动开发 Gateway网关

 ```bash
 pnpm install
 pnpm gateway:watch
 ```

-`gateway:watch` 以监视模式运行 Gateway，TypeScript 文件变更时自动重载。
+`gateway:watch` 以监视模式运行 Gateway网关，TypeScript 文件变更时自动重载。

-### 2) 将 macOS 应用指向你运行的 Gateway
-
-在 **OpenClaw.app** 中：
+### 2) 将 macOS 应用指向你运行的 Gateway网关在 **OpenClaw.app** 中：

 - 连接模式：**本地**
-  应用将接入在配置端口上运行的 Gateway。
+  应用将接入在配置端口上运行的 Gateway网关。

 ### 3) 验证

- 应用内 Gateway 状态应显示 **"Using existing gateway …"**
+- 应用内 Gateway网关状态应显示 **"Using existing gateway …"**
 - 或通过 CLI 验证：

 ```bash
@@ -110,7 +108,7 @@ openclaw health

 ### 常见陷阱

- **端口错误：** Gateway WS 默认使用 `ws://127.0.0.1:18789`；保持应用 + CLI 使用相同端口。
+- **端口错误：** Gateway网关 WS 默认使用 `ws://127.0.0.1:18789`；保持应用 + CLI 使用相同端口。
 - **状态存储位置：**
  - 凭据：`~/.openclaw/credentials/`
  - 会话：`~/.openclaw/agents/<agentId>/sessions/`
@@ -137,7 +135,7 @@ openclaw health
 ## Linux（systemd 用户服务）

 Linux 安装使用 systemd **用户**服务。默认情况下，systemd 在注销/空闲时会停止用户
-服务，这会终止 Gateway。上手引导会尝试为你启用
+服务，这会终止 Gateway网关。新手引导会尝试为你启用
 持久化（可能提示输入 sudo 密码）。如果仍未开启，请运行：

 ```bash
@@ -145,12 +143,12 @@ sudo loginctl enable-linger $USER
 ```

 对于常驻或多用户服务器，建议使用**系统**服务而非
-用户服务（无需持久化）。参见 [Gateway 运维手册](/gateway) 中的 systemd 说明。
+用户服务（无需持久化）。参见 [Gateway网关运维手册](/gateway) 中的 systemd 说明。

 ## 相关文档

- [Gateway 运维手册](/gateway)（标志、进程管理、端口）
- [Gateway 配置](/gateway/configuration)（配置结构 + 示例）
+- [Gateway网关运维手册](/gateway)（标志、进程管理、端口）
+- [Gateway网关配置](/gateway/configuration)（配置结构 + 示例）
 - [Discord](/channels/discord) 和 [Telegram](/channels/telegram)（回复标签 + replyToMode 设置）
 - [OpenClaw 助手设置](/start/openclaw)
- [macOS 应用](/platforms/macos)（Gateway 生命周期）
+- [macOS 应用](/platforms/macos)（Gateway网关生命周期）
@@ -101,12 +101,12 @@ OpenCode 完成修改 → 提交 PR → OpenClaw 审查差异并在 Telegram 中
  <img src="/assets/showcase/pr-review-telegram.jpg" alt="OpenClaw PR 审查反馈通过 Telegram 发送" />
 </Card>

-<Card title="几分钟内创建酒窖技能" icon="wine-glass" href="https://x.com/i/status/2010916352454791216">
+<Card title="几分钟内创建酒窖 Skills" icon="wine-glass" href="https://x.com/i/status/2010916352454791216">
  **@prades_maxime** • `skills` `local` `csv`

-让"Robby"（@openclaw）创建一个本地酒窖技能。它请求一个 CSV 导出样本和存储位置，然后快速构建并测试技能（示例中有 962 瓶酒）。
+让"Robby"（@openclaw）创建一个本地酒窖 Skills。它请求一个 CSV 导出样本和存储位置，然后快速构建并测试 Skills（示例中有 962 瓶酒）。

-  <img src="/assets/showcase/wine-cellar-skill.jpg" alt="OpenClaw 从 CSV 构建本地酒窖技能" />
+  <img src="/assets/showcase/wine-cellar-skill.jpg" alt="OpenClaw 从 CSV 构建本地酒窖 Skills" />
 </Card>

 <Card title="Tesco 购物自动化" icon="cart-shopping" href="https://x.com/i/status/2009724862470689131">
@@ -128,7 +128,7 @@ OpenCode 完成修改 → 提交 PR → OpenClaw 审查差异并在 Telegram 中
 <Card title="Agents UI" icon="window-maximize" href="https://releaseflow.net/kitze/agents-ui">
  **@kitze** • `ui` `skills` `sync`

-桌面应用，用于跨 Agents、Claude、Codex 和 OpenClaw 管理技能/命令。
+桌面应用，用于跨 Agents、Claude、Codex 和 OpenClaw 管理 Skills/命令。

  <img src="/assets/showcase/agents-ui.jpg" alt="Agents UI 应用" />
 </Card>
@@ -154,7 +154,7 @@ OpenCode 完成修改 → 提交 PR → OpenClaw 审查差异并在 Telegram 中

 控制和排查 BambuLab 打印机：状态、任务、摄像头、AMS、校准等。

-  <img src="/assets/showcase/bambu-cli.png" alt="ClawHub 上的 Bambu CLI 技能" />
+  <img src="/assets/showcase/bambu-cli.png" alt="ClawHub 上的 Bambu CLI Skills" />
 </Card>

 <Card title="维也纳公共交通（Wiener Linien）" icon="train" href="https://clawhub.com/hjanuschka/wienerlinien">
@@ -162,7 +162,7 @@ OpenCode 完成修改 → 提交 PR → OpenClaw 审查差异并在 Telegram 中

 维也纳公共交通的实时出发信息、中断情况、电梯状态和路线规划。

-  <img src="/assets/showcase/wienerlinien.png" alt="ClawHub 上的 Wiener Linien 技能" />
+  <img src="/assets/showcase/wienerlinien.png" alt="ClawHub 上的 Wiener Linien Skills" />
 </Card>

 <Card title="ParentPay 学校餐食" icon="utensils" href="#">
@@ -195,7 +195,7 @@ OpenCode 完成修改 → 提交 PR → OpenClaw 审查差异并在 Telegram 中
 <Card title="Kev 的梦之队（14+ 智能体）" icon="robot" href="https://github.com/adam91holt/orchestrated-ai-articles">
  **@adam91holt** • `multi-agent` `orchestration` `architecture` `manifesto`

-一个 Gateway 下管理 14+ 智能体，由 Opus 4.5 编排器将任务委派给 Codex 工作节点。包含详尽的[技术文档](https://github.com/adam91holt/orchestrated-ai-articles)，涵盖梦之队成员、模型选择、沙箱、Webhook、心跳检测和委派流程。用于智能体沙箱隔离的 [Clawdspace](https://github.com/adam91holt/clawdspace)。[博客文章](https://adams-ai-journey.ghost.io/2026-the-year-of-the-orchestrator/)。
+一个 Gateway网关下管理 14+ 智能体，由 Opus 4.5 编排器将任务委派给 Codex 工作节点。包含详尽的[技术文档](https://github.com/adam91holt/orchestrated-ai-articles)，涵盖梦之队成员、模型选择、沙箱、Webhook、心跳检测和委派流程。用于智能体沙箱隔离的 [Clawdspace](https://github.com/adam91holt/clawdspace)。[博客文章](https://adams-ai-journey.ghost.io/2026-the-year-of-the-orchestrator/)。
 </Card>

 <Card title="Linear CLI" icon="terminal" href="https://github.com/Finesssee/linear-cli">
@@ -227,7 +227,7 @@ Claude Code 发现并确认了净化器控制方式，然后 OpenClaw 接管并
 <Card title="美丽天空相机抓拍" icon="camera" href="https://x.com/signalgaining/status/2010523120604746151">
  **@signalgaining** • `automation` `camera` `skill` `images`

-由屋顶摄像头触发：当天空看起来很美时，让 OpenClaw 拍一张天空照片——它设计了一个技能并完成了拍摄。
+由屋顶摄像头触发：当天空看起来很美时，让 OpenClaw 拍一张天空照片——它设计了一个 Skills 并完成了拍摄。

  <img src="/assets/showcase/roof-camera-sky.jpg" alt="OpenClaw 捕获的屋顶摄像头天空快照" />
 </Card>
@@ -264,16 +264,16 @@ Claude Code 发现并确认了净化器控制方式，然后 OpenClaw 接管并
 搜索职位列表，与简历关键词匹配，返回相关机会和链接。使用 JSearch API 在 30 分钟内构建完成。
 </Card>

-<Card title="Jira 技能构建器" icon="diagram-project" href="https://x.com/jdrhyne/status/2008336434827002232">
+<Card title="Jira Skills 构建器" icon="diagram-project" href="https://x.com/jdrhyne/status/2008336434827002232">
  **@jdrhyne** • `automation` `jira` `skill` `devtools`

-OpenClaw 连接到 Jira，然后即时生成了一个新技能（在 ClawHub 上还不存在时）。
+OpenClaw 连接到 Jira，然后即时生成了一个新 Skills（在 ClawHub 上还不存在时）。
 </Card>

-<Card title="通过 Telegram 创建 Todoist 技能" icon="list-check" href="https://x.com/iamsubhrajyoti/status/2009949389884920153">
+<Card title="通过 Telegram 创建 Todoist Skills" icon="list-check" href="https://x.com/iamsubhrajyoti/status/2009949389884920153">
  **@iamsubhrajyoti** • `automation` `todoist` `skill` `telegram`

-自动化 Todoist 任务，并让 OpenClaw 直接在 Telegram 聊天中生成技能。
+自动化 Todoist 任务，并让 OpenClaw 直接在 Telegram 聊天中生成 Skills。
 </Card>

 <Card title="TradingView 分析" icon="chart-line">
@@ -347,10 +347,10 @@ OpenClaw 连接到 Jira，然后即时生成了一个新技能（在 ClawHub 上
 <Card title="Home Assistant 插件" icon="home" href="https://github.com/ngutman/openclaw-ha-addon">
  **@ngutman** • `homeassistant` `docker` `raspberry-pi`
  
-  在 Home Assistant OS 上运行 OpenClaw Gateway，支持 SSH 隧道和持久化状态。
+  在 Home Assistant OS 上运行 OpenClaw Gateway网关，支持 SSH 隧道和持久化状态。
 </Card>

-<Card title="Home Assistant 技能" icon="toggle-on" href="https://clawhub.com/skills/homeassistant">
+<Card title="Home Assistant Skills" icon="toggle-on" href="https://clawhub.com/skills/homeassistant">
  **ClawHub** • `homeassistant` `skill` `automation`
  
  通过自然语言控制和自动化 Home Assistant 设备。
@@ -365,7 +365,7 @@ OpenClaw 连接到 Jira，然后即时生成了一个新技能（在 ClawHub 上
 <Card title="CalDAV 日历" icon="calendar" href="https://clawhub.com/skills/caldav-calendar">
  **ClawHub** • `calendar` `caldav` `skill`
  
-  使用 khal/vdirsyncer 的日历技能。自托管日历集成。
+  使用 khal/vdirsyncer 的日历 Skills。自托管日历集成。
 </Card>

 </CardGroup>
@@ -1,9 +1,9 @@
 ---
 read_when:
-  - 运行或配置上手引导向导
+  - 运行或配置新手引导向导
  - 设置新机器
-summary: CLI 上手引导向导：Gateway、工作区、渠道和技能的引导式设置
-title: 上手引导向导
+summary: CLI 新手引导向导：Gateway网关、工作区、渠道和 Skills 的引导式设置
+title: 新手引导向导
 x-i18n:
  generated_at: "2026-02-01T13:49:20Z"
  model: claude-opus-4-5
@@ -13,9 +13,9 @@ x-i18n:
  workflow: 9
 ---

-# 上手引导向导 (CLI)
+# 新手引导向导 (CLI)

-上手引导向导是 **推荐的** 在 macOS、Linux 或 Windows（通过 WSL2；强烈推荐）上设置 OpenClaw 的方式。它通过一个引导式流程配置本地 Gateway 或远程 Gateway 连接，以及渠道、技能和工作区默认设置。
+新手引导向导是 **推荐的** 在 macOS、Linux 或 Windows（通过 WSL2；强烈推荐）上设置 OpenClaw 的方式。它通过一个引导式流程配置本地 Gateway网关或远程 Gateway网关连接，以及渠道、Skills 和工作区默认设置。

 主要入口：

@@ -42,28 +42,28 @@ openclaw configure

 **快速入门** 保留默认设置：

- 本地 Gateway（回环地址）
+- 本地 Gateway网关（local loopback）
 - 默认工作区（或现有工作区）
- Gateway 端口 **18789**
- Gateway 认证 **令牌** （自动生成，即使在回环地址上也是如此）
+- Gateway网关端口 **18789**
+- Gateway网关认证 **令牌** （自动生成，即使在 local loopback 上也是如此）
 - Tailscale 暴露 **关闭**
- Telegram + WhatsApp 私信默认为 **允许名单** （系统会提示您输入手机号码）
+- Telegram + WhatsApp 私信默认为 **允许名单** （系统会提示你输入手机号码）

-**高级** 展示每个步骤（模式、工作区、Gateway、渠道、守护进程、技能）。
+**高级** 展示每个步骤（模式、工作区、Gateway网关、渠道、守护进程、Skills）。

 ## 向导的功能

-**本地模式（默认）** 引导您完成：
+**本地模式（默认）** 引导你完成：

 - 模型/认证（OpenAI Code (Codex) 订阅 OAuth、Anthropic API 密钥（推荐）或 setup-token（粘贴），以及 MiniMax/GLM/Moonshot/AI Gateway 选项）
 - 工作区位置 + 引导文件
- Gateway 设置（端口/绑定/认证/Tailscale）
+- Gateway网关设置（端口/绑定/认证/Tailscale）
 - 提供商（Telegram、WhatsApp、Discord、Google Chat、Mattermost（插件）、Signal）
 - 守护进程安装（LaunchAgent / systemd 用户单元）
 - 健康检查
- 技能（推荐）
+- Skills（推荐）

-**远程模式** 仅配置本地客户端以连接到其他位置的 Gateway。它 **不会** 在远程主机上安装或更改任何内容。
+**远程模式** 仅配置本地客户端以连接到其他位置的 Gateway网关。它 **不会** 在远程主机上安装或更改任何内容。

 要添加更多隔离的智能体（独立的工作区 + 会话 + 认证），请使用：

@@ -77,9 +77,9 @@ openclaw agents add <name>

 1. **现有配置检测**
   - 如果 `~/.openclaw/openclaw.json` 存在，请选择 **保留 / 修改 / 重置**。
-   - 重新运行向导 **不会** 不会删除任何内容，除非您明确选择 **重置**
+   - 重新运行向导 **不会** 不会删除任何内容，除非你明确选择 **重置**
     （或传入 `--reset`）。
-   - 如果配置无效或包含遗留键，向导会停止并要求您运行 `openclaw doctor` 后再继续。
+   - 如果配置无效或包含遗留键，向导会停止并要求你运行 `openclaw doctor` 后再继续。
   - 重置使用 `trash` （绝不使用 `rm`）并提供作用域：
     - 仅配置
     - 配置 + 凭据 + 会话
@@ -94,7 +94,7 @@ openclaw agents add <name>
     - 设置 `agents.defaults.model` 为 `openai-codex/gpt-5.2` （当模型未设置或为 `openai/*`。
   - **OpenAI API 密钥**：使用 `OPENAI_API_KEY` （如果存在）或提示输入密钥，然后保存到 `~/.openclaw/.env` 以便 launchd 可以读取。
   - **OpenCode Zen（多模型代理）**：提示输入 `OPENCODE_API_KEY` （或 `OPENCODE_ZEN_API_KEY`，请在 https://opencode.ai/auth)。
-   - **API 密钥**：为您存储密钥。
+   - **API 密钥**：为你存储密钥。
   - **Vercel AI Gateway（多模型代理）**：提示输入 `AI_GATEWAY_API_KEY`。
   - 更多详情： [Vercel AI Gateway](/providers/vercel-ai-gateway)
   - **MiniMax M2.1**：配置会自动写入。
@@ -116,11 +116,11 @@ openclaw agents add <name>
   - 生成智能体引导启动仪式所需的工作区文件。
   - 完整工作区布局 + 备份指南： [智能体工作区](/concepts/agent-workspace)

-4. **Gateway**
-   - 端口、绑定、认证模式、Tailscale 暴露。
-   - 认证建议：保持 **令牌** 即使在回环地址上也使用，以确保本地 WS 客户端必须进行认证。
-   - 仅在您完全信任每个本地进程时才禁用认证。
-   - 非回环绑定仍需认证。
+4. **Gateway网关**
+   - 端口、绑定、认证模式、网关仪表板暴露。
+   - 认证建议：保持 **令牌** 即使在 local loopback 上也使用，以确保本地 WS 客户端必须进行认证。
+   - 仅在你完全信任每个本地进程时才禁用认证。
+   - 非 local loopback 绑定仍需认证。

 5. **渠道**
   - [WhatsApp](/channels/whatsapp)：可选二维码登录。
@@ -136,17 +136,17 @@ openclaw agents add <name>
   - macOS：LaunchAgent
     - 需要已登录的用户会话；对于无头模式，请使用自定义 LaunchDaemon（未随附）。
   - Linux（以及通过 WSL2 的 Windows）：systemd 用户单元
-     - 向导会尝试通过 `loginctl enable-linger <user>` 启用驻留，以便在注销后 Gateway 保持运行。
+     - 向导会尝试通过 `loginctl enable-linger <user>` 启用驻留，以便在注销后 Gateway网关保持运行。
     - 可能会提示输入 sudo（写入 `/var/lib/systemd/linger`）；它会先尝试不使用 sudo。
   - **运行时选择：** Node（推荐；WhatsApp/Telegram 需要）。Bun **不推荐**。

 7. **健康检查**
-   - 启动 Gateway（如需）并运行 `openclaw health`。
-   - 提示： `openclaw status --deep` 将 Gateway 健康探测添加到状态输出中（需要可达的 Gateway）。
+   - 启动 Gateway网关（如需）并运行 `openclaw health`。
+   - 提示： `openclaw status --deep` 将 Gateway网关健康探测添加到状态输出中（需要可达的 Gateway网关）。

-8. **技能（推荐）**
-   - 读取可用技能并检查依赖条件。
-   - 让您选择一个 Node 管理器： **npm / pnpm** （不推荐 bun）。
+8. **Skills（推荐）**
+   - 读取可用 Skills 并检查依赖条件。
+   - 让你选择一个 Node 管理器： **npm / pnpm** （不推荐 bun）。
   - 安装可选依赖项（部分在 macOS 上使用 Homebrew）。

 9. **完成**
@@ -157,17 +157,17 @@ openclaw agents add <name>

 ## 远程模式

-远程模式配置本地客户端以连接到其他位置的 Gateway。
+远程模式配置本地客户端以连接到其他位置的 Gateway网关。

-您需要设置的内容：
+你需要设置的内容：

- 远程 Gateway URL（`ws://...`）
- 如果远程 Gateway 需要认证，则需提供令牌（推荐）
+- 远程 Gateway网关 URL（`ws://...`）
+- 如果远程 Gateway网关需要认证，则需提供令牌（推荐）

 注意事项：

 - 不会执行远程安装或守护进程更改。
- 如果 Gateway 仅绑定回环地址，请使用 SSH 隧道或 tailnet。
+- 如果 Gateway网关仅绑定 local loopback，请使用 SSH 隧道或 tailnet。
 - 发现提示：
  - macOS：Bonjour（`dns-sd`）
  - Linux：Avahi（`avahi-browse`）
@@ -190,7 +190,7 @@ openclaw agents add <name>

 ## 非交互模式

-使用 `--non-interactive` 用于自动化或脚本化上手引导：
+使用 `--non-interactive` 用于自动化或脚本化新手引导：

 ```bash
 openclaw onboard --non-interactive \
@@ -283,9 +283,9 @@ openclaw agents add work \
  --json
 ```

-## Gateway 向导 RPC
+## Gateway网关向导 RPC

-Gateway 通过 RPC 暴露向导流程（`wizard.start`， `wizard.next`， `wizard.cancel`， `wizard.status`）。客户端（macOS 应用、Control UI）可以渲染步骤而无需重新实现上手引导逻辑。
+Gateway网关通过 RPC 暴露向导流程（`wizard.start`， `wizard.next`， `wizard.cancel`， `wizard.status`）。客户端（macOS 应用、Control UI）可以渲染步骤而无需重新实现新手引导逻辑。

 ## Signal 设置 (signal-cli)

@@ -293,7 +293,7 @@ Gateway 通过 RPC 暴露向导流程（`wizard.start`， `wizard.next`， `wiza

 - 下载相应的发布资源。
 - 将其存储在 `~/.openclaw/tools/signal-cli/<version>/`。
- 写入 `channels.signal.cliPath` 到您的配置中。
+- 写入 `channels.signal.cliPath` 到你的配置中。

 注意事项：

@@ -321,11 +321,11 @@ Gateway 通过 RPC 暴露向导流程（`wizard.start`， `wizard.next`， `wiza

 WhatsApp 凭据存储在 `~/.openclaw/credentials/whatsapp/<accountId>/`下。会话存储在 `~/.openclaw/agents/<agentId>/sessions/`。

-部分渠道以插件形式提供。当您在上手引导期间选择某个渠道时，向导会提示先安装它（通过 npm 或本地路径），然后才能进行配置。
+部分渠道以插件形式提供。当你在新手引导期间选择某个渠道时，向导会提示先安装它（通过 npm 或本地路径），然后才能进行配置。

 ## 相关文档

- macOS 应用上手引导： [上手引导](/start/onboarding)
- 配置参考： [Gateway 配置](/gateway/configuration)
+- macOS 应用新手引导： [新手引导](/start/onboarding)
+- 配置参考： [Gateway网关配置](/gateway/configuration)
 - 提供商： [WhatsApp](/channels/whatsapp)， [Telegram](/channels/telegram)， [Discord](/channels/discord)， [Google Chat](/channels/googlechat)， [Signal](/channels/signal)， [iMessage](/channels/imessage)
- 技能： [技能](/tools/skills)， [技能配置](/tools/skills-config)
+- Skills： [Skills](/tools/skills)， [Skills配置](/tools/skills-config)