/feishu:setup

/feishu:setup

Guide the user through the complete Feishu channel setup process.

What this skill does

Walk the user through every step needed to get the Feishu bot connected to Claude Code:

1. Feishu Developer Console configuration
2. Credential storage
3. Bot permissions and event subscription
4. Launch command

Steps to follow

Step 1 — Check credential file

Look for ~/.claude/channels/feishu/.env. If it exists, show the current App ID (masked: show first 8 chars + ...). If it doesn't exist, tell the user you'll help them create it.

Step 2 — Feishu Developer Console checklist

Tell the user to complete these steps in https://open.feishu.cn/app:

机器人能力

• 进入应用 → 添加应用能力 → 机器人 → 开启

权限管理 (add all of these)

• im:message — 读取用户发给机器人的消息
• im:message:send_as_bot — 以机器人身份发送消息
• im:chat — 获取与发送单聊、群组消息

事件订阅

• 开启"使用长连接接收事件"（不需要服务器公网地址）
• 添加事件：im.message.receive_v1

版本发布

• 创建版本并发布应用（企业自建应用需管理员审批）

Step 3 — Save credentials

If the user provides App ID and App Secret, save them to ~/.claude/channels/feishu/.env:

FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Create the directory if it doesn't exist. Set file permissions to 600:

mkdir -p ~/.claude/channels/feishu
echo "FEISHU_APP_ID=..." > ~/.claude/channels/feishu/.env
echo "FEISHU_APP_SECRET=..." >> ~/.claude/channels/feishu/.env
chmod 600 ~/.claude/channels/feishu/.env

Step 4 — Install dependencies

cd ~/claude-channel-feishu && npm install

Step 5 — Launch

From the ~/claude-channel-feishu directory:

claude --dangerously-load-development-channels server:feishu

Then in Feishu, find the bot and send it a message. It will appear in Claude Code.

Notes

• The bot uses WebSocket long-connection — no public IP or ngrok needed.
• Credentials are read at startup; restart Claude Code after changing .env.
• In group chats, the bot only responds when @mentioned.