@agent-our/openclaw 2026.2.6-3

package/docs/zh-CN/platforms/android.md

@@ -0,0 +1,155 @@
+---
+read_when:
+  - 配对或重新连接 Android 节点
+  - 调试 Android Gateway 网关发现或认证
+  - 验证跨客户端的聊天历史一致性
+summary: Android 应用（节点）：连接操作手册 + Canvas/Chat/Camera
+title: Android 应用
+x-i18n:
+  generated_at: "2026-02-03T07:51:34Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 9cd02f12065ce2bc483379c9afd7537489d9076094f4a412cf9f21ccc47f0e38
+  source_path: platforms/android.md
+  workflow: 15
+---
+
+# Android 应用（节点）
+
+## 支持概览
+
+- 角色：配套节点应用（Android 不托管 Gateway 网关）。
+- 需要 Gateway 网关：是（在 macOS、Linux 或通过 WSL2 的 Windows 上运行）。
+- 安装：[入门指南](/start/getting-started) + [配对](/gateway/pairing)。
+- Gateway 网关：[操作手册](/gateway) + [配置](/gateway/configuration)。
+  - 协议：[Gateway 网关协议](/gateway/protocol)（节点 + 控制平面）。
+
+## 系统控制
+
+系统控制（launchd/systemd）位于 Gateway 网关主机上。参见 [Gateway 网关](/gateway)。
+
+## 连接操作手册
+
+Android 节点应用 ⇄（mDNS/NSD + WebSocket）⇄ **Gateway 网关**
+
+Android 直接连接到 Gateway 网关 WebSocket（默认 `ws://<host>:18789`）并使用 Gateway 网关拥有的配对。
+
+### 前置条件
+
+- 你可以在"主"机器上运行 Gateway 网关。
+- Android 设备/模拟器可以访问 Gateway 网关 WebSocket：
+  - 使用 mDNS/NSD 的同一局域网，**或**
+  - 使用 Wide-Area Bonjour / unicast DNS-SD 的同一 Tailscale tailnet（见下文），**或**
+  - 手动 Gateway 网关主机/端口（回退方案）
+- 你可以在 Gateway 网关机器上运行 CLI（`openclaw`）（或通过 SSH）。
+
+### 1）启动 Gateway 网关
+
+```bash
+openclaw gateway --port 18789 --verbose
+```
+
+在日志中确认你看到类似内容：
+
+- `listening on ws://0.0.0.0:18789`
+
+对于仅 tailnet 设置（推荐用于维也纳 ⇄ 伦敦），将 Gateway 网关绑定到 tailnet IP：
+
+- 在 Gateway 网关主机的 `~/.openclaw/openclaw.json` 中设置 `gateway.bind: "tailnet"`。
+- 重启 Gateway 网关 / macOS 菜单栏应用。
+
+### 2）验证发现（可选）
+
+从 Gateway 网关机器：
+
+```bash
+dns-sd -B _openclaw-gw._tcp local.
+```
+
+更多调试说明：[Bonjour](/gateway/bonjour)。
+
+#### 通过 unicast DNS-SD 的 Tailnet（维也纳 ⇄ 伦敦）发现
+
+Android NSD/mDNS 发现无法跨网络。如果你的 Android 节点和 Gateway 网关在不同网络但通过 Tailscale 连接，请改用 Wide-Area Bonjour / unicast DNS-SD：
+
+1. 在 Gateway 网关主机上设置 DNS-SD 区域（示例 `openclaw.internal.`）并发布 `_openclaw-gw._tcp` 记录。
+2. 配置 Tailscale split DNS，将你选择的域指向该 DNS 服务器。
+
+详情和示例 CoreDNS 配置：[Bonjour](/gateway/bonjour)。
+
+### 3）从 Android 连接
+
+在 Android 应用中：
+
+- 应用通过**前台服务**（持久通知）保持 Gateway 网关连接活动。
+- 打开**设置**。
+- 在**发现的 Gateway 网关**下，选择你的 Gateway 网关并点击**连接**。
+- 如果 mDNS 被阻止，使用**高级 → 手动 Gateway 网关**（主机 + 端口）并**连接（手动）**。
+
+首次成功配对后，Android 在启动时自动重连：
+
+- 手动端点（如果启用），否则
+- 上次发现的 Gateway 网关（尽力而为）。
+
+### 4）批准配对（CLI）
+
+在 Gateway 网关机器上：
+
+```bash
+openclaw nodes pending
+openclaw nodes approve <requestId>
+```
+
+配对详情：[Gateway 网关配对](/gateway/pairing)。
+
+### 5）验证节点已连接
+
+- 通过节点状态：
+  ```bash
+  openclaw nodes status
+  ```
+- 通过 Gateway 网关：
+  ```bash
+  openclaw gateway call node.list --params "{}"
+  ```
+
+### 6）聊天 + 历史
+
+Android 节点的 Chat 面板使用 Gateway 网关的**主会话键**（`main`），因此历史和回复与 WebChat 和其他客户端共享：
+
+- 历史：`chat.history`
+- 发送：`chat.send`
+- 推送更新（尽力而为）：`chat.subscribe` → `event:"chat"`
+
+### 7）Canvas + 摄像头
+
+#### Gateway 网关 Canvas 主机（推荐用于 web 内容）
+
+如果你想让节点显示智能体可以在磁盘上编辑的真实 HTML/CSS/JS，请将节点指向 Gateway 网关 canvas 主机。
+
+注意：节点使用 `canvasHost.port`（默认 `18793`）上的独立 canvas 主机。
+
+1. 在 Gateway 网关主机上创建 `~/.openclaw/workspace/canvas/index.html`。
+
+2. 将节点导航到它（局域网）：
+
+```bash
+openclaw nodes invoke --node "<Android Node>" --command canvas.navigate --params '{"url":"http://<gateway-hostname>.local:18793/__openclaw__/canvas/"}'
+```
+
+Tailnet（可选）：如果两个设备都在 Tailscale 上，使用 MagicDNS 名称或 tailnet IP 而不是 `.local`，例如 `http://<gateway-magicdns>:18793/__openclaw__/canvas/`。
+
+此服务器将实时重载客户端注入 HTML 并在文件更改时重新加载。
+A2UI 主机位于 `http://<gateway-host>:18793/__openclaw__/a2ui/`。
+
+Canvas 命令（仅前台）：
+
+- `canvas.eval`、`canvas.snapshot`、`canvas.navigate`（使用 `{"url":""}` 或 `{"url":"/"}` 返回默认脚手架）。`canvas.snapshot` 返回 `{ format, base64 }`（默认 `format="jpeg"`）。
+- A2UI：`canvas.a2ui.push`、`canvas.a2ui.reset`（`canvas.a2ui.pushJSONL` 遗留别名）
+
+摄像头命令（仅前台；权限限制）：
+
+- `camera.snap`（jpg）
+- `camera.clip`（mp4）
+
+参见 [Camera 节点](/nodes/camera) 了解参数和 CLI 助手。

