Integrate OpenClaw (formerly Moltbot and Clawdbot) with Feishu

Updated at:

This guide shows you how to integrate OpenClaw with Feishu. Once integrated, you can use natural language to interact with OpenClaw in Feishu group chats and one-on-one conversations.

Before you begin

To configure a message channel, you must first purchase and configure a Simple Application Server with the OpenClaw application image. Follow the steps below or refer to the Deploy the OpenClaw image topic. You can skip this section if you have already done so.

Purchase and configure a Simple Application Server with the OpenClaw application image

Step 1. Purchase an OpenClaw package

Important

If you have already purchased a Simple Application Server, you can deploy OpenClaw by resetting the system. To do this, select the OpenClaw image under application images when resetting. However, resetting the system erases all data on the server's system disk. Back up your data as needed. For more information, see Reset system.

  1. Purchase a Simple Application Server with the OpenClaw application pre-installed.

  2. On the Simple Application Server page, resource configurations are preset. You can change the settings as follows:

    • Servers: The memory must be at least 2 GiB. You can switch packages based on your needs.

    • Region: The default is China (Beijing).

    • Purchase Settings: The default is 12 months. You can change the subscription duration based on your needs.

Step 2. Configure OpenClaw

OpenClaw provides two configuration methods. Select the tab for your image version to view the steps.

OpenClaw 2026.5.19 and later (recommended)

  1. Log on to the Simple Application Server console. Click the instance ID on the server card, and on the Server Overview page, click the Application Details tab.

  2. In the lower-left corner of the application details page, click Initialize. In the initialization wizard, complete Step 1: Model Configuration.

    • Large model platform: Select a model provider from the drop-down list. Supported providers include Alibaba Cloud Model Studio Token Plan (Team Edition), Alibaba Cloud Model Studio Coding Plan, Alibaba Cloud Model Studio, deepseek, Kimi, GLM Coding Plan, Zhipu, and more.

    • API Key: Select the region for your API Key and enter the API Key.

    • Model: Select or manually enter a model name.

    After you finish the configuration, click Configure Now to proceed.

  3. In the initialization wizard, in Step 2: Use Web UI, first click Allow in the Allow OpenClaw access port area to open the port. Then, click Login to Web UI to access the OpenClaw WebUI and chat with the OpenClaw agent.

    Important

    Opening the port exposes the service to the public network. After initialization, you can disable public access with a single click by using the Public Access switch in the status bar at the top of the application details page. For more information, see How to enable or disable public access to the OpenClaw WebUI.

  4. (Optional) View the token. After initialization, you can find the Token field in the status bar on the application details page. Click the copy icon to copy the full token.

    Warning

    Do not expose the full URL that contains the token. This link includes authentication credentials. Anyone with this link can bypass login verification and gain administrative access to the OpenClaw console.

OpenClaw versions earlier than 2026.5.19

  1. In the Simple Application Server console, click the instance ID on the server card, and then click the Application Details tab on the Server Overview page.

  2. In the OpenClaw Usage Steps area, under Allow Port Access, click Run Command to open the firewall port for the OpenClaw service.

    Important
  3. Under Configure OpenClaw, click Run Command to configure the Model Studio API Key.

    You can configure two types of Model Studio API Keys:

    • Coding Plan exclusive API Key (Recommended): This plan uses a fixed monthly fee and provides a monthly request quota. Requests that exceed this quota will fail and not be billed, preventing unexpected charges.

      Coding Plan currently supports models such as qwen3.5-plus, kimi-k2.5, MiniMax-M2.5, and glm-5. For a detailed list of models, see Coding Plan overview.
    • Pay-as-you-go Model Studio API Key.

    Configure the API Key. Select the API Key for the Coding Plan from the drop-down list or directly enter the pay-as-you-go API Key. Select a model and then click Next.

    If you manually enter an API Key, ensure the selected region matches the API Key's region. Otherwise, model calls will fail.
    Important

    Configuring a Model Studio Token Plan is not supported during initialization. Forcing an entry will cause an error. If you need to use a Token Plan, complete the initialization first, and then refer to How to connect to the team edition of Model Studio Token Plan in OpenClaw? for configuration instructions.

  4. Under Access Web UI Panel, click Run Command to get the address of the OpenClaw WebUI. You can then interact with the OpenClaw agent on the web page.

    If needed, you can disable public access to the WebUI with a single click. For more information, see Disable public access to the OpenClaw WebUI.
  5. (Optional) View the token.

    In Application Details > Basic Configuration > View token, click View to display and save the token.

    Warning

    Do not expose the full URL that contains the token. This link includes authentication credentials. Anyone with this link can bypass login verification and gain administrative access to the OpenClaw console.

Integrate with Feishu

The OpenClaw plug-in integration method is supported only for instances with image version OpenClaw 2026.2.9 or later. To integrate this message channel on an older version, see Integrate message channels through AppFlow. You can find your instance's image version under Basic Information > Image information on the instance overview page.

OpenClaw offers two Feishu integration methods. Select the tab that matches your image version to view the corresponding steps.

OpenClaw 2026.5.19 and later

Connect via console QR code

  1. Log on to the Simple Application Server console, find your OpenClaw server, and go to the Application Details tab.

  2. On the Channels card, click Add Channel and select Feishu from the drop-down list.

  3. Keep the default IM access by QR code tab selected and click Scan to Configure.

  4. After the command finishes running, a QR code appears. Scan the QR code with Feishu to connect.

    Generating the QR code usually takes 30 seconds to 2 minutes. Please wait.
  5. After scanning the code, click Close.

  6. Verify the connection by talking to the bot.

    The first conversation may take 30 seconds to 2 minutes to initialize. Please wait.

