OpenClaw Installation Guide: Deploy Your Personal AI Assistant in 5 Minutes (WeChat/QQ Support)
OpenClaw is a 370K+ star open-source personal AI assistant that connects Claude-class models to WeChat, QQ, Telegram and 20+ chat platforms. Chinese guides are rare. This tutorial walks you through install, config, connecting WeChat/QQ, and troubleshooting.
💡 What You Will Learn
OpenClaw is a 370K+ star open-source personal AI assistant that connects Claude-class models to WeChat, QQ, Telegram and 20+ chat platforms. Chinese guides are rare. This tutorial walks you through in
📜 Table of Contents
OpenClaw Chinese Installation Guide: Deploy Your Personal AI Assistant in 5 Minutes (WeChat/QQ)
OpenClaw is an open-source AI assistant that runs on your own device, connecting powerful LLMs to the chat apps you already use. It has 370K+ GitHub stars (check the official repo). For Chinese users, the pain point is the lack of guides. This tutorial covers install, configuration, connecting WeChat/QQ, and troubleshooting on Windows.
1. Prerequisites
| Item | Requirement | Note |
|---|---|---|
| Node.js | 18.0+ | Download the LTS build |
| Git | any | Optional, only for source install |
| LLM API key | any provider | Anthropic, OpenAI-compatible, or local Ollama |
2. Install: Two Options
Option A: npm one-liner (recommended)
npm install -g openclaw
Check with openclaw --version.
Option B: from source
git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build
3. First Configuration
Run openclaw, pick a model provider, paste your API key, then test with a simple chat message in the terminal. If it replies, the model channel works.
4. Connecting WeChat / QQ
OpenClaw connects platforms via bridges. WeChat/QQ use QR-code login; keep your phone online.
- Run
openclaw bridge add wechat, scan the QR with a secondary WeChat account (avoid risk-control on your main account). - Run
openclaw bridge add qq, scan with a secondary QQ account. - Telegram/Discord/Slack use Bot Tokens and are more stable than WeChat.
โ ๏ธ Automating personal WeChat/QQ accounts carries account-risk-control risks. Use secondary accounts and follow platform ToS.
5. Quick Config Reference
| Setting | Purpose | Suggestion |
|---|---|---|
| Default model | daily chat model | start cheap, upgrade later |
| Temperature | randomness | 0.7 chat / 0.2 coding |
| System prompt | persona & rules | add "always reply in Chinese" |
| Auto-reply | answer all messages | disable if noisy |
| Scheduled tasks | daily automation | digests, reminders, scraping |
6. FAQ
Q: npm permission error (EACCES)? A: Run PowerShell as admin; on Linux/macOS use nvm.
Q: Can't reach the model? A: 90% is a wrong key or model ID. Verify the key in the provider console and the model ID in their docs.
Q: WeChat QR scan does nothing? A: Check phone network and the bridge log; some networks need a proxy (see official docs).
Q: Replies are in English? A: Put "always reply in Simplified Chinese" in the system prompt.
Q: Is it expensive? A: Light personal use with a cheap model costs little; heavy use can run on local Ollama.
Q: Does the terminal need to stay open? A: Yes for local mode. For 24/7, deploy on a VPS or use PM2.
Commands and settings follow the official OpenClaw docs; they may change between versions.
Written by our editorial team; tools listed here are tested or verified against public sources. Links point to official sites or GitHub repos for reference only โ no paid placements.