package/docs/zh-CN/platforms/digitalocean.md

@@ -0,0 +1,269 @@
+---
+read_when:
+  - 在 DigitalOcean 上设置 OpenClaw
+  - 寻找便宜的 VPS 托管来运行 OpenClaw
+summary: 在 DigitalOcean 上运行 OpenClaw（简单的付费 VPS 选项）
+title: DigitalOcean
+x-i18n:
+  generated_at: "2026-02-03T07:51:55Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: d60559b8751da37413e5364e83c88254b476b2283386a0b07b2ca6b4e16157fc
+  source_path: platforms/digitalocean.md
+  workflow: 15
+---
+
+# 在 DigitalOcean 上运行 OpenClaw
+
+## 目标
+
+以 **$6/月**（或使用预留定价 $4/月）在 DigitalOcean 上运行持久的 OpenClaw Gateway 网关。
+
+如果你想要 $0/月的选项且不介意 ARM + 特定提供商的设置，请参阅 [Oracle Cloud 指南](/platforms/oracle)。
+
+## 成本比较（2026）
+
+| 提供商       | 方案            | 配置                  | 价格/月     | 备注                     |
+| ------------ | --------------- | --------------------- | ----------- | ------------------------ |
+| Oracle Cloud | Always Free ARM | 最高 4 OCPU、24GB RAM | $0          | ARM，容量有限 / 注册有坑 |
+| Hetzner      | CX22            | 2 vCPU、4GB RAM       | €3.79 (~$4) | 最便宜的付费选项         |
+| DigitalOcean | Basic           | 1 vCPU、1GB RAM       | $6          | 界面简单，文档完善       |
+| Vultr        | Cloud Compute   | 1 vCPU、1GB RAM       | $6          | 多地区可选               |
+| Linode       | Nanode          | 1 vCPU、1GB RAM       | $5          | 现为 Akamai 旗下         |
+
+**选择提供商：**
+
+- DigitalOcean：最简单的用户体验 + 可预测的设置（本指南）
+- Hetzner：性价比高（参见 [Hetzner 指南](/install/hetzner)）
+- Oracle Cloud：可以 $0/月，但更麻烦且仅限 ARM（参见 [Oracle 指南](/platforms/oracle)）
+
+---
+
+## 前提条件
+
+- DigitalOcean 账户（[注册可获 $200 免费额度](https://m.do.co/c/signup)）
+- SSH 密钥对（或愿意使用密码认证）
+- 约 20 分钟
+
+## 1) 创建 Droplet
+
+1. 登录 [DigitalOcean](https://cloud.digitalocean.com/)
+2. 点击 **Create → Droplets**
+3. 选择：
+   - **Region：** 离你（或你的用户）最近的地区
+   - **Image：** Ubuntu 24.04 LTS
+   - **Size：** Basic → Regular → **$6/mo**（1 vCPU、1GB RAM、25GB SSD）
+   - **Authentication：** SSH 密钥（推荐）或密码
+4. 点击 **Create Droplet**
+5. 记下 IP 地址
+
+## 2) 通过 SSH 连接
+
+```bash
+ssh root@YOUR_DROPLET_IP
+```
+
+## 3) 安装 OpenClaw
+
+```bash
+# Update system
+apt update && apt upgrade -y
+
+# Install Node.js 22
+curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
+apt install -y nodejs
+
+# Install OpenClaw
+curl -fsSL https://openclaw.ai/install.sh | bash
+
+# Verify
+openclaw --version
+```
+
+## 4) 运行新手引导
+
+```bash
+openclaw onboard --install-daemon
+```
+
+向导将引导你完成：
+
+- 模型认证（API 密钥或 OAuth）
+- 渠道设置（Telegram、WhatsApp、Discord 等）
+- Gateway 网关令牌（自动生成）
+- 守护进程安装（systemd）
+
+## 5) 验证 Gateway 网关
+
+```bash
+# Check status
+openclaw status
+
+# Check service
+systemctl --user status openclaw-gateway.service
+
+# View logs
+journalctl --user -u openclaw-gateway.service -f
+```
+
+## 6) 访问控制面板
+
+Gateway 网关默认绑定到 loopback。要访问控制界面：
+
+**选项 A：SSH 隧道（推荐）**
+
+```bash
+# From your local machine
+ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP
+
+# Then open: http://localhost:18789
+```
+
+**选项 B：Tailscale Serve（HTTPS，仅 loopback）**
+
+```bash
+# On the droplet
+curl -fsSL https://tailscale.com/install.sh | sh
+tailscale up
+
+# Configure Gateway to use Tailscale Serve
+openclaw config set gateway.tailscale.mode serve
+openclaw gateway restart
+```
+
+打开：`https://<magicdns>/`
+
+注意事项：
+
+- Serve 保持 Gateway 网关仅 loopback 并通过 Tailscale 身份头进行认证。
+- 要改为需要令牌/密码，请设置 `gateway.auth.allowTailscale: false` 或使用 `gateway.auth.mode: "password"`。
+
+**选项 C：Tailnet 绑定（不使用 Serve）**
+
+```bash
+openclaw config set gateway.bind tailnet
+openclaw gateway restart
+```
+
+打开：`http://<tailscale-ip>:18789`（需要令牌）。
+
+## 7) 连接你的渠道
+
+### Telegram
+
+```bash
+openclaw pairing list telegram
+openclaw pairing approve telegram <CODE>
+```
+
+### WhatsApp
+
+```bash
+openclaw channels login whatsapp
+# Scan QR code
+```
+
+参见[渠道](/channels)了解其他提供商。
+
+---
+
+## 1GB RAM 的优化
+
+$6 的 droplet 只有 1GB RAM。为了保持运行流畅：
+
+### 添加 swap（推荐）
+
+```bash
+fallocate -l 2G /swapfile
+chmod 600 /swapfile
+mkswap /swapfile
+swapon /swapfile
+echo '/swapfile none swap sw 0 0' >> /etc/fstab
+```
+
+### 使用更轻量的模型
+
+如果遇到 OOM，考虑：
+
+- 使用基于 API 的模型（Claude、GPT）而不是本地模型
+- 将 `agents.defaults.model.primary` 设置为更小的模型
+
+### 监控内存
+
+```bash
+free -h
+htop
+```
+
+---
+
+## 持久化
+
+所有状态存储在：
+
+- `~/.openclaw/` — 配置、凭证、会话数据
+- `~/.openclaw/workspace/` — 工作区（SOUL.md、记忆等）
+
+这些在重启后保留。定期备份：
+
+```bash
+tar -czvf openclaw-backup.tar.gz ~/.openclaw ~/.openclaw/workspace
+```
+
+---
+
+## Oracle Cloud 免费替代方案
+
+Oracle Cloud 提供 **Always Free** ARM 实例，比这里任何付费选项都强大得多 — 每月 $0。
+
+| 你将获得       | 配置             |
+| -------------- | ---------------- |
+| **4 OCPUs**    | ARM Ampere A1    |
+| **24GB RAM**   | 绰绰有余         |
+| **200GB 存储** | 块存储卷         |
+| **永久免费**   | 不收取信用卡费用 |
+
+**注意事项：**
+
+- 注册可能有点麻烦（失败了就重试）
+- ARM 架构 — 大多数东西都能工作，但有些二进制文件需要 ARM 构建
+
+完整设置指南请参阅 [Oracle Cloud](/platforms/oracle)。关于注册技巧和注册流程故障排除，请参阅此[社区指南](https://gist.github.com/rssnyder/51e3cfedd730e7dd5f4a816143b25dbd)。
+
+---
+
+## 故障排除
+
+### Gateway 网关无法启动
+
+```bash
+openclaw gateway status
+openclaw doctor --non-interactive
+journalctl -u openclaw --no-pager -n 50
+```
+
+### 端口已被使用
+
+```bash
+lsof -i :18789
+kill <PID>
+```
+
+### 内存不足
+
+```bash
+# Check memory
+free -h
+
+# Add more swap
+# Or upgrade to $12/mo droplet (2GB RAM)
+```
+
+---
+
+## 另请参阅
+
+- [Hetzner 指南](/install/hetzner) — 更便宜、更强大
+- [Docker 安装](/install/docker) — 容器化设置
+- [Tailscale](/gateway/tailscale) — 安全远程访问
+- [配置](/gateway/configuration) — 完整配置参考

package/docs/zh-CN/platforms/index.md

@@ -0,0 +1,60 @@
+---
+read_when:
+  - 查找操作系统支持或安装路径时
+  - 决定在哪里运行 Gateway 网关时
+summary: 平台支持概述（Gateway 网关 + 配套应用）
+title: 平台
+x-i18n:
+  generated_at: "2026-02-03T07:52:07Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 254852a5ed1996982a52eed4a72659477609e08d340c625d24ef6d99c21eece6
+  source_path: platforms/index.md
+  workflow: 15
+---
+
+# 平台
+
+OpenClaw 核心使用 TypeScript 编写。**Node 是推荐的运行时**。
+不推荐 Bun 用于 Gateway 网关（WhatsApp/Telegram 存在 bug）。
+
+配套应用适用于 macOS（菜单栏应用）和移动节点（iOS/Android）。Windows 和
+Linux 配套应用已在计划中，但 Gateway 网关目前已完全支持。
+Windows 原生配套应用也在计划中；推荐通过 WSL2 使用 Gateway 网关。
+
+## 选择你的操作系统
+
+- macOS：[macOS](/platforms/macos)
+- iOS：[iOS](/platforms/ios)
+- Android：[Android](/platforms/android)
+- Windows：[Windows](/platforms/windows)
+- Linux：[Linux](/platforms/linux)
+
+## VPS 和托管
+
+- VPS 中心：[VPS 托管](/vps)
+- Fly.io：[Fly.io](/install/fly)
+- Hetzner（Docker）：[Hetzner](/install/hetzner)
+- GCP（Compute Engine）：[GCP](/install/gcp)
+- exe.dev（VM + HTTPS 代理）：[exe.dev](/install/exe-dev)
+
+## 常用链接
+
+- 安装指南：[入门指南](/start/getting-started)
+- Gateway 网关运行手册：[Gateway 网关](/gateway)
+- Gateway 网关配置：[配置](/gateway/configuration)
+- 服务状态：`openclaw gateway status`
+
+## Gateway 网关服务安装（CLI）
+
+使用以下任一方式（均支持）：
+
+- 向导（推荐）：`openclaw onboard --install-daemon`
+- 直接安装：`openclaw gateway install`
+- 配置流程：`openclaw configure` → 选择 **Gateway service**
+- 修复/迁移：`openclaw doctor`（提供安装或修复服务）
+
+服务目标取决于操作系统：
+
+- macOS：LaunchAgent（`bot.molt.gateway` 或 `bot.molt.<profile>`；旧版 `com.openclaw.*`）
+- Linux/WSL2：systemd 用户服务（`openclaw-gateway[-<profile>].service`）

package/docs/zh-CN/platforms/ios.md

@@ -0,0 +1,114 @@
+---
+read_when:
+  - 配对或重新连接 iOS 节点
+  - 从源码运行 iOS 应用
+  - 调试 Gateway 网关发现或 canvas 命令
+summary: iOS 节点应用：连接到 Gateway 网关、配对、canvas 和故障排除
+title: iOS 应用
+x-i18n:
+  generated_at: "2026-02-03T07:52:17Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 692eebdc82e4bb8dc221bcbabf6a344a861a839fc377f1aeeb6eecaa4917a232
+  source_path: platforms/ios.md
+  workflow: 15
+---
+
+# iOS 应用（节点）
+
+可用性：内部预览。iOS 应用尚未公开分发。
+
+## 功能
+
+- 通过 WebSocket（LAN 或 tailnet）连接到 Gateway 网关。
+- 暴露节点能力：Canvas、屏幕快照、相机捕获、位置、对话模式、语音唤醒。
+- 接收 `node.invoke` 命令并报告节点状态事件。
+
+## 要求
+
+- Gateway 网关运行在另一台设备上（macOS、Linux 或通过 WSL2 的 Windows）。
+- 网络路径：
+  - 通过 Bonjour 的同一 LAN，**或**
+  - 通过单播 DNS-SD 的 Tailnet（示例域：`openclaw.internal.`），**或**
+  - 手动主机/端口（备选）。
+
+## 快速开始（配对 + 连接）
+
+1. 启动 Gateway 网关：
+
+```bash
+openclaw gateway --port 18789
+```
+
+2. 在 iOS 应用中，打开设置并选择一个已发现的 Gateway 网关（或启用手动主机并输入主机/端口）。
+
+3. 在 Gateway 网关主机上批准配对请求：
+
+```bash
+openclaw nodes pending
+openclaw nodes approve <requestId>
+```
+
+4. 验证连接：
+
+```bash
+openclaw nodes status
+openclaw gateway call node.list --params "{}"
+```
+
+## 发现路径
+
+### Bonjour（LAN）
+
+Gateway 网关在 `local.` 上广播 `_openclaw-gw._tcp`。iOS 应用会自动列出这些。
+
+### Tailnet（跨网络）
+
+如果 mDNS 被阻止，使用单播 DNS-SD 区域（选择一个域；示例：`openclaw.internal.`）和 Tailscale 分割 DNS。
+参见 [Bonjour](/gateway/bonjour) 了解 CoreDNS 示例。
+
+### 手动主机/端口
+
+在设置中，启用**手动主机**并输入 Gateway 网关主机 + 端口（默认 `18789`）。
+
+## Canvas + A2UI
+
+iOS 节点渲染一个 WKWebView canvas。使用 `node.invoke` 来驱动它：
+
+```bash
+openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18793/__openclaw__/canvas/"}'
+```
+
+注意事项：
+
+- Gateway 网关 canvas 主机服务于 `/__openclaw__/canvas/` 和 `/__openclaw__/a2ui/`。
+- 当广播了 canvas 主机 URL 时，iOS 节点在连接时自动导航到 A2UI。
+- 使用 `canvas.navigate` 和 `{"url":""}` 返回内置脚手架。
+
+### Canvas eval / snapshot
+
+```bash
+openclaw nodes invoke --node "iOS Node" --command canvas.eval --params '{"javaScript":"(() => { const {ctx} = window.__openclaw; ctx.clearRect(0,0,innerWidth,innerHeight); ctx.lineWidth=6; ctx.strokeStyle=\"#ff2d55\"; ctx.beginPath(); ctx.moveTo(40,40); ctx.lineTo(innerWidth-40, innerHeight-40); ctx.stroke(); return \"ok\"; })()"}'
+```
+
+```bash
+openclaw nodes invoke --node "iOS Node" --command canvas.snapshot --params '{"maxWidth":900,"format":"jpeg"}'
+```
+
+## 语音唤醒 + 对话模式
+
+- 语音唤醒和对话模式在设置中可用。
+- iOS 可能会暂停后台音频；当应用不活跃时，将语音功能视为尽力而为。
+
+## 常见错误
+
+- `NODE_BACKGROUND_UNAVAILABLE`：将 iOS 应用带到前台（canvas/相机/屏幕命令需要它）。
+- `A2UI_HOST_NOT_CONFIGURED`：Gateway 网关未广播 canvas 主机 URL；检查 [Gateway 网关配置](/gateway/configuration) 中的 `canvasHost`。
+- 配对提示从未出现：运行 `openclaw nodes pending` 并手动批准。
+- 重新安装后重连失败：钥匙串配对令牌已被清除；重新配对节点。
+
+## 相关文档
+
+- [配对](/gateway/pairing)
+- [设备发现](/gateway/discovery)
+- [Bonjour](/gateway/bonjour)

package/docs/zh-CN/platforms/linux.md

@@ -0,0 +1,101 @@
+---
+read_when:
+  - 查找 Linux 配套应用状态时
+  - 规划平台覆盖或贡献时
+summary: Linux 支持 + 配套应用状态
+title: Linux 应用
+x-i18n:
+  generated_at: "2026-02-03T07:52:18Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: a9bbbcecf2fd522a2f5ac8f3b9068febbc43658465bfb9276bff6c3e946789d2
+  source_path: platforms/linux.md
+  workflow: 15
+---
+
+# Linux 应用
+
+Gateway 网关在 Linux 上完全支持。**Node 是推荐的运行时**。
+不推荐 Bun 用于 Gateway 网关（WhatsApp/Telegram 存在 bug）。
+
+原生 Linux 配套应用已在计划中。如果你想帮助构建，欢迎贡献。
+
+## 新手快速路径（VPS）
+
+1. 安装 Node 22+
+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/` 并粘贴你的令牌
+
+分步 VPS 指南：[exe.dev](/install/exe-dev)
+
+## 安装
+
+- [入门指南](/start/getting-started)
+- [安装与更新](/install/updating)
+- 可选流程：[Bun（实验性）](/install/bun)、[Nix](/install/nix)、[Docker](/install/docker)
+
+## Gateway 网关
+
+- [Gateway 网关运行手册](/gateway)
+- [配置](/gateway/configuration)
+
+## Gateway 网关服务安装（CLI）
+
+使用以下任一方式：
+
+```
+openclaw onboard --install-daemon
+```
+
+或：
+
+```
+openclaw gateway install
+```
+
+或：
+
+```
+openclaw configure
+```
+
+出现提示时选择 **Gateway service**。
+
+修复/迁移：
+
+```
+openclaw doctor
+```
+
+## 系统控制（systemd 用户单元）
+
+OpenClaw 默认安装 systemd **用户**服务。对于共享或常驻服务器使用**系统**
+服务。完整的单元示例和指南
+在 [Gateway 网关运行手册](/gateway) 中。
+
+最小设置：
+
+创建 `~/.config/systemd/user/openclaw-gateway[-<profile>].service`：
+
+```
+[Unit]
+Description=OpenClaw Gateway (profile: <profile>, v<version>)
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+ExecStart=/usr/local/bin/openclaw gateway --port 18789
+Restart=always
+RestartSec=5
+
+[Install]
+WantedBy=default.target
+```
+
+启用它：
+
+```
+systemctl --user enable --now openclaw-gateway[-<profile>].service
+```