Independent Field Manual — Not affiliated with, endorsed by, or operated by OpenClaw
Navigation

install vps

Ubuntu VPS par OpenClaw Install Karein

Ubuntu VPS par OpenClaw Gateway install karne ka complete, step-by-step field manual. Isme Node.js setup, workspace creation, aur safe installation verify karna cover kiya gaya hai.

Read in English
Difficulty
intermediate
Duration
25 minutes
Tested On
Ubuntu 24.04 LTS
Access Mode
SSH Tunnel / Tailscale
Pre-flight status
Pre-Flight Approved
Risk medium
Gateway Private
On this page
Proceed with caution Agar aap prerequisites follow karte hain toh yeh safe hai. Root ke roop mein install mat karein. Ensure karein ki shuru karne se pahle aapke paas ek non-root user ho.
Recommended access: SSH Tunnel or Tailscale

Short answer

Ek Ubuntu VPS par OpenClaw install karne ke teen main phases hote hain:

  1. Node.js install karna (nvm ke through)
  2. Ek OpenClaw workspace directory initialize karna
  3. Gateway process start karna aur SSH tunnel ke zariye isko safely access karna

Yeh guide aapko poore process ke through walk-through degi, yeh assume karke ki aap ek fresh Ubuntu server se start kar rahe hain.

Who this is for

Yeh guide Indian builders, freelancers, aur small businesses ke liye hai jo OpenClaw ko ek remote server (ek VPS) par 24/7 run karna chahte hain. Agar aap DigitalOcean, Hetzner, AWS Lightsail, ya Hostinger jaise providers par deploy kar rahe hain toh aapko is guide ka use karna chahiye.

Prerequisites

Is guide mein koi bhi command run karne se pahle, aapke paas yeh hona zaroori hai:

  • Ek Ubuntu VPS (22.04 ya 24.04 LTS recommended)
  • SSH access configured ho
  • sudo privileges ke saath ek non-root user (e.g., clawuser)

Agar aapne yeh abhi tak nahi kiya hai, toh rukiye aur pahle Fresh Ubuntu VPS Setup guide complete karein.

Step 1: nvm ka use karke Node.js install karein

OpenClaw ek Node.js application hai. Hum recommend karte hain ki Node.js ko apt ke bajaye nvm (Node Version Manager) ka use karke install karein, kyunki yeh permission issues avoid karta hai aur aapko versions ko easily switch karne deta hai.

Pahle, nvm install karein:

bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

nvm ko turant available karne ke liye, apne shell configuration ko reload karein:

bash
source ~/.bashrc

Ab, Node.js ka latest LTS (Long Term Support) version install karein:

bash
nvm install --lts

Installation ko verify karein:

bash
node -v && npm -v
v20.x.x\n10.x.x

Step 2: Ek workspace create karein

OpenClaw ko uske configuration, logs, aur local SQLite database ke liye ek dedicated folder chahiye hota hai.

Ek folder create karein aur uske andar jayein:

bash
mkdir -p ~/openclaw-workspace && cd ~/openclaw-workspace

Ek naya project initialize karein:

bash
npm init -y

Step 3: OpenClaw package install karein

OpenClaw core package ko apne workspace mein locally install karein:

bash
npm install @openclaw/core

Verify karein ki CLI available hai:

bash
npx openclaw --version

Step 4: Gateway ko start karein

Pahli baar Gateway ko start karne ka time aa gaya hai. Agar koi default configuration file (.env) exist nahi karti hai, toh Gateway use automatically generate kar dega.

bash
npx openclaw start

Is terminal window ko open rakhein. Hum dashboard access karenge, aur fir baad mein Gateway ko stop karenge.

Aapko logs dikhne chahiye jo indicate karenge ki Gateway start ho gaya hai:

[INFO] Gateway initialized\n[INFO] Listening on 127.0.0.1:18789

Step 5: Dashboard ko safely access karein

Kyunki Gateway aapke VPS par 127.0.0.1 par run ho raha hai, aap sirf VPS IP address ko apne browser mein type nahi kar sakte. Aapko ek SSH Tunnel create karna hoga.

Apne local laptop par ek naya terminal window open karein (OpenClaw run karne wale terminal ko close mat karein) aur run karein:

bash
ssh -L 18789:localhost:18789 clawuser@your_server_ip

clawuser aur your_server_ip ko apni actual details se replace karein.

Ab, apna web browser open karein aur yahan jayein:

http://localhost:18789

Aapko OpenClaw dashboard dikhna chahiye!

Step 6: Gateway ko stop karein

Uss terminal par wapas jayein jahan npx openclaw start run ho raha hai aur Gateway ko stop karne ke liye Ctrl+C press karein.

Isko stop kyun karein? Kyunki aapke SSH session se attached server run karne ka matlab hai ki aapka laptop close hote hi woh mar jayega. Ek baad ke guide mein, hum isko 24/7 run karne ke liye ek process manager (pm2) ka use karenge.

Common install failures

Error: EACCES: permission denied, mkdir

  • Cause: Aapne shayad sudo npm install use kiya.
  • Fix: npm ke saath kabhi sudo ka use mat karein. Folder ka ownership wapas apne user ko dein (sudo chown -R $USER:$USER ~/openclaw-workspace) aur bina sudo ke npm install run karein.

Error: Node version too old

  • Cause: Aapne Ubuntu ke default apt repository se Node.js install kiya, jo aksar outdated versions provide karta hai.
  • Fix: Apt version ko remove karein (sudo apt remove nodejs) aur nvm ke zariye install karne ke liye Step 1 follow karein.

Gateway start hota hai, lekin dashboard load nahi hoga

  • Cause: SSH tunnel nahi chal raha hai, ya aapne Gateway ko localhost ke alawa kisi aur IP par bind kiya hai.
  • Fix: Step 5 mein tunnel command ko verify karein. Detailed troubleshooting ke liye Dashboard Not Opening dekhein.

Kya NAHI karna hai

  • Apni .env file share mat karein. Isme secret keys hoti hain.
  • ufw allow 18789 run mat karein. Yeh aapke Gateway ko internet par expose kar deta hai.
  • npm install -g ka use mat karein. OpenClaw ko locally ek workspace folder mein install karein taaki aapke paas ek self-contained environment ho.

Uninstall / Rollback

Agar aapko completely fresh start karna hai, toh simply workspace folder aur uske contents ko delete kar dein:

bash
cd ~ && rm -rf ~/openclaw-workspace

Next steps

Ab jabki OpenClaw install ho gaya hai aur aap jante hain ki dashboard ko safely kaise access karna hai, toh channels ya AI models connect karne se pahle aapko apne VPS ko secure karna hoga.

Yahan jayein: OpenClaw VPS Security Checklist

Madad kab maangein

Agar aap permission errors, Node.js issues mein fas gaye hain, ya Gateway lagatar crash ho raha hai, toh Setup Help service ka use karein. Hum aapke setup ko bina koi raw secrets ya root passwords maange audit karne mein aapki madad kar sakte hain.

Yaad rakhein: Community ya support ke saath koi bhi logs share karne se pahle, apne API keys, tokens, aur IP addresses ko redact karein.

ClawReady.in is an independent educational resource and setup service. It is not affiliated with, endorsed by, or operated by OpenClaw.