Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

DisierTECH OpenClaw Stack
Node.js LTS Docker Ready Multi-Arch MIT License

πŸ¦€ DisierTECH β€” OpenClaw Stack

The production-ready cloud deployment guide for OpenClaw autonomous agents.
One-click installation Β· Multi-cloud support Β· Kernel-tuned performance

🌐 disier.tech · GitHub · LinkedIn


πŸ“– Table of Contents


🧠 Introduction

OpenClaw (formerly known as Moltbot and ClawdBot) is a persistent, local-first autonomous AI agent framework built on Node.js. Unlike cloud-hosted AI APIs, OpenClaw runs on your infrastructure β€” maintaining its own state, managing a local vector database (SQLite FTS5), executing operating system-level commands, and operating as a true digital surrogate.

Why Cloud Nodes Matter

Running OpenClaw on your laptop works great for development, but production agents need 24/7 uptime. Your machine sleeps, reboots, and disconnects β€” severing the agent's connection to the world. A cloud VPS provides:

Requirement Why It Matters
Persistent Uptime Webhooks, cron jobs, and email monitors run uninterrupted
RAM Availability OpenClaw loads contexts + vector indices into memory (300MB–700MB+)
NVMe/SSD Storage SQLite FTS5 hybrid retrieval demands low-latency disk I/O
Single-Core Speed Node.js is single-threaded; fast CPU = responsive agent
Security Isolation OpenClaw has shell execution capabilities β€” never run on a shared personal machine in production

This repository provides everything you need to deploy OpenClaw on any major cloud provider, with kernel-optimized configurations designed by DisierTECH.


☁️ Cloud Infrastructure Guide

πŸ”΅ DigitalOcean Β· β˜… Recommended

πŸ’° Credits $200 FREE for 60 days via referral
πŸŽ“ Students $200 for 1 year via GitHub Student Developer Pack
πŸ—οΈ Architecture x86_64 (KVM-based Droplets)
⚑ 1-Click Deploy Available in the DO Marketplace for OpenClaw

πŸ‘‰ Get $200 FREE Credit on DigitalOcean

Step-by-Step Setup

  1. Create Account β†’ Sign up via this referral link to claim your $200 credit (60 days).
  2. Create a Droplet:
    • Image: Debian 12 (Bookworm) or Ubuntu 24.04
    • Plan: Basic β€” $6/mo (1 vCPU, 1 GB RAM, 25 GB SSD) or $12/mo (1 vCPU, 2 GB RAM)
    • Region: Choose closest to your users
    • Authentication: SSH Key (never use passwords)
  3. Connect: ssh root@your-droplet-ip
  4. Run the Installer:
    curl -fsSL https://raw.githubusercontent.com/disi3r/DisierTECH-OpenClaw-Stack/main/install.sh | bash
  5. Deploy OpenClaw:
    docker compose up -d

Why DigitalOcean?

  • Predictable performance β€” No CPU throttling or "noisy neighbor" issues like burstable instances
  • 1-Click marketplace β€” Pre-configured OpenClaw images available
  • PayPal accepted β€” $5 pre-payment verification (no credit card required)
  • Superior DX β€” The cleanest dashboard and API in the industry

🟑 Google Cloud Platform (GCP)

πŸ’° Trial Credits $300 FREE for 90 days
♾️ Always Free e2-micro β€” 2 vCPUs (shared), 1 GB RAM, 30 GB disk
πŸ—οΈ Architecture x86_64 (shared-core)
πŸ“ Free Regions us-west1, us-central1, us-east1 only

πŸ”— Sign up for Google Cloud Free Tier

Step-by-Step Setup

  1. Create Account β†’ Go to cloud.google.com/free and claim your $300 trial credit.
  2. Strategy: Use the $300 credit to provision a more powerful e2-medium (4 GB RAM) for initial setup and testing. After 90 days, downsize to the e2-micro (Always Free).
  3. Create a VM Instance:
    • Machine type: e2-micro (Always Free) or e2-medium (during trial)
    • Boot disk: Debian 12, 30 GB Standard Persistent Disk
    • Region: us-central1 (recommended for free tier)
    • Firewall: Allow HTTP/HTTPS traffic
  4. Connect: Use the GCP Console SSH button or gcloud compute ssh
  5. ⚠️ MANDATORY β€” Create Swap (the e2-micro has only 1 GB RAM):
    curl -fsSL https://raw.githubusercontent.com/disi3r/DisierTECH-OpenClaw-Stack/main/install.sh | bash
    The install script automatically creates a 2 GB swap file and tunes vm.swappiness=10.

