How to Connect OpenClaw to Feishu: A Step‑by‑Step Integration Guide

Integration Overview

OpenClaw can connect to Feishu via three mechanisms defined by its architecture: Webhook (Feishu robot receives events and OpenClaw processes them), API (OpenClaw actively calls Feishu APIs), and OAuth2 (user‑level authorization). This guide follows the Webhook approach.

Prerequisites in Feishu

Create a Feishu application at https://open.feishu.cn/app?lang=zh-CN. Set the name, description, and icon as desired.

Enable the Robot ability on the application management page.

Navigate to Credentials & Basic Info and record the App ID and App Secret. These values are required for OpenClaw configuration.

OpenClaw Installation

Install the Feishu plugin: openclaw plugins install @m1heng-clawd/feishu Add a Feishu channel. The command launches an interactive wizard that asks for the previously saved App ID and App Secret. Accept the default values unless custom settings are needed: openclaw channels add Restart the OpenClaw gateway so the new channel takes effect:

openclaw gateway restart

Robot Permission Configuration

In the Feishu robot settings, add the following scopes (JSON format) to grant the bot required access:

{
  "scopes": {
    "tenant": [
      "contact:user.base:readonly",
      "im:chat",
      "im:chat:read",
      "im:chat:update",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "contact:contact.base:readonly"
    ],
    "user": []
  }
}

Publish the Feishu Application

Open the Feishu console, go to Version Management & Release (or Create Version ), fill in a version number and description, then save and publish.

Verification

Send any message to the newly created robot in the Feishu app. The bot replies with a pairing code, e.g., Pairing code:XXXXX. Approve the pairing from the OpenClaw terminal: openclaw pairing approve feishuXXXXX After approval, the robot can receive and respond to messages, completing the OpenClaw‑Feishu integration.