Lai uzstādītu OpenClaw uz VPS, tev vajag tīru Ubuntu 24.04 serveri, parastu (ne root) lietotāju un Node 24.16+ vai 26.1+, pēc tam vienu komandu: curl -fsSL https://openclaw.ai/install.sh | bash, kam seko openclaw onboard --install-daemon, kas saglabā tavu modeļa atslēgu, ieraksta vārtejas konfigurāciju un reģistrē systemd servisu. Atstāj vārteju uz noklusētās loopback saistes (ports 18789), pie Control UI ej caur SSH tuneli, pieslēdz Telegram botu un apstiprini sevi kā vienīgo atļauto sūtītāju. Viss process aizņem apmēram 15 minūtes; Docker ir alternatīvais ceļš, ja dod priekšroku konteineriem.
Pārrakstīts 2026. gada septembrī pēc oficiālās dokumentācijas un pašreizējā stabilā laidiena v2026.9.4 (2026. gada 11. septembris): galvenās komandas no mūsu 2026. gada februāra versijas nav mainījušās, bet Node prasība, atjaunināšanas gaita, Telegram atļauto sarakstu formāts un drošības noklusējumi ir aizgājuši tālāk.
Pirms sāc: OS, servera izmērs, lietotājs
OpenClaw darbojas uz macOS, Linux un Windows; uz servera tas nozīmē Linux. Mēs izmantojam Ubuntu 24.04 LTS, jo vārteja balstās uz systemd lietotāja servisiem un šis laidiens gadiem saņem drošības atjauninājumus; izvairies no minimāliem attēliem bez systemd.
Vārteja ir viegla Node lietotne. Mūsu izvietojumos 2 vCPU un 4 GB RAM ir ērti vienam īpašniekam, kas izmanto mitinātu modeli (OpenAI, Anthropic vai ar OpenAI saderīgu vārteju, piemēram, avots.ai). Ja plāno tajā pašā mašīnā darbināt lokālu modeli caur Ollama, izmēru nosaka modelis; skati kāds serveris darbina lokālu AI modeli. Der jebkurš plāns no mūsu VPS kataloga ar Ubuntu 24.04. Sagatavo: SSH piekļuvi, vienu pakalpojumu sniedzēja API atslēgu un Telegram kontu.
1. solis: sagatavo Ubuntu 24.04
Vienreiz pieslēdzies kā root, atjaunini sistēmu un izveido lietotāju, kam piederēs vārteja. Vārtejas rokasgrāmata (runbook) ir nepārprotama: nedarbini vārteju kā root.
apt update && apt upgrade -y
adduser openclaw
usermod -aG sudo openclaw
ufw allow OpenSSH
ufw enable
Šajā pamācībā vārtejas ports uz internetu netiek atvērts nekad, tāpēc SSH ir vienīgais ugunsmūra noteikums. No šī brīža pieslēdzies kā jaunais lietotājs (ssh openclaw@your-server) un paliec tur.
Node.js
OpenClaw prasa Node 24.16+ vai 26.1+, un dokumentācija iesaka Node 26. Oficiālais instalators uz Linux pats ieliek atbalstīto Node 24 LTS līniju, ja Node trūkst, tāpēc ar A ceļu šo soli vari izlaist. Ja gribi pārvaldīt Node pats, dokumentācija Ubuntu gadījumā min NodeSource:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs
Der arī versiju pārvaldnieki (fnm, nvm, mise, asdf), bet inicializē tos čaulas startēšanas failā, citādi jaunās sesijās openclaw var netikt atrasts, jo PATH trūkst Node bin direktorijas.
2. solis: izvēlies uzstādīšanas ceļu
A ceļš (instalators vai npm) ieliek CLI globālajā npm prefiksā un darbina vārteju kā systemd lietotāja servisu; uz viena VPS tas ir vienkāršākais. B ceļš (Docker) darbina ghcr.io/openclaw/openclaw zem Docker Compose ar stāvokli sējumā (volume); izvēlies to, ja resursdators jau visu darbina konteineros.
A ceļš: instalatora skripts vai npm
curl -fsSL https://openclaw.ai/install.sh | bash
Skripts uzstāda CLI globāli un uzreiz sāk ievadi (onboarding). Lai uzstādītu tagad un konfigurētu vēlāk, dokumentētā forma ir curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard. Ekvivalents ar npm (npm 12 vai 11.16+):
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon
Karogs --allow-scripts=openclaw ir svarīgs: npm 12 pēc noklusējuma bloķē neapstiprinātus pakotņu dzīves cikla skriptus, un karogs atļauj OpenClaw preinstall un postinstall soļus (uz npm 11.15 vai vecāka to izlaid). pnpm un Bun varianti ir uzstādīšanas dokumentācijā. Pirms ej tālāk, pārbaudi ar openclaw --version un openclaw doctor.
B ceļš: Docker
Oficiālā Docker pamācība sākas "no repozitorija saknes", nepasakot, kā tur nokļūt, tāpēc vispirms klonē repozitoriju:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh
Vajag Docker Engine un Docker Compose v2. Stāvoklis glabājas sējumā /home/node/.openclaw, un Control UI atbild uz http://127.0.0.1:18789/ ar tokenu no ģenerētā .env. Tags :latest-browser pievieno Chromium un Playwright. Kanāli un diagnostika iet caur CLI konteineru:
docker compose run --rm openclaw-cli channels add --channel telegram --token "<token>"
docker compose run --rm openclaw-cli doctor --json
Viena nianse no mūsu pašu izvietojumiem: smilškastes (sandbox) aizmugure ir Docker, tāpēc smilškastes režīmam "all" konteinerizētā vārtejā vajag docker komandu tajā pašā konteinerī. Smilškaste pēc noklusējuma ir izslēgta un neprasa, lai pati vārteja darbotos konteinerī, tāpēc smilškastē ieliktiem rīkiem A ceļš ar Docker uz resursdatora ir vienkāršāks. Pilna atsauce: oficiālā Docker pamācība.
3. solis: ievade un pirmā pakalpojumu sniedzēja atslēga
openclaw onboard --install-daemon ir interaktīvais vednis plus servisa reģistrācija. Lokālajā režīmā tas izved cauri darba videi, modeļa pakalpojumu sniedzējam un autentifikācijai (API atslēga vai OAuth), vārtejas iestatījumiem (ports, saiste, noslēpumu glabāšana, pēc izvēles Tailscale piekļuve), kanāliem, pēc izvēles tīmekļa meklēšanai un prasmēm (skills), dēmonam un veselības pārbaudei. Konfigurācija nonāk ~/.openclaw/openclaw.json; vednis glabā pakalpojumu sniedzēja akreditācijas datus kā nosauktus autentifikācijas profilus, un mūsu izvietojumos paši noslēpumi dzīvo ~/.openclaw/.env. Dokumentācija formātu apraksta kā JSON5 (atļauti komentāri un beigu komati); mēs turam tīru JSON, ko pieņem jebkurš JSON5 parsētājs. OPENCLAW_STATE_DIR un OPENCLAW_CONFIG_PATH pārvieto stāvokļa direktoriju un konfigurāciju.
Noklusētais modelis tiek rakstīts kā provider/model zem agents.defaults.model.primary; pakalpojumu sniedzēju dokumentācija izmanto šo piemēru:
{
"agents": { "defaults": { "model": { "primary": "anthropic/claude-opus-4-6" } } }
}
OpenAI, Anthropic un Ollama katram ir sava lapa sadaļā providers. Ar OpenAI saderīga vārteja (mūsu izvietojumos avots.ai) iet zem models.providers, pielāgoto pakalpojumu sniedzēju kartes, kas konfigurācijas atsaucē indeksēta pēc pakalpojumu sniedzēja id; lauku nosaukumus kopē no turienes, nevis no vecākas pamācības. Vēlākie labojumi iet caur openclaw configure, openclaw config set <key> <value> vai Control UI.
4. solis: darbini vārteju kā servisu
Uz Linux openclaw gateway install (ko jau izpildīja onboard --install-daemon) izveido systemd lietotāja servisu. Uz VPS bez grafiskās sesijas svarīgi ir divi papildu soļi no rokasgrāmatas: bez lingering tava lietotāja sesija beidzas, kad atslēdzies, un vārteja apstājas līdz ar to, bet bez XDG_RUNTIME_DIR lietotāja kopne (user bus) nav sasniedzama no parastas SSH čaulas.
sudo loginctl enable-linger $(whoami)
export XDG_RUNTIME_DIR=/run/user/$(id -u)
systemctl --user enable --now openclaw-gateway.service
openclaw gateway status
Ikdienā: openclaw gateway status --deep, openclaw gateway restart, openclaw gateway stop, openclaw logs --follow, openclaw doctor --fix. Dokumentēta ir arī sistēmas līmeņa vienība /etc/systemd/system/openclaw-gateway.service ar User=<username> sadaļā [Service]. Nederīga konfigurācija iziet ar kodu 78, un vienība pēc tā nerestartējas; palaid openclaw doctor, nevis restartē.
5. solis: tikai loopback, SSH tunelis UI
Vārteja klausās uz porta 18789 un pēc noklusējuma saistās ar loopback (gateway.bind ārpus konteineriem atrisinās uz loopback). Tā arī atstāj. OpenClaw pēc uzbūves ir attālināta koda izpilde, tam jau bija viena klikšķa RCE caur tokena zādzību (CVE-2026-25253) plus izcelsmes validācijas trūkumi, un vārteja ne bez iemesla atsakās saistīties ārpus loopback bez autentifikācijas. Neliec portu arī aiz parasta reversā starpniekservera; vienīgā dokumentētā reversā starpniekservera shēma ir trusted-proxy autentifikācijas režīms. Dokumentācijas ieteiktais attālinātais ceļš ir Tailscale; rezerves variants ir SSH tunelis no tava klēpjdatora:
ssh -N -L 18789:127.0.0.1:18789 openclaw@your-server
Pēc tam lokāli atver http://127.0.0.1:18789. Autentifikācija caur tuneli joprojām ir vajadzīga; tokens tika iestatīts ievades laikā (gateway.auth.token vai vides mainīgais OPENCLAW_GATEWAY_TOKEN). Minimālais vārtejas bloks ir:
{
"gateway": {
"bind": "loopback",
"port": 18789
}
}
Pēc katras konfigurācijas izmaiņas palaid openclaw security audit; tas atzīmē autentifikācijas robus, atvērtas grupu politikas, riskantas rīku un smilškastes kombinācijas un konfigurācijas novirzes; --fix pielieto drošos labojumus. Drošības lapā ir atvēršanas rokasgrāmata ar pirmslidojuma un atcelšanas kontrolsarakstiem retajam gadījumam, kad ar loopback nepietiek.
6. solis: pieslēdz pirmo kanālu (Telegram)
- Telegram atver BotFather, nosūti
/newbot, seko norādēm un saglabā tokenu. - Nodod to OpenClaw:
openclaw channels add --channel telegram --token <bot-token>. Alternatīvas irchannels.telegram.botTokenkonfigurācijā vai vides mainīgaisTELEGRAM_BOT_TOKEN(tikai noklusētajam kontam). - Nosūti savam botam jebkādu ziņu. Telegram noklusētā DM politika ir pairing (sapārošana), tāpēc ziņa netiek apstrādāta; tā vietā saņem īsu sapārošanas kodu.
- Apstiprini sevi uz servera:
openclaw pairing list telegram, tadopenclaw pairing approve telegram <CODE>. Kodi beidzas pēc vienas stundas. - Pārliecinies par gatavību:
openclaw channels status --probe.
BotFather komandas /setprivacy un /setjoingroups nosaka, ko bots redz grupās; atstāj privātuma režīmu ieslēgtu, ja vien tev nevajag atbildes grupās.
7. solis: piesaisti aģentu tikai sev
Drošības modelis ir viena uzticības robeža uz vārteju: viens operators vai savstarpēji uzticīga komanda, nekad svešinieki. Telegram gadījumā dmPolicy pieņem pairing (noklusējums), allowlist, open vai disabled, un allowFrom uzskaita skaitliskus Telegram lietotāju id (prefiksi telegram: un tg: tiek normalizēti). Piekļuves kontroles lapa rāda shēmu tikai īpašniekam:
{
"channels": {
"telegram": {
"enabled": true,
"dmPolicy": "pairing",
"allowFrom": ["<YOUR_TELEGRAM_USER_ID>"],
"groupPolicy": "allowlist"
}
}
}
Vecas konfigurācijas ar @username ierakstiem uz skaitliskiem id migrē openclaw doctor --fix. Rīku atļaujas var ierobežot pa sūtītājiem ar toolsBySender, un rīku izpildi var pārcelt konteinerī, iestatot agents.defaults.sandbox.mode uz non-main vai all (off darbina rīkus tieši uz resursdatora). Dokumentācija godīgi atzīst, ka tā nav ideāla drošības robeža, bet tā būtiski ierobežo piekļuvi failu sistēmai un procesiem, kad modelis izdara kaut ko muļķīgu. Uztver katru ienākošo ziņu kā neuzticamu ievadi.
OpenClaw atjaunināšana
Dokumentētais ceļš ir iebūvētais atjauninātājs, kas nosaka tavu uzstādīšanas tipu (npm, pnpm, Bun vai git), validē kandidātu, kamēr vecā vārteja turpina strādāt, un tad to aktivizē un pārbauda:
openclaw update
openclaw doctor
openclaw gateway restart
openclaw health
openclaw update --dry-run parāda priekšskatījumu; --channel beta, --channel extended-stable un --channel dev pārslēdz kanālus. Extended-stable der serverim, ko negribi aiztikt katru mēnesi; v2026.6.35 (2026. gada 10. septembris) ir aprakstīts kā 2026. gada jūnija līnijas pēdējais laidiens, tāpēc pārbaudi dokumentācijā, kuru līniju kanāls seko tagad. Manuālais rezerves variants ir npm install -g openclaw@latest --allow-scripts=openclaw plus tās pašas trīs pārbaudes. Vispirms izveido ~/.openclaw rezerves kopiju; dokumentācija brīdina, ka automātiskās konfigurācijas kopijas nav pilna stāvokļa rezerves kopija. Uz Docker: docker compose pull openclaw-gateway openclaw-cli, tad docker compose up -d openclaw-gateway; vārteja uz sējuma izpilda savas startam drošās migrācijas.
Noņemšana
Secība ir serviss, stāvoklis, pakotne. Kamēr CLI vēl ir uz vietas, openclaw uninstall --all --yes --non-interactive izdara visu; manuālie soļi ir:
openclaw gateway stop
openclaw gateway uninstall
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
npm rm -g openclaw
Ja systemd vienība paliek: systemctl --user disable --now openclaw-gateway.service, tad dzēs ~/.config/systemd/user/openclaw-gateway.service un palaid systemctl --user daemon-reload. Atsauc Telegram tokenu BotFather un pakalpojumu sniedzēja atslēgu tā panelī; servera dzēšana neatsauc ne vienu, ne otru.
Kas mainījies kopš 2026. gada sākuma
- Versijas un kanāli. Laidieni ir datēti (gads.mēnesis.n). v2026.8.1 tika nosaukts par "OpenClaw 2.0" ar pārbūvētu tīmekļa saskarni un vienkāršāku ievadi; atjauninātājs piedāvā stable, beta, extended-stable un dev kanālus.
- Paaugstināts Node minimums. Vajadzīgs Node 24.16+ vai 26.1+, ieteicams Node 26; izmanto instalatoru vai NodeSource, nevis distributīva pakotni.
- Atjauninātājs.
openclaw updateir dokumentētais ceļš; v2026.9.2 pievienoja atjaunināšanas atskaites un atkopšanu, v2026.9.3 validāciju izolētā kandidāta stāvoklī. - Telegram atļauto saraksti. Tikai skaitliski lietotāju id;
@usernameieraksti ir mantojums, un tos migrē doctor. - Drošāki administrēšanas noklusējumi iznāca v2026.6.11;
openclaw security auditpārbauda tavu instanci pret tiem.
Ja labāk izlaistu 1. līdz 5. soli, mūsu gatavais OpenClaw serveris no 9.35 EUR mēnesī nāk ar Ubuntu 24.04 un vārteju, kas jau uzstādīta uz loopback; tu pievieno modeļa atslēgu un Telegram botu. Par mitinātu modeli pret savu modeli skati AI aģents vai savs AI modelis, bet par GPU balstītām iespējām AI serveru lapu.
Jautājumi
Vai varu uzstādīt OpenClaw kā root, lai ietaupītu laiku?
Rokasgrāmata saka, ka nē, un šeit tas ir būtiski: exec rīks izpilda čaulas komandas ar vārtejas lietotāja tiesībām, tāpēc root vārteja nodod modelim root. Izveido lietotāju un darbini vārteju tur.
Vai man vajag Docker, ja izmantoju npm ceļu?
Nē. Smilškaste pēc noklusējuma ir izslēgta, un vārteja darbojas bez Docker. Docker Engine uzstādi tikai tad, ja ieslēdz smilškasti, jo Docker ir tās aizmugure.
Vārteja strādā no SSH, bet apstājas, kad atslēdzos
Tā ir lingering problēma. Palaid sudo loginctl enable-linger $(whoami), lai systemd lietotāja sesija pārdzīvo atslēgšanos, tad jaunā čaulā ar eksportētu XDG_RUNTIME_DIR pārbaudi openclaw gateway status.
Vai varu atvērt portu 18789 ar tokenu tuneļa vietā?
Vārteja saistās ārpus loopback tikai tad, ja konfigurēta autentifikācija, bet dokumentācija tik un tā virza uz Tailscale vai SSH tuneli un visam pārējam tur atvēršanas rokasgrāmatu. Ņemot vērā RCE vēsturi, uztver publisku atvēršanu kā pēdējo iespēju aiz ugunsmūra, nevis kā ērtību.