@quantumclaw/quantumclaw 2026.3.22

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（`quantumclaw`）（或通过 SSH）。
+
+### 1）启动 Gateway 网关
+
+```bash
+quantumclaw gateway --port 18789 --verbose
+```
+
+在日志中确认你看到类似内容：
+
+- `listening on ws://0.0.0.0:18789`
+
+对于仅 tailnet 设置（推荐用于维也纳 ⇄ 伦敦），将 Gateway 网关绑定到 tailnet IP：
+
+- 在 Gateway 网关主机的 `~/.quantumclaw/quantumclaw.json` 中设置 `gateway.bind: "tailnet"`。
+- 重启 Gateway 网关 / macOS 菜单栏应用。
+
+### 2）验证发现（可选）
+
+从 Gateway 网关机器：
+
+```bash
+dns-sd -B _quantumclaw-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 区域（示例 `quantumclaw.internal.`）并发布 `_quantumclaw-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
+quantumclaw nodes pending
+quantumclaw nodes approve <requestId>
+```
+
+配对详情：[Gateway 网关配对](/gateway/pairing)。
+
+### 5）验证节点已连接
+
+- 通过节点状态：
+  ```bash
+  quantumclaw nodes status
+  ```
+- 通过 Gateway 网关：
+  ```bash
+  quantumclaw 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 网关主机上创建 `~/.quantumclaw/workspace/canvas/index.html`。
+
+2. 将节点导航到它（局域网）：
+
+```bash
+quantumclaw nodes invoke --node "<Android Node>" --command canvas.navigate --params '{"url":"http://<gateway-hostname>.local:18793/__quantumclaw__/canvas/"}'
+```
+
+Tailnet（可选）：如果两个设备都在 Tailscale 上，使用 MagicDNS 名称或 tailnet IP 而不是 `.local`，例如 `http://<gateway-magicdns>:18793/__quantumclaw__/canvas/`。
+
+此服务器将实时重载客户端注入 HTML 并在文件更改时重新加载。
+A2UI 主机位于 `http://<gateway-host>:18793/__quantumclaw__/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,273 @@
+---
+read_when:
+  - 在 DigitalOcean 上设置 QuantumClaw
+  - 寻找适合 QuantumClaw 的低价 VPS 托管
+summary: 在 DigitalOcean 上运行 QuantumClaw（简单的付费 VPS 选项）
+title: DigitalOcean
+x-i18n:
+  generated_at: "2026-03-16T06:24:23Z"
+  model: gpt-5.4
+  provider: openai
+  source_hash: f7cbbee2bdc2df08d2c255ee55fdf822c27924b41c4f4717cafb7e6e015d0966
+  source_path: platforms/digitalocean.md
+  workflow: 15
+---
+
+# 在 DigitalOcean 上运行 QuantumClaw
+
+## 目标
+
+在 DigitalOcean 上以 **每月 6 美元**（或预留定价时每月 4 美元）运行一个持久化的 QuantumClaw Gateway 网关。
+
+如果你想要每月 0 美元的方案，并且不介意 ARM + 提供商特定设置，请参阅 [Oracle Cloud 指南](/platforms/oracle)。
+
+## 成本对比（2026）
+
+| 提供商       | 套餐            | 规格                   | 每月价格       | 说明                             |
+| ------------ | --------------- | ---------------------- | -------------- | -------------------------------- |
+| Oracle Cloud | Always Free ARM | 最多 4 OCPU，24 GB RAM | $0             | ARM，容量有限 / 注册流程有些麻烦 |
+| Hetzner      | CX22            | 2 vCPU，4 GB RAM       | €3.79（约 $4） | 最便宜的付费选项                 |
+| DigitalOcean | Basic           | 1 vCPU，1 GB RAM       | $6             | UI 简单，文档完善                |
+| Vultr        | Cloud Compute   | 1 vCPU，1 GB RAM       | $6             | 机房位置多                       |
+| Linode       | Nanode          | 1 vCPU，1 GB RAM       | $5             | 现已并入 Akamai                  |
+
+**如何选择提供商：**
+
+- DigitalOcean：最简单的 UX + 可预测的设置（本指南）
+- Hetzner：性价比不错（见 [Hetzner guide](/install/hetzner)）
+- Oracle Cloud：可能做到每月 0 美元，但更挑环境且仅支持 ARM（见 [Oracle guide](/platforms/oracle)）
+
+---
+
+## 前提条件
+
+- DigitalOcean 账号（[注册可获 200 美元免费额度](https://m.do.co/c/signup)）
+- SSH 密钥对（或愿意使用密码认证）
+- 约 20 分钟
+
+## 1）创建 Droplet
+
+<Warning>
+请使用干净的基础镜像（Ubuntu 24.04 LTS）。除非你已经检查过其启动脚本和防火墙默认设置，否则请避免使用第三方 Marketplace 一键镜像。
+</Warning>
+
+1. 登录 [DigitalOcean](https://cloud.digitalocean.com/)
+2. 点击 **Create → Droplets**
+3. 选择：
+   - **Region：** 离你（或你的用户）最近
+   - **Image：** Ubuntu 24.04 LTS
+   - **Size：** Basic → Regular → **$6/mo**（1 vCPU、1 GB RAM、25 GB SSD）
+   - **Authentication：** SSH key（推荐）或密码
+4. 点击 **Create Droplet**
+5. 记下 IP 地址
+
+## 2）通过 SSH 连接
+
+```bash
+ssh root@YOUR_DROPLET_IP
+```
+
+## 3）安装 QuantumClaw
+
+```bash
+# 更新系统
+apt update && apt upgrade -y
+
+# 安装 Node.js 24
+curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
+apt install -y nodejs
+
+# 安装 QuantumClaw
+curl -fsSL https://quantumclaw.ai/install.sh | bash
+
+# 验证
+quantumclaw --version
+```
+
+## 4）运行新手引导
+
+```bash
+quantumclaw onboard --install-daemon
+```
+
+向导会带你完成以下设置：
+
+- 模型认证（API key 或 OAuth）
+- 渠道设置（Telegram、WhatsApp、Discord 等）
+- Gateway 网关 token（自动生成）
+- 守护进程安装（systemd）
+
+## 5）验证 Gateway 网关
+
+```bash
+# 检查状态
+quantumclaw status
+
+# 检查服务
+systemctl --user status quantumclaw-gateway.service
+
+# 查看日志
+journalctl --user -u quantumclaw-gateway.service -f
+```
+
+## 6）访问 Dashboard
+
+Gateway 网关默认绑定到 loopback。要访问 Control UI：
+
+**选项 A：SSH 隧道（推荐）**
+
+```bash
+# 在你的本地机器上
+ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP
+
+# 然后打开：http://localhost:18789
+```
+
+**选项 B：Tailscale Serve（HTTPS，仅 loopback）**
+
+```bash
+# 在 droplet 上
+curl -fsSL https://tailscale.com/install.sh | sh
+tailscale up
+
+# 将 Gateway 网关配置为使用 Tailscale Serve
+quantumclaw config set gateway.tailscale.mode serve
+quantumclaw gateway restart
+```
+
+打开：`https://<magicdns>/`
+
+说明：
+
+- Serve 会让 Gateway 网关保持仅 loopback，并通过 Tailscale 身份头对 Control UI/WebSocket 流量进行认证（无 token 认证假定 Gateway 网关主机可信；HTTP API 仍然需要 token/password）。
+- 如果你想强制要求 token/password，请设置 `gateway.auth.allowTailscale: false` 或使用 `gateway.auth.mode: "password"`。
+
+**选项 C：绑定到 tailnet（不使用 Serve）**
+
+```bash
+quantumclaw config set gateway.bind tailnet
+quantumclaw gateway restart
+```
+
+打开：`http://<tailscale-ip>:18789`（需要 token）。
+
+## 7）连接你的渠道
+
+### Telegram
+
+```bash
+quantumclaw pairing list telegram
+quantumclaw pairing approve telegram <CODE>
+```
+
+### WhatsApp
+
+```bash
+quantumclaw channels login whatsapp
+# 扫描 QR 码
+```
+
+其他提供商请参阅 [Channels](/channels)。
+
+---
+
+## 针对 1 GB RAM 的优化
+
+6 美元的 droplet 只有 1 GB 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
+```
+
+---
+
+## 持久化
+
+所有状态都存储在：
+
+- `~/.quantumclaw/` — 配置、凭证、会话数据
+- `~/.quantumclaw/workspace/` — 工作区（`SOUL.md`、memory 等）
+
+这些内容在重启后仍会保留。请定期备份：
+
+```bash
+tar -czvf quantumclaw-backup.tar.gz ~/.quantumclaw ~/.quantumclaw/workspace
+```
+
+---
+
+## Oracle Cloud 免费替代方案
+
+Oracle Cloud 提供 **Always Free** ARM 实例，性能显著强于这里列出的任何付费选项 —— 且每月 0 美元。
+
+| 你将获得        | 规格               |
+| --------------- | ------------------ |
+| **4 OCPU**      | ARM Ampere A1      |
+| **24 GB RAM**   | 完全足够           |
+| **200 GB 存储** | 块存储卷           |
+| **永久免费**    | 不会产生信用卡费用 |
+
+**注意事项：**
+
+- 注册过程可能比较挑剔（如果失败请重试）
+- ARM 架构 —— 大多数东西都能运行，但某些二进制文件需要 ARM 构建版本
+
+完整设置指南请参阅 [Oracle Cloud](/platforms/oracle)。关于注册技巧和注册流程故障排除，请参阅这篇[社区指南](https://gist.github.com/rssnyder/51e3cfedd730e7dd5f4a816143b25dbd)。
+
+---
+
+## 故障排除
+
+### Gateway 网关无法启动
+
+```bash
+quantumclaw gateway status
+quantumclaw doctor --non-interactive
+journalctl -u quantumclaw --no-pager -n 50
+```
+
+### 端口已被占用
+
+```bash
+lsof -i :18789
+kill <PID>
+```
+
+### 内存不足
+
+```bash
+# 检查内存
+free -h
+
+# 添加更多 swap
+# 或升级到每月 12 美元的 droplet（2 GB RAM）
+```
+
+---
+
+## 另请参阅
+
+- [Hetzner guide](/install/hetzner) — 更便宜、性能更强
+- [Docker install](/install/docker) — 容器化设置
+- [Tailscale](/gateway/tailscale) — 安全的远程访问
+- [Configuration](/gateway/configuration) — 完整配置参考

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

@@ -0,0 +1,60 @@
+---
+read_when:
+  - 查找操作系统支持或安装路径
+  - 决定在哪里运行 Gateway 网关
+summary: 平台支持概览（Gateway 网关 + 配套应用）
+title: 平台
+x-i18n:
+  generated_at: "2026-03-16T06:24:20Z"
+  model: gpt-5.4
+  provider: openai
+  source_hash: 653f395598b9558cb15b58ab42ed931dba47c70780be1c803d33dd795bad6503
+  source_path: platforms/index.md
+  workflow: 15
+---
+
+# 平台
+
+QuantumClaw 核心使用 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)
+- 服务状态：`quantumclaw gateway status`
+
+## Gateway 网关服务安装（CLI）
+
+使用以下任一方式（均受支持）：
+
+- 向导（推荐）：`quantumclaw onboard --install-daemon`
+- 直接安装：`quantumclaw gateway install`
+- 配置流程：`quantumclaw configure` → 选择 **Gateway 服务**
+- 修复/迁移：`quantumclaw doctor`（会提供安装或修复服务的选项）
+
+服务目标取决于操作系统：
+
+- macOS：LaunchAgent（`ai.quantumclaw.gateway` 或 `ai.quantumclaw.<profile>`；旧版为 `com.quantumclaw.*`）
+- Linux/WSL2：systemd 用户服务（`quantumclaw-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（示例域：`quantumclaw.internal.`），**或**
+  - 手动主机/端口（备选）。
+
+## 快速开始（配对 + 连接）
+
+1. 启动 Gateway 网关：
+
+```bash
+quantumclaw gateway --port 18789
+```
+
+2. 在 iOS 应用中，打开设置并选择一个已发现的 Gateway 网关（或启用手动主机并输入主机/端口）。
+
+3. 在 Gateway 网关主机上批准配对请求：
+
+```bash
+quantumclaw nodes pending
+quantumclaw nodes approve <requestId>
+```
+
+4. 验证连接：
+
+```bash
+quantumclaw nodes status
+quantumclaw gateway call node.list --params "{}"
+```
+
+## 发现路径
+
+### Bonjour（LAN）
+
+Gateway 网关在 `local.` 上广播 `_quantumclaw-gw._tcp`。iOS 应用会自动列出这些。
+
+### Tailnet（跨网络）
+
+如果 mDNS 被阻止，使用单播 DNS-SD 区域（选择一个域；示例：`quantumclaw.internal.`）和 Tailscale 分割 DNS。
+参见 [Bonjour](/gateway/bonjour) 了解 CoreDNS 示例。
+
+### 手动主机/端口
+
+在设置中，启用**手动主机**并输入 Gateway 网关主机 + 端口（默认 `18789`）。
+
+## Canvas + A2UI
+
+iOS 节点渲染一个 WKWebView canvas。使用 `node.invoke` 来驱动它：
+
+```bash
+quantumclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18793/__quantumclaw__/canvas/"}'
+```
+
+注意事项：
+
+- Gateway 网关 canvas 主机服务于 `/__quantumclaw__/canvas/` 和 `/__quantumclaw__/a2ui/`。
+- 当广播了 canvas 主机 URL 时，iOS 节点在连接时自动导航到 A2UI。
+- 使用 `canvas.navigate` 和 `{"url":""}` 返回内置脚手架。
+
+### Canvas eval / snapshot
+
+```bash
+quantumclaw nodes invoke --node "iOS Node" --command canvas.eval --params '{"javaScript":"(() => { const {ctx} = window.__quantumclaw; 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
+quantumclaw 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`。
+- 配对提示从未出现：运行 `quantumclaw nodes pending` 并手动批准。
+- 重新安装后重连失败：钥匙串配对令牌已被清除；重新配对节点。
+
+## 相关文档
+
+- [配对](/gateway/pairing)
+- [设备发现](/gateway/discovery)
+- [Bonjour](/gateway/bonjour)

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

