chore(i18n): refresh zh-CN translations

2026-04-23 04:58:43 +00:00 · 2026-04-23 04:58:43 +00:00 · 0b6a084464
commit 0b6a084464
parent fe41f074a4
3 changed files with 561 additions and 530 deletions
--- a/docs/zh-CN/help/testing.md
+++ b/docs/zh-CN/help/testing.md
--- a/docs/zh-CN/platforms/linux.md
+++ b/docs/zh-CN/platforms/linux.md
@ -1,47 +1,48 @@
 ---
 read_when:
-    - 查找 Linux 配套应用状态时
-    - 规划平台覆盖范围或贡献时
+    - 寻找 Linux 配套应用状态
+    - 规划平台覆盖范围或贡献
+    - 在 VPS 或容器上调试 Linux OOM 被杀或退出码 137
 summary: Linux 支持 + 配套应用状态
 title: Linux 应用
 x-i18n:
-    generated_at: "2026-04-05T08:37:25Z"
+    generated_at: "2026-04-23T04:54:32Z"
    model: gpt-5.4
    provider: openai
-    source_hash: 5dbfc89eb65e04347479fc6c9a025edec902fb0c544fb8d5bd09c24558ea03b1
+    source_hash: c56151406517a1259e66626b8f4b48c16917b10580e7626463afd8a68dc286f7
    source_path: platforms/linux.md
    workflow: 15
 ---

 # Linux 应用

-Gateway 网关 在 Linux 上已获得完整支持。**Node 是推荐的运行时**。
-不建议对 Gateway 网关 使用 Bun（存在 WhatsApp/Telegram 相关问题）。
+Gateway 网关在 Linux 上得到完全支持。**推荐使用 Node 作为运行时**。
+不建议 Gateway 网关使用 Bun（存在 WhatsApp/Telegram 相关 bug）。

-原生 Linux 配套应用已在计划中。如果你想帮助构建一个，欢迎贡献。
+原生 Linux 配套应用已在规划中。如果你想帮助构建一个，欢迎贡献。

-## 面向新手的快速路径（VPS）
+## 面向初学者的快速路径（VPS）

-1. 安装 Node 24（推荐；Node 22 LTS，目前为 `22.14+`，出于兼容性考虑仍然可用）
+1. 安装 Node 24（推荐；Node 22 LTS，目前 `22.14+`，出于兼容性仍然可用）
 2. `npm i -g openclaw@latest`
 3. `openclaw onboard --install-daemon`
 4. 在你的笔记本电脑上运行：`ssh -N -L 18789:127.0.0.1:18789 <user>@<host>`
-5. 打开 `http://127.0.0.1:18789/`，并使用已配置的共享密钥进行认证（默认是 token；如果你设置了 `gateway.auth.mode: "password"`，则使用密码）
+5. 打开 `http://127.0.0.1:18789/`，并使用已配置的共享密钥进行认证（默认是 token；如果你设置了 `gateway.auth.mode: "password"`，则使用 password）

-完整的 Linux 服务器指南：[Linux Server](/vps)。分步 VPS 示例：[exe.dev](/install/exe-dev)
+完整的 Linux 服务器指南：[Linux 服务器](/zh-CN/vps)。VPS 分步示例：[exe.dev](/zh-CN/install/exe-dev)

 ## 安装

- [入门指南](/start/getting-started)
- [安装与更新](/install/updating)
- 可选流程：[Bun（实验性）](/install/bun)、[Nix](/install/nix)、[Docker](/install/docker)
+- [入门指南](/zh-CN/start/getting-started)
+- [安装与更新](/zh-CN/install/updating)
+- 可选流程：[Bun（实验性）](/zh-CN/install/bun)、[Nix](/zh-CN/install/nix)、[Docker](/zh-CN/install/docker)

 ## Gateway 网关

- [Gateway 网关 运行手册](/gateway)
- [Configuration](/gateway/configuration)
+- [Gateway 网关运行手册](/zh-CN/gateway)
+- [配置](/zh-CN/gateway/configuration)

-## Gateway 网关 服务安装（CLI）
+## Gateway 网关服务安装（CLI）

 使用以下任一方式：

