Feishu (Lark)

Integrate CowAgent into Feishu via a custom enterprise app. Supports p2p chat and group chat (@bot), uses WebSocket long connection (no public IP needed), supports streaming typewriter replies and voice messages.

1. Setup

Option 1: One-click Scan to Create (Recommended)

No need to manually create an app on the Feishu Developer Platform. Start the Cow project, open the web console (default http://127.0.0.1:9899/), go to Channels, click Add Channel, choose Feishu, then under the Scan QR tab click One-click Create Feishu App and scan with the Feishu App to complete app creation and connection automatically.

When starting from CLI without feishu_app_id configured, the QR code is also printed to the terminal.

Option 2: Manual Setup

Manually create a custom app on the Feishu Developer Platform, then connect via Web Console or config file.

Step 1: Create the App

1. Go to Feishu Developer Platform, click Create Enterprise Custom App:

2. In Add App Capabilities, add the Bot capability:

3. In Permission Management, paste the following permissions and Batch Enable all:

im:message,im:message.group_at_msg,im:message.group_at_msg:readonly,im:message.p2p_msg,im:message.p2p_msg:readonly,im:message:send_as_bot,im:resource,cardkit:card:write

4. Get App ID and App Secret from Credentials & Basic Info:

Step 2: Connect to CowAgent

```json
{
  "channel_type": "feishu",
  "feishu_app_id": "YOUR_APP_ID",
  "feishu_app_secret": "YOUR_APP_SECRET",
  "feishu_stream_reply": true
}
```

| Parameter | Description | Default |
| --- | --- | --- |
| `feishu_app_id` | Feishu app App ID | - |
| `feishu_app_secret` | Feishu app App Secret | - |
| `feishu_stream_reply` | Enable streaming typewriter reply | `true` |
| `feishu_detailed_card` | Use a detailed card (tool calls, thinking process, elapsed time) for streaming replies; off keeps the plain typewriter card | `true` |

Step 3: Publish the App

1. After Cow is running, go to Events & Callbacks in the Feishu Developer Platform, choose Long Connection mode and save:

2. Click Add Event, search for "Receive Message" and choose Receive Message v2.0.

3. (Optional) Under Callbacks, add Card Action Trigger (card.action.trigger) to enable /tasks scheduler commands; add the Message Recalled (im.message.recalled_v1) event to cancel a task by recalling its message.

4. Click Version Management & Release, create a version and apply for Production Release. Approve the request in the Feishu client:

2. Features

3. Usage

After connection, search for the bot name in Feishu to start a chat.

To use in groups, add the bot to a group and @-mention it.

Send /tasks in a private chat, or @-mention the bot with /tasks in a group, to manage tasks belonging to that chat.