feishu-bridge
Połącz bota Feishu z Clawdbot przez WebSocket bez publicznego serwera
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Feishu Bridge to narzędzie do integracji czatbota Feishu (Lark) z platformą Clawdbot. Łączy się przez lokalny WebSocket bez potrzeby publicznego serwera, domeny czy ngrok. Obsługuje tworzenie bota na Feishu Open Platform, konfigurację poświadczeń, uruchomienie mostu, automatyczne restartowanie na macOS oraz dostrajanie zachowania w czatach grupowych.
Jak używać
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.
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.
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).
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.
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.
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.