Here’s a detailed breakdown of installing and setting up OpenClaw on a Linux system:
System Prerequisites
- Memory:
- Minimum: 2 GB of RAM
-
Recommended: 4 GB of RAM for better performance.
-
Disk Space:
-
Ensure at least 20 GB of free disk space.
-
Node.js:
- Required version: 22 or higher.
- Install Node.js using NodeSource:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejsStep 1: Install Dependencies
Install essential development tools and utilities:
sudo apt update && sudo apt install -y curl git build-essential
- curl: Used for downloading scripts.
- git: For cloning repositories.
- build-essential: Provides tools like
gcc,g++, andmake.
Step 2: Run the Official Installer
Execute the installation script:
curl -fsSL https://openclaw.ai/install.sh | bashDuring the installation:
– Environment Check: The script checks for Node.js version and installs it if necessary.
– Security Prompt: Navigate using arrow keys and select “Yes” to proceed.
– Onboarding Mode: Choose “QuickStart” for default settings.Step 3: Initial Configuration (TUI)
After the script finishes, a Terminal User Interface (TUI) guides you through final configuration:
- Model Provider:
- Choose a cloud provider like OpenAI, Anthropic, or Gemini.
Alternatively, skip if using a local model.
Channel Setup:
- Connect OpenClaw to platforms like Telegram or Discord.
This can be set up later via the web dashboard.
Hatching:
- Initializes the workspace.
- Select “Hatch” in TUI to complete the setup.
Step 4: Accessing the Web Dashboard
Once installed, OpenClaw runs as a background service. Access the web-based GUI:
- Visit:
http://localhost:18789
Security Note: Do not expose port 18789 to the public internet. Use secure access methods like SSH tunneling or VPNs (e.g., Tailscale) for remote access.
Useful Commands
- Check Health:
-
Diagnose issues with:
openclaw doctor -
View Logs:
-
Monitor real-time logs:
openclaw logs --follow
-
Restart Service:
- Restart the service if needed:
openclaw gateway restart
By following these steps, you should have OpenClaw installed and running smoothly on your Linux system.
Leave a Reply