@ -61,7 +62,7 @@ openclaw gateway install
 openclaw configure
 ```

-在提示时选择 **Gateway service**。
+在提示时选择 **Gateway 网关服务**。

 修复/迁移：

@ -71,9 +72,7 @@ openclaw doctor

 ## 系统控制（systemd 用户单元）

-默认情况下，OpenClaw 会安装 systemd **用户**服务。对于共享或始终开启的服务器，请使用 **系统**服务。`openclaw gateway install` 和
-`openclaw onboard --install-daemon` 已经会为你渲染当前的规范单元文件；只有在你需要自定义 system/service-manager
-设置时，才需要手动编写。完整的服务说明位于 [Gateway 网关 运行手册](/gateway)。
+默认情况下，OpenClaw 会安装一个 systemd **用户**服务。对于共享服务器或始终在线的服务器，请使用 **系统**服务。`openclaw gateway install` 和 `openclaw onboard --install-daemon` 已经会为你生成当前规范的单元文件；只有在你需要自定义系统/服务管理器设置时，才需要手动编写。完整的服务说明见 [Gateway 网关运行手册](/zh-CN/gateway)。

 最小配置：

@ -103,3 +102,29 @@ WantedBy=default.target
 ```
 systemctl --user enable --now openclaw-gateway[-<profile>].service
 ```
+
+## 内存压力与 OOM 被杀
+
+在 Linux 上，当主机、虚拟机或容器的 cgroup 内存耗尽时，内核会选择一个 OOM 受害者。Gateway 网关可能是一个不理想的受害者，因为它持有长期存在的会话和渠道连接。因此，OpenClaw 会尽可能优先让短暂的子进程在 Gateway 网关之前被杀死。
+
+对于符合条件的 Linux 子进程创建，OpenClaw 会通过一个简短的 `/bin/sh` 包装器启动子进程，该包装器会将子进程自身的 `oom_score_adj` 提高到 `1000`，然后通过 `exec` 执行真实命令。这是一个无需特权的操作，因为子进程只是在提高其自身被 OOM 杀死的概率。
+
+覆盖的子进程入口包括：
+
+- 由 supervisor 管理的命令子进程，
+- PTY shell 子进程，
+- MCP stdio 服务器子进程，
+- 由 OpenClaw 启动的浏览器/Chrome 进程。
+
+该包装器仅适用于 Linux；如果 `/bin/sh` 不可用，则会跳过。
+如果子进程环境变量设置了 `OPENCLAW_CHILD_OOM_SCORE_ADJ=0`、`false`、`no` 或 `off`，也会跳过。
+
+要验证某个子进程：
+
+```bash
+cat /proc/<child-pid>/oom_score_adj
+```
+
+对于受覆盖的子进程，预期值为 `1000`。Gateway 网关进程应保持其正常分值，通常为 `0`。
+
+这不能替代常规的内存调优。如果 VPS 或容器反复杀死子进程，请提高内存限制、降低并发，或增加更强的资源控制，例如 systemd 的 `MemoryMax=` 或容器级内存限制。
--- a/docs/zh-CN/vps.md
+++ b/docs/zh-CN/vps.md
@ -1,78 +1,76 @@
 ---
 read_when:
    - 你想在 Linux 服务器或云 VPS 上运行 Gateway 网关
-    - 你需要一份托管指南的快速导航图
-    - 你想了解适用于 OpenClaw 的通用 Linux 服务器调优】【。
+    - 你需要一份托管指南的快速导览
+    - 你想要适用于 OpenClaw 的通用 Linux 服务器调优指南
 sidebarTitle: Linux Server
-summary: 在 Linux 服务器或云 VPS 上运行 OpenClaw —— 提供商选择器、架构与调优
+summary: 在 Linux 服务器或云 VPS 上运行 OpenClaw —— 提供商选择器、架构和调优
 title: Linux 服务器
 x-i18n:
-    generated_at: "2026-04-13T13:14:20Z"
+    generated_at: "2026-04-23T04:54:32Z"
    model: gpt-5.4
    provider: openai
-    source_hash: e623f4c770132e01628d66bfb8cd273bbef6dad633b812496c90da5e3e0f1383
+    source_hash: 759428cf20204207a5505a73c880aa776ddd0eabf969fc0dcf444fc8ce6991b2
    source_path: vps.md
    workflow: 15
 ---

 # Linux 服务器

-在任何 Linux 服务器或云 VPS 上运行 OpenClaw Gateway 网关。本页可帮助你
-选择提供商，说明云部署如何工作，并介绍适用于各种环境的通用 Linux
-调优方法。
+在任何 Linux 服务器或云 VPS 上运行 OpenClaw Gateway 网关。本页可帮助你选择提供商，解释云部署的工作方式，并介绍适用于各类环境的通用 Linux 调优方法。

 ## 选择提供商

 <CardGroup cols={2}>
-  <Card title="Railway" href="/zh-CN/install/railway">一键式浏览器安装</Card>
-  <Card title="Northflank" href="/zh-CN/install/northflank">一键式浏览器安装</Card>
+  <Card title="Railway" href="/zh-CN/install/railway">一键式浏览器设置</Card>
+  <Card title="Northflank" href="/zh-CN/install/northflank">一键式浏览器设置</Card>
  <Card title="DigitalOcean" href="/zh-CN/install/digitalocean">简单的付费 VPS</Card>
-  <Card title="Oracle Cloud" href="/zh-CN/install/oracle">永久免费 ARM 套餐</Card>
+  <Card title="Oracle Cloud" href="/zh-CN/install/oracle">永久免费 ARM 层级</Card>
  <Card title="Fly.io" href="/zh-CN/install/fly">Fly Machines</Card>
-  <Card title="Hetzner" href="/zh-CN/install/hetzner">在 Hetzner VPS 上使用 Docker</Card>
-  <Card title="Hostinger" href="/zh-CN/install/hostinger">支持一键安装的 VPS</Card>
+  <Card title="Hetzner" href="/zh-CN/install/hetzner">在 Hetzner VPS 上运行 Docker</Card>
+  <Card title="Hostinger" href="/zh-CN/install/hostinger">带一键设置的 VPS</Card>
  <Card title="GCP" href="/zh-CN/install/gcp">Compute Engine</Card>
-  <Card title="Azure" href="/zh-CN/install/azure">Linux 虚拟机</Card>
-  <Card title="exe.dev" href="/zh-CN/install/exe-dev">带 HTTPS 代理的虚拟机</Card>
+  <Card title="Azure" href="/zh-CN/install/azure">Linux VM</Card>
+  <Card title="exe.dev" href="/zh-CN/install/exe-dev">带 HTTPS 代理的 VM</Card>
  <Card title="Raspberry Pi" href="/zh-CN/install/raspberry-pi">ARM 自托管</Card>
 </CardGroup>

-**AWS（EC2 / Lightsail / 免费套餐）** 也非常适合。
-社区视频演示可见
+**AWS（EC2 / Lightsail / 免费层级）** 也运行良好。
+社区视频演示可在
 [x.com/techfrenAJ/status/2014934471095812547](https://x.com/techfrenAJ/status/2014934471095812547)
-（社区资源——未来可能失效）。
+查看（社区资源——可能会失效）。

-## 云端部署的工作方式
+## 云部署如何工作

 - **Gateway 网关运行在 VPS 上**，并负责状态和工作区。
- 你可通过 **Control UI** 或 **Tailscale/SSH** 从笔记本电脑或手机连接。
- 将 VPS 视为唯一真实来源，并定期**备份**状态和工作区。
- 默认安全做法：将 Gateway 网关绑定在 loopback 上，并通过 SSH 隧道或 Tailscale Serve 访问。
-  如果你绑定到 `lan` 或 `tailnet`，请务必启用 `gateway.auth.token` 或 `gateway.auth.password`。
+- 你可以通过 **Control UI** 或 **Tailscale/SSH** 从笔记本电脑或手机连接。
+- 将 VPS 视为事实来源，并定期**备份**状态和工作区。
+- 安全默认做法：将 Gateway 网关保持在 loopback 上，并通过 SSH 隧道或 Tailscale Serve 访问它。
+  如果你绑定到 `lan` 或 `tailnet`，请启用 `gateway.auth.token` 或 `gateway.auth.password`。

-相关页面：[Gateway 远程访问](/zh-CN/gateway/remote)、[平台总览](/zh-CN/platforms)。
+相关页面：[Gateway 网关远程访问](/zh-CN/gateway/remote)、[平台中心](/zh-CN/platforms)。

-## 在 VPS 上为公司团队共享一个智能体
+## VPS 上的共享公司智能体

-当所有用户都处于同一信任边界内，且该智能体仅用于业务场景时，为团队运行单个智能体是一种可行的方案。
+当所有用户都处于同一信任边界内，且该智能体仅用于业务场景时，在团队中运行单个智能体是一种可行的设置。

- 将它放在专用运行环境中（VPS/VM/容器 + 专用 OS 用户/账号）。
- 不要让该运行环境登录个人 Apple/Google 账号，或个人浏览器/密码管理器配置。
- 如果用户彼此之间存在对抗风险，请按 Gateway 网关/主机/OS 用户进行隔离。
+- 将其放在专用运行环境中（VPS/VM/容器 + 专用 OS 用户/账户）。
+- 不要让该运行环境登录个人 Apple/Google 账户，或个人浏览器/密码管理器配置。
+- 如果用户彼此之间存在对抗风险，请按 gateway/主机/OS 用户进行拆分。

-安全模型详情请参阅：[安全](/zh-CN/gateway/security)。
+安全模型详情参见：[Security](/zh-CN/gateway/security)。

-## 在 VPS 中配合节点使用
+## 在 VPS 中使用节点

 你可以将 Gateway 网关保留在云端，并在本地设备上配对**节点**
-（Mac/iOS/Android/无头设备）。节点可提供本地屏幕/摄像头/canvas 和 `system.run`
-能力，而 Gateway 网关仍保留在云端。
+（Mac/iOS/Android/无头环境）。节点提供本地屏幕/摄像头/canvas 和 `system.run`
+能力，而 Gateway 网关则保留在云端。

-文档：[节点](/zh-CN/nodes)、[节点 CLI](/cli/nodes)。
+文档：[节点](/zh-CN/nodes)、[Nodes CLI](/cli/nodes)。

-## 面向小型 VM 和 ARM 主机的启动调优
+## 小型 VM 和 ARM 主机的启动调优

-如果在低性能 VM（或 ARM 主机）上 CLI 命令感觉较慢，可启用 Node 的模块编译缓存：
+如果在低性能 VM（或 ARM 主机）上 CLI 命令感觉较慢，可以启用 Node 的模块编译缓存：

 ```bash
 grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF'
