All Posts

QClaw Setup Guide: Install and Configure in 5 Minutes

Guides 2026-04-05
Complete step-by-step guide to installing and setting up QClaw. Zero technical skills required. Get your AI assistant running in under 5 minutes on Mac or Windows.
In this article
IntroductionPrerequisitesStep 1: Download QClawStep 2: Install QClawStep 3: Create Your AccountStep 4: Connect Your First ChannelStep 5: Initial ConfigurationStep 6: Test Your SetupTroubleshootingYou've Got QClaw!Next StepsGetting Help

Introduction

Getting started with QClaw is designed to be effortless. This guide walks you through installation and setup in just 5 minutes—no technical knowledge required.

Get started in 5 minutes: https://qclawsg.qq.com

Prerequisites

System Requirements

Requirement Minimum Recommended
Operating System macOS 12 / Windows 10 macOS 13+ / Windows 11
Processor Intel or Apple Silicon M1/M2/M3/M4 or i5/i7+
RAM 4 GB 8 GB
Storage 500 MB free 1 GB free
Internet Required for setup Stable connection

Supported Platforms

Step 1: Download QClaw

Download from Official Website


1. Visit: https://qclawsg.qq.com
2. Click "Download QClaw" button
3. Select your platform (Mac or Windows)
4. Save the installer file

Direct Download Links:

Step 2: Install QClaw

macOS Installation


1. Open the downloaded .dmg file
2. Drag QClaw to Applications folder
3. Open Applications → QClaw
4. If prompted, click "Open" in security dialog

First Launch Setup:


┌─────────────────────────────────────────────────────────────┐
│                    Welcome to QClaw!                         │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Your personal AI assistant is ready.                       │
│                                                             │
│  Click "Get Started" to begin setup.                        │
│                                                             │
│                                        [Get Started]        │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Windows Installation


1. Run the downloaded .exe installer
2. Click "Next" through the wizard
3. Choose installation location (default is fine)
4. Click "Install"
5. Click "Finish" to launch QClaw

Step 3: Create Your Account

Sign Up (New Users)


┌─────────────────────────────────────────────────────────────┐
│                    Create Your QClaw Account                 
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Email:     [you@example.com         ]                      │
│                                                             │
│  Password:  [•••••••••••            ]                       │
│                                                             │
│  Name:      [Your Name               ]                      │
│                                                             │
│  □ I agree to Terms of Service and Privacy Policy           │
│                                                             │
│                                        [Create Account]     │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Sign In (Existing Users)


1. Enter your email
2. Enter your password
3. Click "Sign In"

Step 4: Connect Your First Channel

Choose Your Messenger

QClaw works through messaging apps you already use:

Channel Setup Time Best For
Telegram 2 minutes Developers, power users
WeChat 30 seconds Chinese users
QQ 30 seconds Chinese users

Telegram Setup


STEP 1: Create a Bot
        • Open Telegram
        • Search @BotFather
        • Send /newbot
        • Follow prompts (name your bot)
        • Copy the token

STEP 2: Connect to QClaw
        • QClaw → Settings → Channels → Telegram
        • Paste your bot token
        • Click "Connect"

STEP 3: Start Chatting
        • Open your bot in Telegram
        • Send "Hello"
        • QClaw responds!

Step 5: Initial Configuration

Basic Settings


Recommended First-Time Settings:

🔐 SECURITY
□ Risk threshold: Medium
□ Require approval for high-risk actions: ✓

📱 NOTIFICATIONS
□ Desktop notifications: ✓
□ Sound alerts: Optional
□ Mobile notifications: ✓

📁 PERMISSIONS
□ Documents folder: ✓ (read/write)
□ Downloads folder: ✓ (read/write)
□ Desktop: ✓ (read only)

[Save Settings]

Permissions Setup


QClaw needs permission to help you:

✓ File Access (recommended)
  Allows QClaw to read and organize your files

✓ Application Control (recommended)
  Allows QClaw to open apps when needed

✓ Network Access (required)
  Allows QClaw to search the web

✓ Email (optional)
  Allows QClaw to help with email management

Step 6: Test Your Setup

First Conversation


Try these commands:

"Hello, what can you do?"

"Show me the dashboard"

"What's the weather today?"

"Organize my downloads folder"

Verify Everything Works


CHECKLIST:
□ QClaw installed successfully
□ Account created/logged in
□ Telegram connected
□ Notifications enabled
□ Test message received response

Troubleshooting

Common Issues

Issue Solution
Installation fails Restart computer, try again
QR code won't scan Clean camera, good lighting
Connection drops Re-scan QR code
QClaw not responding Check if app is running, restart

Need Help?

You've Got QClaw!

Congratulations! Your AI assistant is ready.

Quick Tips:

Next Steps

  1. Connect more channels for flexibility
  2. Set up daily briefings for productivity
  3. Explore Playground for expert agents
  4. Configure security for your needs

Getting Help

Resources:

Start using QClaw now: https://qclawsg.qq.com

Questions? We're here to help: hi@sg.qclaw.qq.com