feishu-bridge
Connect a Feishu (Lark) bot to ThinkFleet via WebSocket long-connection. No public server, domain, or ngrok required. Use when setting up Feishu/Lark as a messaging channel, troubleshooting the Feishu bridge, or managing the bridge service (start/stop/logs). Covers bot creation on Feishu Open Platform, credential setup, bridge startup, macOS launchd auto-restart, and group chat behavior tuning.
Informações da origem
- Repositório
- ThinkfleetAI/thinkfleet-engine
- Última atividade na origem
- 10 de fevereiro de 2026 às 12:42
- Idioma detectado do SKILL.md
- inglês
- Estrelas
- 0
- Forks
- 0
Opções de instalação
Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.
Revise os arquivos de origem
Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.
Exibindo SKILL.md
SKILL.md
Instruções da origem · Visualização somente leitura- name
- feishu-bridge
- description
- Connect a Feishu (Lark) bot to ThinkFleet via WebSocket long-connection. No public server, domain, or ngrok required. Use when setting up Feishu/Lark as a messaging channel, troubleshooting the Feishu bridge, or managing the bridge service (start/stop/logs). Covers bot creation on Feishu Open Platform, credential setup, bridge startup, macOS launchd auto-restart, and group chat behavior tuning.
# Feishu Bridge
Bridge Feishu bot messages to ThinkFleet Gateway over local WebSocket.
## Architecture
```
Feishu user → Feishu cloud ←WS→ bridge.mjs (local) ←WS→ ThinkFleet Gateway → AI agent
```
- Feishu SDK connects outbound (no inbound port / public IP needed)
- Bridge authenticates to Gateway using the existing gateway token
- Each Feishu chat maps to a ThinkFleet session (`feishu:<chatId>`)
## Setup
### 1. Create Feishu bot
1. Go to [open.feishu.cn/app](https://open.feishu.cn/app) → Create self-built app → Add **Bot** capability
2. Enable permissions: `im:message`, `im:message.group_at_msg`, `im:message.p2p_msg`
3. Events: add `im.message.receive_v1`, set delivery to **WebSocket long-connection**
4. Publish the app (create version → request approval)
5. Note the **App ID** and **App Secret**
### 2. Store secret
```bash
mkdir -p ~/.thinkfleet/secrets
echo "YOUR_APP_SECRET" > ~/.thinkfleet/secrets/feishu_app_secret
chmod 600 ~/.thinkfleet/secrets/feishu_app_secret
```
### 3. Install & run
```bash
cd <skill-dir>/feishu-bridge
npm install
FEISHU_APP_ID=cli_xxx node bridge.mjs
```
### 4. Auto-start (macOS)
```bash
FEISHU_APP_ID=cli_xxx node setup-service.mjs
launchctl load ~/Library/LaunchAgents/com.thinkfleet.feishu-bridge.plist
```
## Diagnostics
```bash
# Check service
launchctl list | grep feishu
# Logs
tail -f ~/.thinkfleet/logs/feishu-bridge.err.log
# Stop
launchctl unload ~/Library/LaunchAgents/com.thinkfleet.feishu-bridge.plist
```
## Group chat behavior
Bridge replies only when: user @-mentions the bot, message ends with `?`/`？`, contains request verbs (帮/请/分析/总结…), or calls the bot by name. Customize the name list in `bridge.mjs` → `shouldRespondInGroup()`.
## Environment variables
| Variable | Required | Default |
|---|---|---|
| `FEISHU_APP_ID` | ✅ | — |
| `FEISHU_APP_SECRET_PATH` | — | `~/.thinkfleet/secrets/feishu_app_secret` |
| `THINKFLEET_CONFIG_PATH` | — | `~/.thinkfleet/thinkfleet.json` |
| `THINKFLEET_AGENT_ID` | — | `main` |
| `FEISHU_THINKING_THRESHOLD_MS` | — | `2500` |
Ver no GitHub