QClaw Setup Guide: Install and Configure in 5 Minutes
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 HelpIntroduction
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
- ✅ macOS: Apple Silicon (M1, M2, M3, M4)
- ✅ macOS: Intel processors
- ✅ Windows: Windows 10 (64-bit)
- ✅ Windows: Windows 11
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 |
| 30 seconds | Chinese users | |
| 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?
- In-app Help: Settings → Help
- Email: hi@sg.qclaw.qq.com
- Discord: #support channel
You've Got QClaw!
Congratulations! Your AI assistant is ready.
Quick Tips:
- Start with simple commands
- Set up daily briefings
- Explore the Playground
- Customize your settings
Next Steps
Recommended Actions
- Connect more channels for flexibility
- Set up daily briefings for productivity
- Explore Playground for expert agents
- Configure security for your needs
Getting Help
Resources:
- QClaw FAQ
- User Manual
- Safety Guide
- Video Tutorials (Coming soon)
Start using QClaw now: https://qclawsg.qq.com
Questions? We're here to help: hi@sg.qclaw.qq.com