@ -85,21 +83,21 @@ source ~/.bashrc

 - `NODE_COMPILE_CACHE` 可提升重复执行命令时的启动速度。
 - `OPENCLAW_NO_RESPAWN=1` 可避免自重启路径带来的额外启动开销。
- 首次执行命令会预热缓存；后续执行会更快。
- 关于 Raspberry Pi 的具体说明，请参阅 [Raspberry Pi](/zh-CN/install/raspberry-pi)。
+- 第一次运行命令会预热缓存；后续运行会更快。
+- 有关 Raspberry Pi 的具体说明，请参见 [Raspberry Pi](/zh-CN/install/raspberry-pi)。

 ### `systemd` 调优清单（可选）

-对于使用 `systemd` 的 VM 主机，可考虑：
+对于使用 `systemd` 的 VM 主机，可以考虑：

- 为服务添加环境变量，以获得更稳定的启动路径：
+- 为服务添加环境变量，以获得稳定的启动路径：
  - `OPENCLAW_NO_RESPAWN=1`
  - `NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache`
- 明确设置重启行为：
+- 保持重启行为明确：
  - `Restart=always`
  - `RestartSec=2`
  - `TimeoutStartSec=90`
- 状态/缓存路径尽量使用 SSD 支持的磁盘，以减少随机 I/O 冷启动带来的性能损失。
+- 优先使用基于 SSD 的磁盘来存放状态/缓存路径，以减少随机 I/O 冷启动带来的性能损失。

 对于标准的 `openclaw onboard --install-daemon` 路径，请编辑用户单元：

@ -116,9 +114,12 @@ RestartSec=2
 TimeoutStartSec=90
 ```

-如果你是有意安装为系统单元，请改为通过
+如果你是有意安装了系统单元，请改用
 `sudo systemctl edit openclaw-gateway.service` 编辑
 `openclaw-gateway.service`。

-关于 `Restart=` 策略如何帮助自动恢复，请参阅：
-[systemd 可自动执行服务恢复](https://www.redhat.com/en/blog/systemd-automate-recovery)。
+关于 `Restart=` 策略如何帮助自动恢复：
+[systemd 可以自动执行服务恢复](https://www.redhat.com/en/blog/systemd-automate-recovery)。
+
+关于 Linux OOM 行为、子进程受害者选择以及 `exit 137`
+诊断，请参见 [Linux 内存压力和 OOM 终止](/zh-CN/platforms/linux#memory-pressure-and-oom-kills)。