Skip to content

5-Minute Quick Start

Prerequisites

Before you begin:

  • Completed GetClaw installation
  • At least one AI provider API key ready (e.g., OpenAI, DeepSeek, etc.)

No need to install Node.js or anything else — it’s all bundled.

Step 1: Launch GetClaw

  • Windows: Find GetClaw on your desktop or Start menu, double-click to launch
  • macOS: Find GetClaw in Applications or Launchpad, click to launch

On first launch, you’ll see the setup wizard (if you completed it during installation, you’ll go directly to the dashboard).

Step 2: Configure Your AI Provider

  1. Go to “Config Center” → “AI Providers”
  2. Select your provider (recommended: OpenAI, DeepSeek, or a provider of your choice)
  3. Enter your API key (displayed as masked — stored securely)
  4. Click “Test Connection” — green means it’s working

For detailed provider options, see AI Provider Configuration.

Step 3: Launch OpenClaw

  1. Return to the “Dashboard”
  2. Click “Launch OpenClaw”
  3. Wait for the status light to turn green (usually 3–10 seconds)
  4. Green light = OpenClaw is running

Your AI assistant is now live and ready to respond.

Step 4 (Optional): Connect a Messaging Platform

To let the AI assistant handle messages from Telegram, Discord, etc.:

  1. Go to “Config Center” → “Messaging Channels”
  2. Select a platform (e.g., Telegram)
  3. Follow the guided setup to enter your Bot Token or credentials
  4. Click “Start”

For detailed setup steps, see Channel Configuration.

Dashboard Overview

Once running, the dashboard shows:

IndicatorDescription
Status lightGreen = Running, Red = Stopped
UptimeTime since last launch
Active channelsNumber of connected messaging platforms
Live logsOpenClaw runtime logs (filter by Info / Warn / Error)

Troubleshooting

Status light stays red

  • Check that your API key is correctly configured
  • Click “AI Diagnostics” to see an automatic analysis
  • Check the logs for specific error messages

API key test fails

  • Make sure the key was copied correctly (no extra spaces)
  • Check your internet connection to the provider’s API
  • Try a different provider if connection issues persist

Next Steps