feishu-bridge

Connect a Feishu (Lark) bot to Clawdbot 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.

1. Przejdź na open.feishu.cn/app, utwórz nową aplikację (Create self-built app) i dodaj możliwość Bot. Włącz uprawnienia im:message, im:message.group_at_msg oraz im:message.p2p_msg. W sekcji Events dodaj im.message.receive_v1 i ustaw dostarczanie na WebSocket long-connection. Opublikuj aplikację (utwórz wersję i poproś o zatwierdzenie). Zanotuj App ID i App Secret.

2. Przechowaj App Secret w bezpiecznym miejscu: utwórz katalog ~/.clawdbot/secrets, a następnie zapisz hasło w pliku feishu_app_secret z uprawnieniami 600.

3. Zainstaluj zależności i uruchom most: przejdź do katalogu feishu-bridge, wykonaj npm install, a następnie uruchom bridge.mjs z zmienną środowiskową FEISHU_APP_ID ustawioną na identyfikator aplikacji Feishu (np. cli_xxx).

4. Aby włączyć automatyczne uruchamianie na macOS, wykonaj setup-service.mjs z tą samą zmienną FEISHU_APP_ID, a następnie załaduj plik LaunchAgent za pomocą launchctl load.

5. Sprawdzaj status i logi: użyj launchctl list, aby potwierdzić, że usługa działa, i tail -f ~/.clawdbot/logs/feishu-bridge.err.log, aby monitorować błędy. Aby zatrzymać usługę, wykonaj launchctl unload.

6. Bot będzie odpowiadać w czatach grupowych tylko wtedy, gdy użytkownik go wspomni (@-mention). Każdy czat Feishu mapuje się na sesję Clawdbot z identyfikatorem feishu:u003cchatIdu003e.