Getting Started

This page walks you from zero install to sending your first message. Based on official Getting Started.

Requirements

• Node.js ≥ 22

1. Install CLI

Recommended: global install (npm or pnpm)

npm install -g openclaw@latest
# or
pnpm add -g openclaw@latest

2. Run wizard and install service

The wizard configures gateway, workspace, channels, and skills, and can install a user-level system service (launchd/systemd) so the Gateway runs in the background:

openclaw onboard --install-daemon

3. Log in to a channel (e.g. WhatsApp)

openclaw channels login

Follow the prompts to scan QR or log in. Credentials are stored in ~/.openclaw/credentials.

4. Start the Gateway

After onboarding, the service usually runs the Gateway. To start manually:

openclaw gateway --port 18789

5. Open the dashboard

In your browser:

• http://127.0.0.1:18789/ or http://localhost:18789/

Use the Control UI for chat, sessions, and config.

6. Send a test message (optional)

With the Gateway running:

openclaw message send --target +15555550123 --message "Hello from OpenClaw"

Replace +15555550123 with your target number.

From source (development)

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
openclaw onboard --install-daemon

Without a global install, run commands via pnpm openclaw ... from the repo.

Next

• Wizard
• Pairing
• Configuration
• Official docs