@nhiensoft/openclaw-setup
v1.0.1
Published
One-command OpenClaw installer — works on macOS, Linux, WSL, and Windows
Maintainers
Readme
@nhiensoft/openclaw-setup
One-command interactive installer for OpenClaw — works on macOS, Linux, WSL, and Windows.
npx @nhiensoft/openclaw-setupWhat it does
The installer walks you through the complete OpenClaw setup in a single command:
- Detects your OS — macOS (Intel & Apple Silicon), Linux (Debian/Ubuntu, Fedora/RHEL, Arch, Alpine), WSL2, Windows
- Installs Node.js (>= v22) if missing — via fnm, Homebrew, winget, nvm-windows, or system package manager
- Installs Homebrew (macOS only) if missing
- Installs OpenClaw — downloads and runs the official installer
- Configures your AI provider — choose ClipProxy (pre-configured) or bring your own OpenAI-compatible API
- Selects your default model — Claude, Gemini, GPT, or custom
- Sets up Telegram bot (optional) — walk-through for BotFather token + pairing
- Installs & starts the daemon — system service + gateway
- Writes config to
~/.openclaw/openclaw.json
Installation
Run directly (no install needed)
npx @nhiensoft/openclaw-setupInstall globally
npm install -g @nhiensoft/openclaw-setup
openclaw-setupRun without npm (alternative)
macOS / Linux / WSL:
curl -fsSL https://raw.githubusercontent.com/nhiensoft/openclaw-setup/main/scripts/install.sh | bashWindows (PowerShell):
Set-ExecutionPolicy Bypass -Scope Process -Force
iwr -useb https://raw.githubusercontent.com/nhiensoft/openclaw-setup/main/scripts/install.ps1 | iexSupported platforms
| Platform | Shell | Node installer fallback | |---|---|---| | macOS (Apple Silicon) | bash | fnm > Homebrew > manual | | macOS (Intel) | bash | fnm > Homebrew > manual | | Ubuntu / Debian | bash | fnm > NodeSource (apt) | | Fedora / RHEL | bash | fnm > NodeSource (dnf/yum) | | Arch Linux | bash | fnm > pacman | | Alpine Linux | bash | fnm > apk | | WSL2 | bash | fnm > NodeSource | | Windows 10/11 | PowerShell 5.1+ / pwsh 7+ | winget > nvm-windows |
Available models (ClipProxy)
| Model | ID |
|---|---|
| Claude Sonnet 4.6 | claude-sonnet-4-6 |
| Claude Opus 4.6 Thinking | claude-opus-4-6-thinking |
| Gemini 2.5 Pro | gemini-2.5-pro |
| Gemini 2.5 Flash | gemini-2.5-flash |
| Gemini 3 Flash | gemini-3-flash |
| Gemini 3 Pro High | gemini-3-pro-high |
| Gemini 3.1 Pro High | gemini-3.1-pro-high |
| GPT OSS 120B Medium | gpt-oss-120b-medium |
Post-install commands
openclaw gateway # Start the gateway (port 18789)
openclaw gateway status # Check if running
openclaw dashboard # Open control UI in browser
openclaw onboard # Reconfigure provider/modelsTelegram setup
After installation, if you chose to configure Telegram:
- Open Telegram and message your bot
- List pairing requests:
openclaw pairing list telegram - Approve:
openclaw pairing approve telegram <CODE>
Pairing codes expire after 1 hour.
Config location
| OS | Path |
|---|---|
| macOS / Linux | ~/.openclaw/openclaw.json |
| Windows | %USERPROFILE%\.openclaw\openclaw.json |
Requirements
- Node.js >= 18 (to run this installer; OpenClaw itself needs >= 22)
- bash (macOS/Linux) or PowerShell 5.1+ (Windows)
- Internet connection
License
MIT
