What you need
- Node.js 22.22.3+, 24.15+, or 25.9+ (Node 26 is the recommended runtime)
- An API key from a model provider (Anthropic, OpenAI, Google, etc.) — onboarding will prompt you
Quick setup
1
Install OpenClaw
- macOS / Linux
- Windows (PowerShell)
Other install methods (Docker, Nix, npm): Install.
2
Complete onboarding
The installer starts the onboarding wizard automatically. Follow it to choose
a model provider, set an API key, and configure the Gateway. QuickStart is
usually only a few minutes, but provider sign-in, channel pairing, daemon
install, network downloads, skills, or optional plugins can make full
onboarding take longer. Skip optional steps and return later with
openclaw configure.See Onboarding (CLI) for the full reference.3
Verify the Gateway is running
4
Open the dashboard
Advanced: mount a custom Control UI build
Advanced: mount a custom Control UI build
If you maintain a localized or customized dashboard build, point
Then set:Restart the gateway and reopen the dashboard:
gateway.controlUi.root to a directory that contains your built static
assets and index.html.What to do next
Connect a channel
Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, and more.
Pairing and safety
Control who can message your agent.
Configure the Gateway
Models, tools, sandbox, and advanced settings.
Browse tools
Browser, exec, web search, skills, and plugins.
Advanced: environment variables
Advanced: environment variables
If you run OpenClaw as a service account or want custom paths:
OPENCLAW_HOME— home directory for internal path resolutionOPENCLAW_STATE_DIR— override the state directoryOPENCLAW_CONFIG_PATH— override the config file path