@gguf/claw 2026.2.1 → 2026.2.2

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

@@ -0,0 +1,155 @@
+---
+read_when:
+  - 配对或重新连接 Android 节点
+  - 调试 Android Gateway网关发现或认证问题
+  - 验证跨客户端的聊天历史一致性
+summary: Android 应用（节点）：连接运维手册 + Canvas/聊天/相机
+title: Android 应用
+x-i18n:
+  generated_at: "2026-02-01T21:19:33Z"
+  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，**或**
+  - 同一 Tailscale tailnet，使用 Wide-Area Bonjour / 单播 DNS-SD（见下文），**或**
+  - 手动指定 Gateway网关主机/端口（备用方案）
+- 你可以在 Gateway网关机器上（或通过 SSH）运行 CLI（`openclaw`）。
+
+### 1）启动 Gateway网关
+
+```bash
+openclaw gateway --port 18789 --verbose
+```
+
+在日志中确认你看到类似内容：
+
+- `listening on ws://0.0.0.0:18789`
+
+对于仅 tailnet 的设置（推荐用于 Vienna ⇄ London），将 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)。
+
+#### Tailnet（Vienna ⇄ London）通过单播 DNS-SD 发现
+
+Android NSD/mDNS 发现无法跨网络工作。如果你的 Android 节点和 Gateway网关在不同网络上但通过 Tailscale 连接，请改用 Wide-Area Bonjour / 单播 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 节点的聊天界面使用 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）
+
+参见[相机节点](/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-01T21:20:02Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: d60559b8751da37413e5364e83c88254b476b2283386a0b07b2ca6b4e16157fc
+  source_path: platforms/digitalocean.md
+  workflow: 15
+---
+
+# 在 DigitalOcean 上运行 OpenClaw
+
+## 目标
+
+在 DigitalOcean 上运行持久化的 OpenClaw Gateway网关，费用为**每月 $6**（预留定价为每月 $4）。
+
+如果你想要每月 $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 指南](/platforms/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. 选择：
+   - **区域：** 离你（或你的用户）最近的
+   - **镜像：** Ubuntu 24.04 LTS
+   - **规格：** Basic → Regular → **$6/月**（1 vCPU, 1GB RAM, 25GB SSD）
+   - **认证：** SSH 密钥（推荐）或密码
+4. 点击 **Create Droplet**
+5. 记下 IP 地址
+
+## 2）通过 SSH 连接
+
+```bash
+ssh root@YOUR_DROPLET_IP
+```
+
+## 3）安装 OpenClaw
+
+```bash
+# 更新系统
+apt update && apt upgrade -y
+
+# 安装 Node.js 22
+curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
+apt install -y nodejs
+
+# 安装 OpenClaw
+curl -fsSL https://openclaw.ai/install.sh | bash
+
+# 验证
+openclaw --version
+```
+
+## 4）运行新手引导
+
+```bash
+openclaw onboard --install-daemon
+```
+
+向导将引导你完成：
+
+- 模型认证（API 密钥或 OAuth）
+- 渠道设置（Telegram、WhatsApp、Discord 等）
+- Gateway网关令牌（自动生成）
+- 守护进程安装（systemd）
+
+## 5）验证 Gateway网关
+
+```bash
+# 检查状态
+openclaw status
+
+# 检查服务
+systemctl --user status openclaw-gateway.service
+
+# 查看日志
+journalctl --user -u openclaw-gateway.service -f
+```
+
+## 6）访问控制面板
+
+Gateway网关默认绑定到 local loopback。要访问控制面板 UI：
+
+**方案 A：SSH 隧道（推荐）**
+
+```bash
+# 从你的本地机器
+ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP
+
+# 然后打开：http://localhost:18789
+```
+
+**方案 B：Tailscale Serve（HTTPS，仅 local loopback）**
+
+```bash
+# 在 Droplet 上
+curl -fsSL https://tailscale.com/install.sh | sh
+tailscale up
+
+# 配置 Gateway网关使用 Tailscale Serve
+openclaw config set gateway.tailscale.mode serve
+openclaw gateway restart
+```
+
+打开：`https://<magicdns>/`
+
+注意事项：
+
+- Serve 保持 Gateway网关仅绑定 local 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
+# 扫描二维码
+```
+
+其他提供商请参阅[渠道](/channels)。
+
+---
+
+## 1GB RAM 的优化建议
+
+$6 的 Droplet 只有 1GB RAM。为保持运行流畅：
+
+### 添加交换空间（推荐）
+
+```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 OCPU**     | 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
+# 检查内存
+free -h
+
+# 添加更多交换空间
+# 或升级到 $12/月的 Droplet（2GB RAM）
+```
+
+---
+
+## 另请参阅
+
+- [Hetzner 指南](/platforms/hetzner) — 更便宜，性能更强
+- [Docker 安装](/install/docker) — 容器化设置
+- [Tailscale](/gateway/tailscale) — 安全远程访问
+- [配置](/gateway/configuration) — 完整配置参考

package/docs/zh-CN/platforms/exe-dev.md

@@ -0,0 +1,127 @@
+---
+read_when:
+  - 你想要一个便宜的常驻 Linux 主机来运行 Gateway网关
+  - 你想在不自行运维 VPS 的情况下远程访问控制面板 UI
+summary: 在 exe.dev 上运行 OpenClaw Gateway网关（虚拟机 + HTTPS 代理）以实现远程访问
+title: exe.dev
+x-i18n:
+  generated_at: "2026-02-01T21:20:17Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: d4697efb0ff219f6222a932e89572182d311b267c393297b052c1296a6936eda
+  source_path: platforms/exe-dev.md
+  workflow: 15
+---
+
+# exe.dev
+
+目标：在 exe.dev 虚拟机上运行 OpenClaw Gateway网关，通过以下地址从你的笔记本访问：`https://<vm-name>.exe.xyz`
+
+本页假设使用 exe.dev 的默认 **exeuntu** 镜像。如果你选择了其他发行版，请相应调整软件包。
+
+## 新手快速路径
+
+1. [https://exe.new/openclaw](https://exe.new/openclaw)
+2. 根据需要填入你的认证密钥/令牌
+3. 点击虚拟机旁边的"Agent"，然后等待...
+4. ???
+5. 完成
+
+## 你需要什么
+
+- exe.dev 账户
+- 通过 `ssh exe.dev` 访问 [exe.dev](https://exe.dev) 虚拟机（可选）
+
+## 使用 Shelley 自动安装
+
+Shelley 是 [exe.dev](https://exe.dev) 的智能体，可以通过我们的提示词即时安装 OpenClaw。使用的提示词如下：
+
+```
+Set up OpenClaw (https://docs.openclaw.ai/install) on this VM. Use the non-interactive and accept-risk flags for openclaw onboarding. Add the supplied auth or token as needed. Configure nginx to forward from the default port 18789 to the root location on the default enabled site config, making sure to enable Websocket support. Pairing is done by "openclaw devices list" and "openclaw device approve <request id>". Make sure the dashboard shows that OpenClaw's health is OK. exe.dev handles forwarding from port 8000 to port 80/443 and HTTPS for us, so the final "reachable" should be <vm-name>.exe.xyz, without port specification.
+```
+
+## 手动安装
+
+## 1）创建虚拟机
+
+从你的设备：
+
+```bash
+ssh exe.dev new
+```
+
+然后连接：
+
+```bash
+ssh <vm-name>.exe.xyz
+```
+
+提示：保持此虚拟机为**有状态**。OpenClaw 将状态存储在 `~/.openclaw/` 和 `~/.openclaw/workspace/` 下。
+
+## 2）安装前置依赖（在虚拟机上）
+
+```bash
+sudo apt-get update
+sudo apt-get install -y git curl jq ca-certificates openssl
+```
+
+## 3）安装 OpenClaw
+
+运行 OpenClaw 安装脚本：
+
+```bash
+curl -fsSL https://openclaw.ai/install.sh | bash
+```
+
+## 4）配置 nginx 将 OpenClaw 代理到端口 8000
+
+编辑 `/etc/nginx/sites-enabled/default`：
+
+```
+server {
+    listen 80 default_server;
+    listen [::]:80 default_server;
+    listen 8000;
+    listen [::]:8000;
+
+    server_name _;
+
+    location / {
+        proxy_pass http://127.0.0.1:18789;
+        proxy_http_version 1.1;
+
+        # WebSocket 支持
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+
+        # 标准代理头
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+
+        # 长连接超时设置
+        proxy_read_timeout 86400s;
+        proxy_send_timeout 86400s;
+    }
+}
+```
+
+## 5）访问 OpenClaw 并授予权限
+
+访问 `https://<vm-name>.exe.xyz/?token=YOUR-TOKEN-FROM-TERMINAL`。使用 `openclaw devices list` 和 `openclaw device approve` 审批设备。如果不确定，可以从浏览器使用 Shelley！
+
+## 远程访问
+
+远程访问由 [exe.dev](https://exe.dev) 的认证机制处理。默认情况下，端口 8000 的 HTTP 流量会被转发到 `https://<vm-name>.exe.xyz`，并通过邮箱认证。
+
+## 更新
+
+```bash
+npm i -g openclaw@latest
+openclaw doctor
+openclaw gateway restart
+openclaw health
+```
+
+指南：[更新](/install/updating)