feishu

claude-channel-feishu

中文文档

Connect a Feishu (Lark) bot to your Claude Code session.

Inbound messages from the bot arrive in the Claude Code terminal as channel events; Claude replies through a reply tool. Tool-use permission prompts can also be relayed to Feishu so you approve them remotely from your phone.

This is a Claude Code channel — an MCP server with the claude/channel capability. Modeled after the official Telegram channel.

Prerequisites

• Node 18+ (the server runs on tsx).
• Feishu self-built app with:
  • Bot capability enabled.
  • Event subscription set to long connection (no public URL required), subscribed to im.message.receive_v1.
  • Callback subscription (a separate tab under Events and Callbacks) also set to long connection, subscribed to card.action.trigger — this is what powers the Allow/Deny buttons for permission prompts. Without it the cards show error 200340 when tapped.
  • (Optional, for group chat support) Also subscribe to im.chat.member.bot.added_v1 — required so the bot can DM admins an approval card when added to a new group.
  • Scopes: im:message, im:message:send_as_bot, im:chat:readonly.
  • A released version (changes in the developer console take effect only after publishing).

You'll also need the app's App ID (cli_...) and App Secret from the Feishu developer console.

Install

From inside any Claude Code session:

/plugin marketplace add https://github.com/doudiu4ever/claude-channel-feishu.git
/plugin install feishu@feishu-plugins

The plugin installs under ~/.claude/plugins/ and handles its own dependencies on first launch.

Launch

Exit your session, then relaunch with the channel flag:

claude --dangerously-load-development-channels plugin:feishu@feishu-plugins

--dangerously-load-development-channels is required during the channels research preview for any channel not on Anthropic's approved list.

Configure (first time only)

In the Claude Code session, just ask Claude to configure the bot. It will call the plugin's configure tool with your credentials:

"configure feishu, app id cli_xxx, app secret xxx"

The credentials are written to ~/.claude/channels/feishu/config.json (mode 0600). The Feishu WebSocket connects in the same process — no restart required. Subsequent sessions pick up the saved config automatically.

To override per-instance, export FEISHU_APP_ID / FEISHU_APP_SECRET in your shell — environment takes precedence over the config file.

Pair (first time per sender)

Access is gated by Feishu open_id. On first DM from an unauthorized user, the bot replies with a 6-character pairing code:

You are not authorized yet.
Pairing code: ABC123
In the Claude Code terminal, say: pair ABC123

In your Claude Code session, say:

"pair ABC123"

Or, if an admin is already paired, they'll receive an interactive card with Allow / Deny buttons — one tap on Allow and the new user is in.

Claude calls the pair tool, the bot DMs back "Paired.", and your open_id is appended to ~/.claude/channels/feishu/access.json. Codes expire after 10 minutes.

Using it

Once configured and paired:

• DM the bot → the message appears in your terminal as a <channel source="feishu" ...> event. Claude can respond by calling the reply tool.
• Permission relay — if Claude tries to run a tool that needs approval (e.g. Bash), the prompt is forwarded to allowlisted Feishu users as an interactive card with Allow / Deny buttons. Tap one and the verdict goes back to Claude without touching the terminal. Text fallback yes <id> / no <id> still works.

Group chat

The bot can also operate in group chats, with a dual gate for safety: a message is only processed when all three are true — the group is in allowGroups, the sender is in allowFrom, and the bot is @-mentioned. Any failure is silent (no pairing-code spam in groups).

Setup flow:

1. Add the bot to a Feishu group. The bot DMs every admin an Allow/Deny approval card with the group's chat_id.
2. Tap Allow → the chat_id is appended to ~/.claude/channels/feishu/access.json under allowGroups.
3. Group members who haven't paired yet must first DM the bot to go through the standard pairing flow — silent ignore in groups means there's no in-group prompt.
4. In the group, paired users @bot <message> to talk to Claude; the bot ignores any non-mention messages.

If you missed the approval card or want to authorize manually, ask Claude in the terminal: pair_group oc_xxxxxxx.

Requires the im.chat.member.bot.added_v1 event subscription (see Prerequisites).

Running multiple bots on one machine