Connect Feishu连接飞书

With the Feishu messaging channel, you can talk to StoreClaw directly inside Feishu and also send scheduled task results to a designated group chat or conversation. This guide explains how to create an internal app in the Feishu Open Platform, enable the bot capability, and complete the StoreClaw connection.

Prerequisites

Before you begin, make sure the following three requirements are met:

1. Feishu account: You already have a Feishu account and can sign in normally.
2. Organization membership (Org): Your account has joined a Feishu organization or team. A Feishu internal app (Custom App) must belong to an organization. A personal account cannot create one independently.
3. Developer permissions: Your account has Developer or Organization Admin access in that organization. Regular members cannot create apps in the Open Platform. If you do not have permission, contact your organization admin.

Step 1: Sign in to the Feishu Open Platform

Visit Feishu Open Platform, sign in with your Feishu account, and click Developer Console in the upper-right corner to enter the console.

Step 2: Create an Internal App (Custom App)

1. Click Create Custom App.
2. Enter the app name and description, then confirm to finish creation.

Step 3: Enable the Bot Capability

1. Open the app details page.
2. Click Add Features in the left-side menu.
3. Find the Bot card and click Add.

Step 4: Configure Permissions & Scopes

1. Open Permissions & Scopes in the left-side menu.
2. Click Add Permission Scopes to app, search for the required scopes, and add them.
3. Click Add Scopes to save the permission configuration.

Required Permissions

The following permissions are required for basic bot messaging capability:

• im:message: Basic message permission
• im:message:send_as_bot: Send messages as the bot
• im:message.group_msg: Send group messages
• im:chat: Access conversations
• im:resource: Send rich media such as images and files
• contact:user.base:readonly: Read basic user information for @mentions

Optional Permissions

If you want the bot to receive user messages, it is recommended to add these as well:

• im:message:readonly: Read message content
• im:message.p2p_msg:readonly: Read direct messages
• im:message.group_at_msg:readonly: Read group messages that mention the bot
• im:chat.access_event.bot_p2p_chat:read: Receive bot private chat event pushes

Step 5: Configure Events and Callbacks

1. Open the Events & Callbacks page from the left-side menu.
2. Click the pencil icon next to the subscription method.
3. Select Receive events through persistent connection.

1. Add the following events:

   • reaction.created
   • reaction.deleted
   • Message received

Step 6: Publish for Approval, If Required

If your organization has app approval enabled, you must create a version and complete the approval flow first:

1. Open Version Management & Release in the left-side menu.
2. Click Create Version.

1. Fill in the version notes and submit them.

1. Wait for approval from the organization administrator.

After approval succeeds, you can usually find the app in the Feishu assistant and start a conversation with it.

Step 7: Get the Credentials

1. Open Credentials & Basic Info from the left-side menu.

2. In the Credentials section, copy the following two values:

   • App ID
   • App Secret

These two values need to be entered in the Feishu configuration page in StoreClaw.

Complete the Configuration in StoreClaw

1. Return to StoreClaw and open the Messaging Channels page.
2. Find the Feishu Bot card and click Configure.
3. Paste the App ID and App Secret you copied earlier.
4. Save the configuration. If the card shows a connected status, the setup is complete.

After that, you can start talking to StoreClaw AI through Feishu.

What You Can Do After Connecting

After the connection is complete, you can:

• Talk to StoreClaw Bot in Feishu direct chats or group chats
• Mention the bot in a channel to send tasks or questions
• Send scheduled task results to Feishu groups or designated conversations

FAQ