Przejdź do głównej treści

Documentation Index

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

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

Uruchom trwały OpenClaw Gateway na DigitalOcean Droplet (~6 USD/miesiąc za plan Basic 1 GB). DigitalOcean to najprostsza płatna ścieżka VPS. Jeśli wolisz tańsze lub darmowe opcje:
  • Hetzner — 3,79 €/mies., więcej rdzeni/RAM za dolara.
  • Oracle Cloud — Always Free ARM (do 4 OCPU, 24 GB RAM), ale rejestracja bywa problematyczna i dostępny jest tylko ARM.

​
Wymagania wstępne

  • Konto DigitalOcean (rejestracja)
  • Para kluczy SSH (albo gotowość do użycia uwierzytelniania hasłem)
  • Około 20 minut

​
Konfiguracja

1

Utwórz Droplet

Użyj czystego obrazu bazowego (Ubuntu 24.04 LTS). Unikaj zewnętrznych obrazów Marketplace typu 1-click, chyba że sprawdzono ich skrypty startowe i domyślne ustawienia zapory.
  1. Zaloguj się do DigitalOcean.
  2. Kliknij Create > Droplets.
  3. Wybierz:
    • Region: Najbliższy tobie
    • Image: Ubuntu 24.04 LTS
    • Size: Basic, Regular, 1 vCPU / 1 GB RAM / 25 GB SSD
    • Authentication: Klucz SSH (zalecane) albo hasło
  4. Kliknij Create Droplet i zanotuj adres IP.
2

Połącz się i zainstaluj

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
Używaj powłoki root tylko do rozruchowej konfiguracji systemu. Uruchamiaj polecenia OpenClaw jako użytkownik openclaw bez uprawnień root, aby stan znajdował się w /home/openclaw/.openclaw/, a Gateway został zainstalowany jako usługa systemd tego użytkownika.
3

Uruchom onboarding

openclaw onboard --install-daemon
Kreator przeprowadzi cię przez uwierzytelnianie modelu, konfigurację kanału, generowanie tokena gateway oraz instalację demona (systemd).
4

Dodaj swap (zalecane dla Dropletów 1 GB)

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

Zweryfikuj gateway

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

Uzyskaj dostęp do interfejsu Control UI

Gateway domyślnie wiąże się z loopback. Wybierz jedną z tych opcji.Opcja A: tunel SSH (najprostsze)
# From your local machine
ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP
Następnie otwórz http://localhost:18789.Opcja 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
Następnie otwórz https://<magicdns>/ z dowolnego urządzenia w swoim tailnet.Tailscale Serve uwierzytelnia ruch Control UI i WebSocket za pomocą nagłówków tożsamości tailnet, co zakłada, że sam host gateway jest zaufany. Punkty końcowe HTTP API używają normalnego trybu uwierzytelniania gateway (token/hasło) niezależnie od tego. Aby wymagać jawnych poświadczeń współdzielonego sekretu przez Serve, ustaw gateway.auth.allowTailscale: false i użyj gateway.auth.mode: "token" albo "password".Opcja C: wiązanie tailnet (bez Serve)
openclaw config set gateway.bind tailnet
openclaw gateway restart
Następnie otwórz http://<tailscale-ip>:18789 (wymagany token).

​
Trwałość i kopie zapasowe

Stan OpenClaw znajduje się w:
  • ~/.openclaw/ — openclaw.json, auth-profiles.json dla poszczególnych agentów, stan kanałów/dostawców oraz dane sesji.
  • ~/.openclaw/workspace/ — przestrzeń robocza agenta (SOUL.md, pamięć, artefakty).
Te dane przetrwają ponowne uruchomienia Dropleta. Aby utworzyć przenośną migawkę: 
openclaw backup create
Migawki DigitalOcean obejmują cały Droplet; openclaw backup create jest przenośne między hostami.

​
Wskazówki dla 1 GB RAM

Droplet za 6 USD ma tylko 1 GB RAM. Aby wszystko działało płynnie:
  • Upewnij się, że powyższy krok swap znajduje się w /etc/fstab, aby przetrwał ponowne uruchomienia.
  • Preferuj modele oparte na API (Claude, GPT) zamiast lokalnych — lokalne wnioskowanie LLM nie mieści się w 1 GB.
  • Ustaw agents.defaults.model.primary na mniejszy model, jeśli przy dużych promptach występują błędy OOM.
  • Monitoruj za pomocą free -h i htop.

​
Rozwiązywanie problemów

Gateway nie uruchamia się — Uruchom openclaw doctor --non-interactive i sprawdź logi za pomocą journalctl --user -u openclaw-gateway.service -n 50. Port jest już używany — Uruchom lsof -i :18789, aby znaleźć proces, a następnie go zatrzymaj. Brak pamięci — Sprawdź, czy swap jest aktywny, za pomocą free -h. Jeśli nadal występuje OOM, użyj modeli opartych na API (Claude, GPT) zamiast modeli lokalnych albo przejdź na Droplet 2 GB.

​
Następne kroki

​
Powiązane