Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

在 DigitalOcean Droplet 上运行持久化的 OpenClaw Gateway 网关（1 GB Basic 方案约 $6/月）。 DigitalOcean 是最简单的付费 VPS 路径。如果你偏好更便宜或免费的选项：
  • Hetzner — €3.79/月，每美元可获得更多核心/RAM。
  • Oracle Cloud — Always Free ARM（最高 4 OCPU、24 GB RAM），但注册可能比较麻烦，并且仅限 ARM。

​
前提条件

  • DigitalOcean 账号（注册）
  • SSH 密钥对（或愿意使用密码认证）
  • 约 20 分钟

​
设置

1

创建 Droplet

使用干净的基础镜像（Ubuntu 24.04 LTS）。除非你已审查其启动脚本和防火墙默认设置，否则避免使用第三方 Marketplace 一键镜像。
  1. 登录 DigitalOcean。
  2. 点击 Create > Droplets。
  3. 选择：
    • 区域： 离你最近
    • 镜像： Ubuntu 24.04 LTS
    • 规格： Basic，Regular，1 vCPU / 1 GB RAM / 25 GB SSD
    • 认证： SSH 密钥（推荐）或密码
  4. 点击 Create Droplet 并记录 IP 地址。
2

连接并安装

ssh root@YOUR_DROPLET_IP

apt update && apt upgrade -y

# Install Node.js 24
curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
apt install -y nodejs

# Install OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# Create the non-root user that will own OpenClaw state and services.
adduser openclaw
usermod -aG sudo openclaw
loginctl enable-linger openclaw

su - openclaw
openclaw --version
仅将 root shell 用于系统引导。以非 root 的 openclaw 用户运行 OpenClaw 命令，这样状态会位于 /home/openclaw/.openclaw/ 下，Gateway 网关会安装为该用户的 systemd 服务。
3

运行新手引导

openclaw onboard --install-daemon
向导会引导你完成模型认证、渠道设置、Gateway 网关令牌生成和守护进程安装（systemd）。
4

添加 swap（建议 1 GB Droplet 使用）

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab
5

验证 Gateway 网关

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f
6

访问控制 UI

Gateway 网关默认绑定到 loopback。选择以下任一选项。选项 A：SSH 隧道（最简单）
# From your local machine
ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP
然后打开 http://localhost:18789。选项 B：Tailscale Serve
curl -fsSL https://tailscale.com/install.sh | sudo sh
sudo tailscale up
openclaw config set gateway.tailscale.mode serve
openclaw gateway restart
然后从你的 tailnet 上的任意设备打开 https://<magicdns>/。Tailscale Serve 通过 tailnet 身份标头认证控制 UI 和 WebSocket 流量，这假设 Gateway 网关主机本身可信。无论如何，HTTP API 端点都会遵循 Gateway 网关的正常认证模式（令牌/密码）。如果要在 Serve 上要求显式共享密钥凭证，请设置 gateway.auth.allowTailscale: false 并使用 gateway.auth.mode: "token" 或 "password"。选项 C：Tailnet 绑定（不使用 Serve）
openclaw config set gateway.bind tailnet
openclaw gateway restart
然后打开 http://<tailscale-ip>:18789（需要令牌）。

​
持久化和备份

OpenClaw 状态位于：
  • ~/.openclaw/ — openclaw.json、每个智能体的 auth-profiles.json、渠道/提供商状态和会话数据。
  • ~/.openclaw/workspace/ — 智能体工作区（SOUL.md、记忆、构件）。
这些内容会在 Droplet 重启后保留。要创建可移植快照： 
openclaw backup create
DigitalOcean 快照会备份整个 Droplet；openclaw backup create 可跨主机移植。

​
1 GB RAM 提示

$6 的 Droplet 只有 1 GB RAM。要保持运行顺畅：
  • 确保上面的 swap 步骤已写入 /etc/fstab，这样重启后仍会保留。
  • 优先使用基于 API 的模型（Claude、GPT），而不是本地模型 — 本地 LLM 推理无法适配 1 GB 内存。
  • 如果在大型提示词上遇到 OOM，请将 agents.defaults.model.primary 设置为更小的模型。
  • 使用 free -h 和 htop 监控。

​
故障排除

Gateway 网关无法启动 — 运行 openclaw doctor --non-interactive，并使用 journalctl --user -u openclaw-gateway.service -n 50 检查日志。 端口已被占用 — 运行 lsof -i :18789 查找进程，然后停止它。 内存不足 — 使用 free -h 验证 swap 是否处于活动状态。如果仍然遇到 OOM，请使用基于 API 的模型（Claude、GPT）而不是本地模型，或升级到 2 GB Droplet。

​
后续步骤

​
相关内容