⚠️ Important: 1 GB RAM Limitation

The e2-micro instance has only 1 GB of RAM. Without swap, OpenClaw will crash during:

  • npm install (building native modules)
  • Vector database re-indexing
  • Memory-intensive skills (image processing, browser automation)

The install.sh script handles swap creation automatically.


πŸ”΄ Oracle Cloud Infrastructure (OCI)

πŸ’° Trial Credits $300 for 30 days
♾️ Always Free Ampere A1 β€” Up to 4 OCPUs, 24 GB RAM, 200 GB Block Storage
πŸ—οΈ Architecture ARM64 (Ampere Altra)
⚠️ Major Risk Out of Host Capacity errors + Idle Reclamation Policy

πŸ”— Sign up for Oracle Cloud Free Tier

Step-by-Step Setup

  1. Create Account β†’ Go to oracle.com/cloud/free
    • ⚠️ Strict verification β€” Requires a real credit/debit card (fintech/prepaid cards often rejected)
  2. Create a Compute Instance:
    • Shape: VM.Standard.A1.Flex (Ampere ARM)
    • Configuration: 4 OCPUs, 24 GB RAM (max free allocation)
    • Image: Canonical Ubuntu 24.04 aarch64 or Oracle Linux 9 aarch64
    • Storage: 200 GB Block Volume
    • Region: Try less popular regions (SΓ£o Paulo, Jeddah) if you get "Out of Host Capacity" errors in popular ones
  3. Open Ports β€” See Troubleshooting: Oracle VCN
  4. Install:
    curl -fsSL https://raw.githubusercontent.com/disi3r/DisierTECH-OpenClaw-Stack/main/install.sh | bash

⚠️ Critical: ARM64 Compatibility

Oracle's free tier uses ARM64 processors. Some Node.js native modules may lack pre-built ARM binaries, causing npm install to attempt compilation from source. The install.sh script pre-installs build-essential and python3 to handle this, but you may encounter node-gyp errors. Docker multi-arch images are the recommended mitigation.

⚠️ Critical: Idle Reclamation Policy

Oracle will terminate your Always Free instance if it idles for 7 days. Thresholds:

Metric Minimum Required
CPU Utilization (95th percentile) > 10%
Network Utilization > 10%
Memory Utilization > 10%

Mitigation: Set up a cron-based keep-alive script that generates periodic CPU and network activity. OpenClaw's active agent processes usually satisfy these thresholds naturally.


🟣 Microsoft Azure

πŸŽ“ Students $100 FREE for 12 months β€” NO credit card needed!
πŸ’° Standard Trial $200 for 30 days + 12 months of free services
♾️ Best Free VM B2pts v2 β€” 2 vCPUs, 4 GB RAM (ARM64) Β· 750 hrs/mo for 12 months

πŸ”— Azure for Students (No CC Required)
πŸ”— Azure Free Account

Step-by-Step Setup

  1. Students: Go to azure.microsoft.com/free/students and verify with your .edu email. No credit card required.
  2. Non-Students: Go to azure.microsoft.com/free and claim $200 for 30 days.
  3. Create a Virtual Machine:
    • Size: B2pts v2 (2 vCPUs, 4 GB RAM, ARM64) or B2ats v2 (AMD x86, 4 GB RAM)
    • Image: Debian 12 or Ubuntu 24.04
    • Authentication: SSH public key
    • ⚠️ Ensure you select the VM from the "Free Services" path β€” the portal defaults to paid options!
  4. Connect & Install:
    ssh azureuser@your-vm-ip
    curl -fsSL https://raw.githubusercontent.com/disi3r/DisierTECH-OpenClaw-Stack/main/install.sh | bash

Why Azure for Students?

  • No credit card barrier β€” The only major cloud provider that doesn't require one
  • 4 GB RAM on B2pts v2 β€” 4Γ— more memory than GCP's free tier
  • Renewable annually β€” As long as you maintain student status
  • $100 credit β€” Enough to run premium VMs for months of testing

🟠 Hostinger VPS Β· β˜… Best Value

πŸ’° Price From ~$4.24/mo (with coupon)
πŸ—οΈ KVM 1 1 vCPU, 4 GB RAM, 50 GB NVMe
πŸ—οΈ KVM 2 2 vCPUs, 8 GB RAM, 100 GB NVMe
πŸ’Ύ Storage NVMe SSD (fastest for vector DB operations)
πŸ”™ Trial 30-day money-back guarantee

