NEWStoreClaw Ranks #1 Product of the Week on Product Hunt
StoreClaw

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.

Feishu Developer Console

Step 2: Create an Internal App (Custom App)

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

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.

Feishu Enable Bot

Note: The app can receive and send messages as a bot only after the bot capability is enabled.

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.

Feishu Permission Scope

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

Tip: If you only need StoreClaw to send messages to a group for now, the base messaging permissions are enough to start. If you want full two-way conversations, also add the message-reading and event-related permissions.

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 mode.
  3. Select Receive events through persistent connection.

Feishu Event Configuration

  1. Add the following events:
    • im.message.reaction.created_v1
    • im.message.reaction.deleted_v1
    • im.message.receive_v1

Feishu Event Added

Note: Persistent connection is usually the better fit for this bot scenario because it is easier to configure and does not require a public callback URL. If you modify the event callback scope in the Feishu Developer Console, you need to return to StoreClaw and manually reconnect Feishu to register the new events.

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 a version. Feishu Create Version
  3. Fill in the version notes and submit them. Feishu Version Confirm
  4. Wait for approval from the organization administrator.

Note: If your organization does not require approval, you can skip this step.

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

Feishu Open App

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.

Feishu Credentials

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

Q: I signed in to the Open Platform, but I cannot see Developer Console. Why?

A: Make sure your account has joined a Feishu organization and that the organization administrator has granted you developer permissions.

Q: I created the app, but the bot cannot send messages. What should I check?

A: Check the following first:

  • Whether the bot capability in Step 3 has been enabled
  • Whether the permissions in Step 4 were saved successfully
  • If your organization uses app approval, whether the approval in Step 6 has already passed

Q: What should I do if the App Secret is leaked?

A: Go to the Credentials page and click Reset to rotate the secret. The old secret becomes invalid immediately, and you must update the value in StoreClaw as well.