OpenClaw + Feishu

Overview

Deploy an AI-powered Feishu (Lark) bot using OpenClaw and AihubMax. This integration allows your team to interact with AI models directly within Feishu conversations.

This guide assumes you have already completed the basic OpenClaw Manual Installation. If not, please set up OpenClaw first.

Prerequisites

AihubMax API Key

An active AihubMax API key.

OpenClaw Instance

A running OpenClaw instance (see Manual Installation).

Feishu Developer Account

Access to the Feishu Open Platform (or Lark Open Platform for international).

Configuration

Create a Feishu App

Log in to the Feishu Open Platform (or Lark Open Platform for international).
Click Create App > Enterprise Self-Built Application.
Fill in the app name and description.
Note down the App ID (format: cli_xxx) and App Secret.

Configure Permissions

In the Feishu Open Platform, navigate to Permissions & Scopes and add the following permissions:

Permission	Description
`im:message`	Read and write messages
`im:message:send_as_bot`	Send messages as the bot
`im:chat`	Access chat information
`im:chat:readonly`	Read chat information

You can batch import permissions via JSON in the Feishu Open Platform to save time.

Enable Bot Capability

In the app settings, go to App Capabilities > Bot.
Enable the bot capability.

Configure Event Subscriptions

Go to Event Subscriptions.
Select “Use Long Connection” (WebSocket) as the connection method.
Add the event: im.message.receive_v1 (Receive messages).

Using WebSocket long connection means you don’t need a public URL or SSL certificate — the connection is initiated from your server.

Install the Feishu Plugin

Install the OpenClaw Feishu plugin:

openclaw plugins install @openclaw/feishu

Configure OpenClaw

Add the Feishu configuration to ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
    }
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "your-app-secret",
          "botName": "My AI Assistant"
        }
      }
    }
  }
}

Feishu credentials go under channels.feishu.accounts, NOT under plugins.entries.feishu.

Alternatively, you can set environment variables:

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="your-app-secret"

For Lark international users, add "domain": "lark" to the account configuration.

Publish and Test

In the Feishu Open Platform, click Publish to make your bot available.
Add the bot to a Feishu group chat or start a direct conversation.
Send a test message like “Hello!”
The bot should respond using the configured AI model through AihubMax.

Verify the Connection

Send a message to your Feishu bot:

Who are you? What model are you using?

The bot should reply with a response generated by the AI model configured through AihubMax.

Troubleshooting

Bot does not respond in Feishu

Verify appId and appSecret are correct in the config.
Check that the bot has been published and approved.
Ensure the im.message.receive_v1 event is subscribed.
Check OpenClaw logs for errors.

Permission denied errors

Ensure all required permissions are granted in the Feishu Open Platform.
Some permissions require admin approval — check the approval status.
After adding permissions, you may need to re-publish the bot.

Plugin not loading

Verify the Feishu plugin is installed: check the plugins section in openclaw.json.
Ensure "enabled": true is set for both the plugin entry and the channel.
Restart the OpenClaw daemon after configuration changes.

AI model errors

Verify your AihubMax API key is valid and has sufficient balance.

Test the API key directly:

curl https://api.aihubmax.com/v1/models \
  -H "Authorization: Bearer sk-your-foxapi-api-key"

MCP Servers

AI Coding Toolbox

Agents

OpenClaw + Feishu

Overview

Prerequisites

AihubMax API Key

OpenClaw Instance

Feishu Developer Account

Configuration

Verify the Connection

Troubleshooting

​Overview

​Prerequisites

AihubMax API Key

OpenClaw Instance

Feishu Developer Account

​Configuration

​Verify the Connection

​Troubleshooting

Overview

Prerequisites

Configuration

Verify the Connection

Troubleshooting