πŸ‘‰ Get Hostinger VPS with DisierTECH Referral

πŸ’‘ Coupon: Use code CEVPS at checkout for up to 72% OFF.

Step-by-Step Setup

  1. Purchase a Plan β†’ Go to Hostinger VPS and select KVM 1 ($4.24/mo) or KVM 2 ($6.37/mo).
  2. Apply Coupon: Enter CEVPS at checkout for maximum discount.
  3. Configure Your Server:
    • OS: Debian 12 (Bookworm) β€” recommended for minimal overhead
    • Location: Choose closest data center
  4. Connect & Install:
    ssh root@your-hostinger-ip
    curl -fsSL https://raw.githubusercontent.com/disi3r/DisierTECH-OpenClaw-Stack/main/install.sh | bash

Why Hostinger?

  • NVMe storage β€” Superior IOPS for SQLite FTS5 vector search (faster agent memory recall)
  • KVM isolation β€” Dedicated resources, not shared/burstable
  • 4 GB RAM for ~$4/mo β€” 4Γ— the RAM of GCP's free tier at minimal cost
  • No reclamation anxiety β€” Unlike Oracle, your server won't be terminated for idling

πŸ“Š Cloud Provider Comparison

Feature Oracle Cloud Google Cloud Azure (Student) DigitalOcean Hostinger
Model Always Free Always Free 12 Months Free Credit Trial Paid
Instance Ampere A1 e2-micro B2pts v2 / B1s Basic Droplet KVM 1 / KVM 2
CPU Arch ARM64 x86_64 (Shared) ARM64 / x86_64 x86_64 x86_64 (KVM)
vCPUs 4 OCPUs 2 (0.25–2.0) 2 1 1–2
RAM 24 GB πŸ† 1 GB 4 GB 512 MB–1 GB 4–8 GB
Storage 200 GB Block 30 GB HDD/SSD 64 GB SSD (Paid) 50–100 GB NVMe
Bandwidth 10 TB/mo 1 GB Egress 15 GB Egress 1 TB 4 TB–Unlimited
Credits $300 (30 days) $300 (90 days) $100 (12 mo) $200 (60 days) N/A
CC Required? Yes (Strict) Yes No (Student) βœ… CC or PayPal Pre-payment
Availability ⚠️ Low βœ… High βœ… High βœ… High βœ… High
Major Risk Reclamation OOM Kills 12-Month Expiry Cost after trial No free tier
Best For Power Users Minimalists Students Developers Value/Perf

πŸ’‘ Paid Hosting Recommendation

When free trials expire, you need reliable, predictable infrastructure. Here are the top picks from DisierTECH:

πŸ₯‡ DigitalOcean β€” Best for Developers

πŸ‘‰ Claim $200 FREE Credit

  • Start free with $200 in credit for 60 days
  • Students get $200 for 1 full year via GitHub Education
  • Clean dashboard, robust API, and 1-click OpenClaw marketplace
  • Consistent CPU performance (no burstable throttling)
  • Recommended Plan: $6/mo Droplet (1 vCPU, 1 GB RAM) β€” runs OpenClaw stable with swap

πŸ₯‡ Hostinger β€” Best Value for Long-Term Hosting

πŸ‘‰ Get Hostinger VPS β€” Use code CEVPS for up to 72% OFF

  • 4 GB RAM + NVMe SSD for ~$4.24/mo β€” Unmatched value
  • KVM virtualization with dedicated resources
  • NVMe storage means faster vector database queries and agent startup
  • 30-day money-back guarantee
  • Recommended Plan: KVM 1 for solo agents, KVM 2 for multi-account setups

Quick Decision Matrix

Your Situation Recommended Provider
πŸŽ“ Student with .edu email Azure for Students (free, no CC)
πŸ’» Developer who wants it easy DigitalOcean ($200 free credit)
πŸ’° Best bang for your buck Hostinger KVM 1 (~$4/mo)
πŸ§ͺ Want maximum free resources Oracle Cloud (24 GB RAM, if available)
πŸ†“ Free forever, minimal setup Google Cloud e2-micro (1 GB RAM + swap)

πŸš€ One-Click Installation

The DisierTECH install script prepares any fresh Linux server for OpenClaw in a single command:

curl -fsSL https://raw.githubusercontent.com/disi3r/DisierTECH-OpenClaw-Stack/main/install.sh | bash

What It Does

