Ön Koşullar
- Geliştirici erişimine sahip bir Feishu veya Lark hesabı
- Bir Claw örneği (buradan oluşturun)
Kurulum Kılavuzu
Bir Feishu Uygulaması Oluşturun
- Feishu Açık Platformu’na (veya Lark Developer’a) gidin
- Create Custom App butonuna tıklayın
- Bir uygulama adı ve açıklaması girin
- Create butonuna tıklayın
Bot Özelliği Ekleyin
- Uygulama ayarlarınızda, Features → Bot bölümüne gidin
- Bot özelliğini etkinleştirin
- Bu, uygulamanızın mesaj almasını ve göndermesini sağlar
Kimlik Bilgilerini Alın
- Credentials & Basic Info bölümüne gidin
- App ID değerini kopyalayın (
cli_ile başlar) - App Secret değerini kopyalayın
Olay Aboneliğini Yapılandırın
- Event Subscriptions bölümüne gidin
- WebSocket modunu seçin (önerilen — genel URL gerekmez)
- İstenirse, Encrypt Key ve Verification Token değerlerini ayarlayın
Olay İzinlerini Ekleyin
- Event Subscriptions altında, bu olayları ekleyin:
im.message.receive_v1— Mesajları al
- Permissions & Scopes bölümüne gidin ve şunları ekleyin:
im:message— Mesaj gönder ve alim:message.group_at_msg— Gruptaki @bahsetmeleri al
- Save butonuna tıklayın
Uygulamayı Yayınlayın
- App Release → Version Management bölümüne gidin
- Yeni bir sürüm oluşturun
- İnceleme için gönderin (dahili uygulamalar için bu genellikle anlıktır)
- Onaylandıktan sonra uygulama yayına girer
LemonData Panelinde Yapılandırın
- Claw Paneli’nize gidin
- Örneğinizdeki ayarlar simgesine tıklayın
- IM Integrations sekmesini açın
- Feishu bölümünü genişletin
- App ID ve App Secret bilgilerinizi yapıştırın
- Otomatik oluşturulan Encrypt Key ve Verification Token değerlerini tekrar Feishu geliştirici konsoluna kopyalayın
- Save butonuna tıklayın
Grup Ayarları
Panelinizin IM Integrations sekmesinden grup sohbeti davranışını yapılandırın:| Ayar | Seçenekler | Açıklama |
|---|---|---|
| Group Policy | Açık (varsayılan) / İzin Listesi / Devre Dışı | Botu gruplarda kimlerin tetikleyebileceğini kontrol eder |
| Require @mention | Açık / Kapalı | Bot yalnızca @bahsedildiğinde yanıt verir |
| Group IDs | Sohbet ID’leri listesi | Belirli gruplarla sınırla (boş = tüm gruplar) |
| Group Allowed Users | Open ID listesi | Sadece bu kullanıcılar botu tetikleyebilir (izin listesi modu) |
Sorun Giderme
Bot mesajları almıyor
Bot mesajları almıyor
- Uygulamanın yayınlandığını ve onaylandığını doğrulayın
im.message.receive_v1olayına abone olunduğundan emin olun- WebSocket modunun seçildiğinden emin olun (HTTP değil)
- Feishu konsolu ve Claw yapılandırması arasındaki Encrypt Key ve Verification Token değerlerinin eşleştiğini doğrulayın
'app_ticket' hatası
'app_ticket' hatası
- Bu genellikle App ID veya App Secret’ın yanlış olduğu anlamına gelir
- Panelinizdeki kimlik bilgilerini tekrar kontrol edin