Chuyển đến nội dung chính

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.

Chạy OpenClaw Gateway bền bỉ trên DigitalOcean Droplet (~6 USD/tháng cho gói Basic 1 GB). DigitalOcean là lộ trình VPS trả phí đơn giản nhất. Nếu bạn muốn các tùy chọn rẻ hơn hoặc miễn phí:
  • Hetzner — 3,79 €/tháng, nhiều lõi/RAM hơn trên mỗi đô la.
  • Oracle Cloud — ARM Always Free (tối đa 4 OCPU, 24 GB RAM), nhưng đăng ký có thể khá khó khăn và chỉ hỗ trợ ARM.

​
Điều kiện tiên quyết

  • Tài khoản DigitalOcean (đăng ký)
  • Cặp khóa SSH (hoặc sẵn sàng dùng xác thực bằng mật khẩu)
  • Khoảng 20 phút

​
Thiết lập

1

Tạo một Droplet

Dùng ảnh nền sạch (Ubuntu 24.04 LTS). Tránh ảnh 1-click của Marketplace bên thứ ba trừ khi bạn đã xem xét các script khởi động và mặc định tường lửa của chúng.
  1. Đăng nhập vào DigitalOcean.
  2. Nhấp Create > Droplets.
  3. Chọn:
    • Khu vực: Gần bạn nhất
    • Ảnh: Ubuntu 24.04 LTS
    • Kích thước: Basic, Regular, 1 vCPU / 1 GB RAM / 25 GB SSD
    • Xác thực: Khóa SSH (khuyến nghị) hoặc mật khẩu
  4. Nhấp Create Droplet và ghi lại địa chỉ IP.
2

Kết nối và cài đặt

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
Chỉ dùng shell root cho bước khởi tạo hệ thống. Chạy các lệnh OpenClaw dưới người dùng không phải root openclaw để trạng thái nằm dưới /home/openclaw/.openclaw/ và Gateway được cài đặt dưới dạng dịch vụ systemd của người dùng đó.
3

Chạy quy trình hướng dẫn ban đầu

openclaw onboard --install-daemon
Trình hướng dẫn sẽ dẫn bạn qua xác thực mô hình, thiết lập kênh, tạo token Gateway và cài đặt daemon (systemd).
4

Thêm swap (khuyến nghị cho Droplet 1 GB)

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

Xác minh Gateway

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

Truy cập giao diện điều khiển

Theo mặc định, Gateway liên kết với loopback. Chọn một trong các tùy chọn sau.Tùy chọn A: Đường hầm SSH (đơn giản nhất)
# From your local machine
ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP
Sau đó mở http://localhost:18789.Tùy chọn 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
Sau đó mở https://<magicdns>/ từ bất kỳ thiết bị nào trên tailnet của bạn.Tailscale Serve xác thực giao diện điều khiển và lưu lượng WebSocket thông qua header nhận dạng tailnet, giả định rằng chính máy chủ Gateway là đáng tin cậy. Các endpoint HTTP API vẫn tuân theo chế độ xác thực bình thường của Gateway (token/mật khẩu). Để yêu cầu thông tin xác thực bí mật dùng chung rõ ràng qua Serve, hãy đặt gateway.auth.allowTailscale: false và dùng gateway.auth.mode: "token" hoặc "password".Tùy chọn C: Liên kết tailnet (không dùng Serve)
openclaw config set gateway.bind tailnet
openclaw gateway restart
Sau đó mở http://<tailscale-ip>:18789 (yêu cầu token).

​
Tính bền bỉ và sao lưu

Trạng thái OpenClaw nằm dưới:
  • ~/.openclaw/ — openclaw.json, auth-profiles.json theo từng agent, trạng thái kênh/nhà cung cấp và dữ liệu phiên.
  • ~/.openclaw/workspace/ — workspace của agent (SOUL.md, bộ nhớ, artifact).
Các dữ liệu này vẫn tồn tại sau khi Droplet khởi động lại. Để tạo snapshot có thể di chuyển: 
openclaw backup create
Snapshot của DigitalOcean sao lưu toàn bộ Droplet; openclaw backup create có thể di chuyển giữa các máy chủ.

​
Mẹo cho RAM 1 GB

Droplet 6 USD chỉ có 1 GB RAM. Để mọi thứ chạy mượt:
  • Đảm bảo bước swap ở trên nằm trong /etc/fstab để nó tồn tại sau khi khởi động lại.
  • Ưu tiên các mô hình dựa trên API (Claude, GPT) thay vì mô hình cục bộ — suy luận LLM cục bộ không phù hợp với 1 GB.
  • Đặt agents.defaults.model.primary thành một mô hình nhỏ hơn nếu bạn gặp OOM trên prompt lớn.
  • Theo dõi bằng free -h và htop.

​
Khắc phục sự cố

Gateway không khởi động — Chạy openclaw doctor --non-interactive và kiểm tra nhật ký bằng journalctl --user -u openclaw-gateway.service -n 50. Cổng đã được sử dụng — Chạy lsof -i :18789 để tìm tiến trình, rồi dừng tiến trình đó. Hết bộ nhớ — Xác minh swap đang hoạt động bằng free -h. Nếu vẫn gặp OOM, hãy dùng các mô hình dựa trên API (Claude, GPT) thay vì mô hình cục bộ, hoặc nâng cấp lên Droplet 2 GB.

​
Bước tiếp theo

  • Kênh — kết nối Telegram, WhatsApp, Discord và nhiều kênh khác
  • Cấu hình Gateway — tất cả tùy chọn cấu hình
  • Cập nhật — giữ OpenClaw luôn cập nhật

​
Liên quan