Step Description
🎨 Branding Displays the DisierTECH ASCII banner
πŸ” Architecture Detection Auto-detects x86_64 vs ARM64
πŸ“¦ System Update Updates package manager and installs essentials
🟒 Node.js LTS Installs via NodeSource (ARM64 compatible)
🐍 Python 3 Required for node-gyp native module builds
🐳 Docker + Compose Installs Docker Engine + Compose plugin
πŸ’Ύ 2 GB Swap File Creates and activates swap (critical for 1 GB instances)
⚑ Kernel Tuning TCP optimizations + vm.swappiness=10 for high-concurrency
πŸ”’ Security Configures UFW firewall with sensible defaults

See install.sh for the full script.


🐳 Docker Compose Setup

After running install.sh, use this docker-compose.yml to deploy OpenClaw:

services:
  openclaw:
    image: openclaw/gateway:latest
    container_name: openclaw_agent
    restart: unless-stopped
    network_mode: "host"
    volumes:
      - ~/.openclaw:/root/.openclaw        # Persist agent identity & keys
      - ./workspace:/root/workspace         # Agent's working directory
    environment:
      - NODE_ENV=production
      - AGENT_secret_key=${SECRET_KEY}
    deploy:
      resources:
        limits:
          memory: 900M   # Leave headroom for OS on 1 GB instances
          cpus: '1.5'    # Limit CPU on shared-core instances

Launch:

docker compose up -d

View logs:

docker compose logs -f openclaw

πŸ”§ Troubleshooting

Oracle Cloud: VCN Ports Not Opening

Oracle Cloud has two layers of firewall rules. Opening a port in iptables alone is not enough.

  1. Security List (VCN Level):
    • Go to Networking β†’ Virtual Cloud Networks β†’ Your VCN β†’ Security Lists
    • Add an Ingress Rule:
      • Source CIDR: 0.0.0.0/0
      • Protocol: TCP
      • Destination Port Range: 3000 (OpenClaw Dashboard)
  2. OS Firewall (iptables):
    sudo iptables -I INPUT 6 -m state --state NEW -p tcp --dport 3000 -j ACCEPT
    sudo netfilter-persistent save

GCP / Azure: Out of Memory (OOM) Crashes

Symptom: OpenClaw process silently stops. dmesg | grep -i oom shows kill events.

Fix: Ensure the install.sh script ran successfully and created swap:

# Verify swap is active
free -h

# If no swap, create manually:
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
sudo sysctl vm.swappiness=10

Oracle Cloud: Idle Instance Reclamation

Symptom: Your Always Free instance is terminated after 7 days of low usage.

Fix: Set up a keep-alive cron job:

# Edit crontab
crontab -e

# Add this line (runs CPU stress every 6 hours for 2 minutes):
0 */6 * * * /usr/bin/timeout 120 /usr/bin/yes > /dev/null 2>&1

ARM64: npm install Fails with node-gyp Errors

Symptom: Native modules fail to compile on Oracle ARM instances.

Fix: Ensure build tools are installed:

sudo apt install -y build-essential python3 python3-pip libx11-dev

Alternatively, use Docker multi-arch images which handle cross-compilation automatically.

Docker: Permission Denied

Fix: Ensure your user is in the docker group:

sudo usermod -aG docker $USER
newgrp docker

SSH: Connection Refused After Changing Port

Fix: Ensure the new SSH port is allowed in the firewall before disconnecting:

sudo ufw allow 22022/tcp
sudo ufw reload

πŸ‘¨β€πŸ’» Contact & Socials

Daniel SΓ‘nchez
(disier)
Platform Link
🌐 Website disier.tech
πŸ’Ό LinkedIn linkedin.com/in/disier
πŸ™ GitHub github.com/disi3r

Affiliate & Referral Links

Provider Link Benefit
πŸ”΅ DigitalOcean m.do.co/c/18d7654d20a3 $200 free credit (60 days)
🟠 Hostinger hostinger.es?REFERRALCODE=DisierTECH Premium VPS from ~$4/mo

πŸ“„ License

This project is licensed under the MIT License.


Built with 🧠 by DisierTECH
If this guide helped you, consider using the referral links above β€” it supports the project at no extra cost to you. πŸ™

About

πŸ¦€ Production-ready cloud deployment guide & one-click installer for OpenClaw autonomous AI agents. Multi-cloud support (DigitalOcean, GCP, Oracle, Azure, Hostinger) with kernel-tuned performance.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages