This guide will help you connect QClaw to Feishu, so you can control QClaw and receive responses directly through Feishu messages.
Prerequisites
Before getting started, make sure you have:
QClaw installed on your computer
A Feishu account
Feishu Admin Console access — required to create and publish custom apps in your workspace
If you are not a Feishu administrator, ask your workspace admin to complete Steps 1–2 and share the App ID and App Secret with you.
-----------------------------------------
Setup Flow
Overall Process
Create a Custom App -> Add Bot Feature -> Configure QClaw with App Credentials -> Set Up Permission & Events and Callbacks -> Publish the App -> Start Talking
-----------------------------------------
Detailed Steps:
Step 1: Create a Custom App
1. Log in to Feishu and open the Admin Console.
2. In the left sidebar, go to Workplace → App Management. Click "Create App" in the top-right corner.
3. In the Feishu Open Platform that opens, click the "Custom Apps" tab, then click "Create Custom App".
4. Fill in the app details: Name (e.g., QClaw), Description, Click "Create" to finish.
-----------------------------------------
Step 2: Add Bot Feature
1. After creating the app, you will be taken to the app configuration page.
2. In the left sidebar, click "Add Features".
3. Find the "Bot" feature card and click "+ Add".
The bot feature allows the app to interact with users in Feishu chats. Once added, your app can send and receive messages.
-----------------------------------------
Step 3: Get App Credentials & Configure QClaw
1. In the left sidebar, click "Credentials & Basic Info".
2. You will see your App ID and App Secret on this page.
Security Notice: Keep your App Secret private. Do not share it or commit it to public repositories.
3. Open QClaw on your computer. Enter the App ID and App Secret you copied into the corresponding fields.
4. Click "Connect" to save the configuration.
-----------------------------------------
Step 5: Set Up Permissions and Events & Callbacks
1. In the left sidebar, click "Events & Callbacks".
2. Under the "Callback Configuration" tab, find the Subscription Mode setting and switch it to "Persistent Connection".
3. Click "Verify & Save" to confirm.
4. Next, click "Add Events" and add the events your use case requires. Common events include:
message.read — triggers when a message is read
Message received (im.message.receive_v1) — triggers when a user sends a message to the bot
and other events you may need.
5. Click "Confirm" after adding your events.
6. In the left sidebar, click "Permissions & Scope".
7. Click "Add permissions and scope to app" and select permissions you may need:
8. Click "Add to Scope" and save
-----------------------------------------
Step 6: Publish the App
1. In the left sidebar, click "Version Management & Release".
2. Click "Create Version" and fill in the version details.
3. Click "Save" and then "Publish" to publish the app to your Feishu workspace.
The app must be published before users in your workspace can interact with the bot. Your Feishu admin may need to approve the release.
-----------------------------------------
Start Using
Once the app is published, find the bot in your Feishu workspace and start chatting.
Direct Message (DM): Open Feishu and search for your app by name (e.g., QClaw) in the search bar, or find it under "Workplace". Open a chat with the bot and send a message — for example, "Hello" — to test the connection. If configured correctly, QClaw will receive the message and reply in Feishu.
If the bot replies successfully, you have completed the QClaw–Feishu integration! 🎉
-----------------------------------------
Frequently Asked Questions
1. The bot doesn't respond — what should I check?
Check your App ID and App Secret: Make sure the credentials entered in QClaw match those shown in Credentials & Basic Info in the Feishu Open Platform.
Check QClaw is running: The bot only works when QClaw is actively running on your computer.
Check the subscription mode: Make sure Events & Callbacks is set to "Persistent Connection" and has been saved successfully.
Check the app is published: The bot will not work if the app version has not been released. Go to Version Management & Release and confirm the app status shows as published.
2. I can't find the bot in Feishu — what should I do?
Make sure the app has been published in Version Management & Release. After publishing, search for the app name in the Feishu search bar or look for it under Workplace. It may take a few minutes to appear after release.