Feishu

Delivery: Official add-on. Use Feishu when your team already works in Feishu or Lark and you want Fased to join those conversations through the platform’s bot APIs. Status: official optional add-on for Feishu and Lark workspaces. Install it from Agent > Channels, onboarding, or the CLI before entering credentials:

fased plugins install @fased/feishu
fased gateway restart

It supports the common bot flow, account-aware config, pairing, and group controls.

Setup from Agent > Channels

Open Agents, select the Agent, then use Agent > Channels > Feishu. You need:

App ID
App Secret
domain: feishu or lark
event subscription enabled in the platform console
bot capability enabled and published/available to the workspace

Restart the gateway if the UI reports that the runtime still needs to load.

Quick setup

Create an enterprise app in Feishu Open Platform or Lark Developer Console.
Copy App ID and App Secret.
Enable bot capability.
Configure event subscription for message events.
Publish or make the app available to the workspace.
Save credentials in Agent > Channels > Feishu.
Start or restart the gateway and send a test message.

Config shape:

{
  channels: {
    feishu: {
      enabled: true,
      appId: "cli_xxx",
      appSecret: "secret",
      domain: "feishu",
      dmPolicy: "pairing",
      groupPolicy: "allowlist",
    },
  },
}

Lark tenants should use domain: "lark".

Permissions

Enable only the permissions your bot flow needs. Typical needs:

receive messages
send messages
bot menu or bot capability where required
user/chat id lookup if you want allowlist resolution

Keep app secrets private and rotate them if exposed.

Access model

Area	Recommended start
DMs	pairing or allowlist
Groups	allowlist plus mention gating
IDs	use stable user/chat ids where possible
Multi-account	configure distinct account names and credentials

Runtime behavior

The channel keeps a long-lived event connection.
Incoming messages route to the selected Agent/session.
Task commands create Agent-owned Tasks.
Delivery returns through the Feishu/Lark bot API.

Troubleshooting

Symptom	Check
Bot receives nothing	Event subscription, app publish state, bot capability.
Send fails	App secret, app id, permissions, target id.
Group messages ignored	Group policy, mention requirement, chat allowlist.
Lark tenant fails	`domain: "lark"` and correct developer console.

Overview

Common setup

Team and enterprise

Self-hosted and protocol

Optional and legacy

Configuration and behavior

Feishu

Feishu

Setup from Agent > Channels

Quick setup

Permissions

Access model

Runtime behavior

Troubleshooting

​Feishu

​Setup from Agent > Channels

​Quick setup

​Permissions

​Access model

​Runtime behavior

​Troubleshooting

​Related

Feishu

Setup from Agent > Channels

Quick setup

Permissions

Access model

Runtime behavior

Troubleshooting

Related