OpenClaw versions earlier than 2026.5.19

Complete the integration in the Channel configuration section of the old console.

Console QR code

This method is supported only for OpenClaw image versions 2026.3.28 and later. For other versions, use the Manual configuration method.
  1. Log on to the Simple Application Server console, find your OpenClaw server, and go to the Application Details tab.

  2. In the Channel configuration section, find the Feishu area and click Scan to Configure.

  3. After the command finishes running, a QR code appears. Scan the QR code with Feishu to connect.

    Generating the QR code usually takes 30 seconds to 2 minutes. Please wait.
  4. After scanning the code, click Close.

  5. Verify the connection by talking to the bot.

    The first conversation may take 30 seconds to 2 minutes to initialize. Please wait.

Manual configuration

1. Create a Feishu application

  1. Go to the Feishu Open Platform and click Create custom app. Enter the application name and description, select an icon, and click Create.

  2. In the left-side navigation pane, click Credentials & Basic Information. Copy the App ID (for example, cli_xxx) and App Secret.

  3. In the left-side navigation pane, click Permission Management. Click the Batch import/export permissions button, paste the following JSON configuration, click Next, confirm to add permissions, and then click Request to enable.

    JSON configuration content

    {
      "scopes": {
        "tenant": [
          "aily:file:read",
          "aily:file:write",
          "application:application.app_message_stats.overview:readonly",
          "application:application:self_manage",
          "application:bot.menu:write",
          "cardkit:card:write",
          "contact:user.employee_id:readonly",
          "corehr:file:download",
          "docs:document.content:read",
          "event:ip_list",
          "im:chat",
          "im:chat.access_event.bot_p2p_chat:read",
          "im:chat.members:bot_access",
          "im:message",
          "im:message.group_at_msg:readonly",
          "im:message.group_msg",
          "im:message.p2p_msg:readonly",
          "im:message:readonly",
          "im:message:send_as_bot",
          "im:resource",
          "sheets:spreadsheet",
          "wiki:wiki:readonly"
        ],
        "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
      }
    }
  4. In the left-side navigation pane, click Add features. Select the By feature tab, find the Bot card, and click Configuration.

    image

  5. Configure event subscriptions.

    1. In the Simple Application Server console, go to the instance details page. In the Application Details > Channel configuration > Feishu section, enter the App ID and App Secret you obtained earlier and click Application.

    2. On the Feishu Open Platform, click Event subscriptions in the left-side navigation pane. On the Event configuration tab, for Subscription type, select Receive events via long connection, and click Save.

    3. On the Event configuration page, click Add event, search for the event im.message.receive_v1 (Receive message), and click OK.

  6. On the Version Management & Release page, create a version. Enter the App version and Release notes, click Save, and then submit the version for review and publication.

2. Configure the bot

You can create a new group chat or add the bot to an existing one. In the Feishu group, mention the bot by using @bot to start a conversation, or search for the bot to start a private chat for testing.

To use the bot in an external group, see the configuration document Bot supports external groups and one-on-one chats with external users.
  1. Add the bot by following this path: ... > Configure > Group bot > Add bot.

  2. Click the bot's avatar and then click Send Message to send a private message to the bot. You can also mention the bot in a group chat to send it a message.

For OpenClaw versions earlier than 2026.3.13, you need to use a pairing code to connect to the bot. Follow the steps below.

Connect to the bot using a pairing code

  1. Send a private message to the bot. The bot will reply with a pairing code.

    image

  2. In the web UI, enter openclaw pairing approve feishu <pairing_code> to complete the pairing.

    The <pairing_code> is the code the bot sent in the previous step.

    image

    Important

    If you see the error "No pending pairing requests," see How do I pair OpenClaw with Feishu by using terminal commands?.

FAQ

Pair with Feishu via terminal

  1. Log on to the server.

    1. Log on to the Simple Application Server console.

    2. In the server list, find the target server card and click Remote Connection. In the connection window that appears, click Log on Now in the Connect with One-click on Workbench section.

  2. Get the pairing code.

    In the terminal, run the following command to find the pairing code for a Feishu bot with a pending pairing request. Copy the pairing code from the query results.

    openclaw pairing list feishu

    image

  3. Complete the pairing.

    In the terminal, run the following command to approve the pairing request. Replace YXXX with the actual pairing code you obtained in the previous step.

    openclaw pairing approve feishu YXXX 

Configure scheduled tasks for Feishu

You can create a scheduled task by talking to OpenClaw.

  1. Get the webhook URL of the group bot:

    1. In the group chat, click Configure > Group bot.

      image

    2. Click Add bot and select Custom bot. Enter a name and description for the bot, click Add , and copy the webhook URL.

  2. In your conversation with OpenClaw, create the task. The required format is the scheduled task content followed by the group bot's webhook URL. For example, you can create a scheduled task to check the real-time weather.

  3. To verify the scheduled task, ask the agent to send the message immediately for a test. Then, check the group chat where the bot is located to confirm that the task was executed.

If you need to modify or cancel a scheduled task, you can ask the agent to do so directly in the conversation.

To configure scheduled tasks using AppFlow, see How to configure scheduled tasks using AppFlow.