📖 Introduction
OpenClaw is a powerful AI automation agent platform. It supports multi-channel message integration (such as Discord, Telegram, WhatsApp, etc.) and provides rich tool extension capabilities.
With OpenClaw, you can quickly build AI-powered chatbots, automated workflows, and intelligent assistants.
⚙️ System Requirements
| Component | Requirement | Notes |
|---|---|---|
| Node.js | Node 24 recommended (Node 22.14+ supported) | Required |
| API Key | Anthropic / OpenAI / Google, etc. | At least one model provider |
| Windows | Native Windows or WSL2 | WSL2 is more stable, recommended |
Run node --version to check your Node.js version.
🖥️ Choose Your Platform
Quick Install
# One-line install script
curl -fsSL https://openclaw.ai/install.sh | bashRun Onboarding
# Run onboarding and install daemon
openclaw onboard --install-daemonVerify Installation
# Check Gateway status
openclaw gateway status
# Open dashboard
openclaw dashboardThe onboarding process will help you select a model provider, set up API keys, and configure Gateway. The entire process takes about 2 minutes.
OpenClaw supports both native Windows and WSL2. WSL2 is more stable and recommended for the full experience.
Native Windows Installation
# Use PowerShell install script
iwr -useb https://openclaw.ai/install.ps1 | iexWSL2 Installation (Recommended)
# Install WSL
wsl --install
# After restart, open WSL terminal# Install Node.js
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# Install OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
# Run onboarding
openclaw onboard --install-daemonVerify Installation
openclaw gateway status
openclaw dashboardQuick Install
# One-line install script
curl -fsSL https://openclaw.ai/install.sh | bashInstall via Docker
# Run with Docker
docker run -d --name openclaw \
-p 18789:18789 \
-v openclaw_data:/root/.openclaw \
openclaw/openclaw:latestInstall via npm
# Install globally
npm install -g openclaw
# Run onboarding
openclaw onboard --install-daemonVerify Installation
openclaw gateway status
openclaw dashboard🔧 Configure BeeHears API
During onboarding, you can choose a custom API endpoint to use BeeHears service:
{
"providers": {
"openai": {
"apiKey": "your-beehears-api-key",
"baseUrl": "https://api.beehears.com/v1"
}
}
}OpenClaw supports multiple messaging channels including Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, and more.
🚀 Basic Usage
Common Commands
openclaw onboard- Run configuration wizardopenclaw gateway status- Check Gateway statusopenclaw gateway start- Start Gatewayopenclaw gateway stop- Stop Gatewayopenclaw dashboard- Open control panelopenclaw --help- View help
First-time Usage Flow
- Run
openclaw onboard --install-daemon - Select a model provider (Anthropic/OpenAI/Google, etc.)
- Enter your API key
- Verify Gateway is running
- Open Dashboard and send your first message