@@ -0,0 +1,100 @@
+---
+read_when:
+  - 查找 Linux 配套应用状态
+  - 规划平台覆盖范围或贡献
+summary: Linux 支持 + 配套应用状态
+title: Linux 应用
+x-i18n:
+  generated_at: "2026-03-16T06:24:30Z"
+  model: gpt-5.4
+  provider: openai
+  source_hash: 12f2a28ec8fc17769210bda97af11fda332355956d41bba69ac51cc523be6178
+  source_path: platforms/linux.md
+  workflow: 15
+---
+
+# Linux 应用
+
+Gateway 网关在 Linux 上得到完全支持。**Node 是推荐的运行时**。
+不建议将 Bun 用于 Gateway 网关（存在 WhatsApp/Telegram bug）。
+
+原生 Linux 配套应用已在规划中。如果你想帮助构建一个，欢迎贡献。
+
+## 面向初学者的快速路径（VPS）
+
+1. 安装 Node 24（推荐；Node 22 LTS，目前 `22.16+`，为了兼容性仍然可用）
+2. `npm i -g quantumclaw@latest`
+3. `quantumclaw 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）
+
+使用以下任一方式：
+
+```
+quantumclaw onboard --install-daemon
+```
+
+或者：
+
+```
+quantumclaw gateway install
+```
+
+或者：
+
+```
+quantumclaw configure
+```
+
+出现提示时，选择 **Gateway 服务**。
+
+修复/迁移：
+
+```
+quantumclaw doctor
+```
+
+## 系统控制（systemd 用户单元）
+
+QuantumClaw 默认安装 systemd **用户**服务。对于共享或始终在线的服务器，请使用 **系统** 服务。完整的单元示例和指导
+请参见 [Gateway 网关运行手册](/gateway)。
+
+最小设置：
+
+创建 `~/.config/systemd/user/quantumclaw-gateway[-<profile>].service`：
+
+```
+[Unit]
+Description=QuantumClaw Gateway (profile: <profile>, v<version>)
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+ExecStart=/usr/local/bin/quantumclaw gateway --port 18789
+Restart=always
+RestartSec=5
+
+[Install]
+WantedBy=default.target
+```
+
+启用它：
+
+```
+systemctl --user enable --now quantumclaw-gateway[-<profile>].service
+```