📖 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
💡 Check Node Version

Run node --version to check your Node.js version.

🖥️ Choose Your Platform

Quick Install

Terminal
# One-line install script curl -fsSL https://openclaw.ai/install.sh | bash

Run Onboarding

Terminal
# Run onboarding and install daemon openclaw onboard --install-daemon

Verify Installation

Terminal
# Check Gateway status openclaw gateway status # Open dashboard openclaw dashboard
💡 Quick Start

The onboarding process will help you select a model provider, set up API keys, and configure Gateway. The entire process takes about 2 minutes.

💡 Windows Support

OpenClaw supports both native Windows and WSL2. WSL2 is more stable and recommended for the full experience.

Native Windows Installation

PowerShell
# Use PowerShell install script iwr -useb https://openclaw.ai/install.ps1 | iex

WSL2 Installation (Recommended)

PowerShell (Administrator)
# Install WSL wsl --install # After restart, open WSL terminal
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-daemon

Verify Installation

Terminal
openclaw gateway status openclaw dashboard

Quick Install

Terminal
# One-line install script curl -fsSL https://openclaw.ai/install.sh | bash

Install via Docker

Terminal
# Run with Docker docker run -d --name openclaw \ -p 18789:18789 \ -v openclaw_data:/root/.openclaw \ openclaw/openclaw:latest

Install via npm

Terminal
# Install globally npm install -g openclaw # Run onboarding openclaw onboard --install-daemon

Verify Installation

Terminal
openclaw gateway status openclaw dashboard

🔧 Configure BeeHears API

During onboarding, you can choose a custom API endpoint to use BeeHears service:

Configuration Example
{ "providers": { "openai": { "apiKey": "your-beehears-api-key", "baseUrl": "https://api.beehears.com/v1" } } }
💡 Supported Channels

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 wizard
  • openclaw gateway status - Check Gateway status
  • openclaw gateway start - Start Gateway
  • openclaw gateway stop - Stop Gateway
  • openclaw dashboard - Open control panel
  • openclaw --help - View help

First-time Usage Flow

  1. Run openclaw onboard --install-daemon
  2. Select a model provider (Anthropic/OpenAI/Google, etc.)
  3. Enter your API key
  4. Verify Gateway is running
  5. Open Dashboard and send your first message